1.1 SiteAgent是什么

SiteAgent 是什么

核心差异化

SiteAgent 的核心竞争力在于：一次对话同时创建前台 + CMS后台 + 数据，且合规原生内置。

平台定位

SiteAgent 面向不同类型的客户群体，提供差异化的产品能力和服务模式：

1.2 核心价值主张

五大核心价值

合规作为基因（Compliance by Design）

SiteAgent 将合规视为产品基因，而非事后补丁。这意味着从您创建网站的第一天起，所有必要的合规能力就已经内置在系统中，无需额外的开发改造或第三方工具集成。

数据合规：SiteAgent 在数据存储层面原生支持 GDPR（欧盟）、CCPA（美国加州）、PIPL（中国）等主流法规要求。用户数据的收集、存储、处理和删除都遵循最严格的标准，确保您的网站在全球范围内合法运营。

隐私合规：访客首次访问您的网站时，会看到符合法规要求的Cookie同意横幅。用户可以自主选择接受或拒绝非必要Cookie。同时，我们内置了完整的用户数据权利支持，包括数据访问、数据导出、数据删除（被遗忘权）等功能。

内容合规：CMS后台集成了敏感词过滤和图片审核功能，帮助运营人员在发布内容前识别潜在的合规风险，避免因不当内容导致的法律问题。

多语言全球化（Globalization Ready）

对于有国际化业务需求的企业，SiteAgent 提供完整的多语言支持能力，帮助您的品牌快速触达全球客户。

一键翻译：借助先进的AI翻译引擎，您可以将已有的中文内容一键翻译成英文或其他语言。翻译结果经过专业优化，确保语言自然流畅，适合商业场景使用。当然，您也可以在自动翻译的基础上进行人工微调。

语言切换：网站前台内置了语言切换组件，访客可以根据自己的偏好选择浏览语言。语言切换是即时的，无需页面刷新，提供流畅的用户体验。系统还会记住访客的语言偏好，下次访问时自动使用上次选择的语言。

本地化支持：除了语言翻译，SiteAgent 还支持更深层次的本地化需求，包括日期格式、货币单位、联系方式格式等。不同语言版本可以配置不同的联系信息，比如中国区使用微信，海外区使用WhatsApp。

1.3 客户痛点与解决方案

典型客户痛点

解决方案优势对比

1.4 与传统建站的差异

SiteAgent 围绕企业品牌建站的全生命周期，构建了五大核心能力模块。这些能力相互协作，为企业提供从建站到运营的一站式解决方案。

1.5 适用场景

SiteAgent 提供灵活的合作模式，满足不同类型合作伙伴的业务需求。无论您是技术服务商、代运营机构还是咨询公司，都可以找到适合自己的合作方式。

2.1 合作模式说明

SiteAgent 为ISV合作伙伴提供多种灵活的合作模式，满足不同业务场景的需求。

2.2 入驻流程

整个入驻流程通常需要5-10个工作日完成，我们的商务团队会全程协助您完成对接。

2.3 资质要求

• 具有合法经营资质的企业法人
• 具备一定的技术开发能力或运营服务能力
• 认同SiteAgent的产品理念和服务标准
• 具有良好的商业信誉和客户服务记录

2.4 账号与权限

ISV账号开通后，您将获得以下权限：

2.5 计费模式

SiteAgent提供灵活的计费方案，支持按用量、按站点数、按功能模块等多种计费方式，具体方案请联系商务团队获取报价。

3.1 环境准备

账号注册与凭证获取

第一步：注册账号

访问 SiteAgent 平台，点击任意模板即可进入登录/注册流程。系统支持ZITADEL身份认证，提供邮箱登录和新用户注册功能。

第二步：填写注册信息

点击"注册新用户"，填写姓名、邮箱，选择密码认证方式：

注册成功 - 返回模板库选择合适的建站模板

1. 填写名字和姓氏
2. 输入有效的电子邮箱
3. 选择"密码"作为认证方式（也支持密钥认证）
4. 设置符合要求的密码（至少8位，包含大小写字母、数字和符号）

第二步：获取API凭证

接口地址

3.2 第一个品牌站

场景描述

为企业创建一个包含首页、服务介绍、联系我们的品牌站。

建站流程

步骤1：选择模板

登录成功后进入模板库，浏览各类专业模板：

SiteAgent 模板库 - 覆盖多行业、多场景的专业模板

模板库提供分类筛选功能，可按"品牌"、"Landing"、"内容"、"基础模板"等类型快速找到适合的模板。选择一个模板后，点击"确认创建"即可开始建站。

步骤2：自然语言描述需求

在AI对话框中描述您的需求：

"我需要一个科技公司官网，包含以下内容：
1. 首页 - 展示公司核心价值和主要业务
2. 产品服务页 - 介绍我们的三个主要产品
3. 关于我们 - 公司简介、发展历程、团队介绍
4. 联系我们 - 联系方式、在线表单

设计风格：现代简约、科技感、蓝色系
支持中英文切换"

步骤3：AI生成三位一体站

选择模板后，系统会自动创建项目并进入AI建站工作区：

AI建站工作区 - 左侧对话、右侧实时预览

工作区布局说明：

• 左侧AI对话区：通过自然语言与AI交互，描述您的建站需求
• 右侧预览区：实时展示网站效果，支持响应式预览
• 顶部工具栏：提供Analytics数据分析和Publish发布功能

AI建站引擎会：

1. 理解您的业务意图
2. 选择最适合的模板和组件
3. 生成前台页面
4. 配置CMS后台
5. 初始化数据存储

整个过程可视化展示，您可以在右侧实时看到AI的生成效果。

步骤4：实时预览与调整

AI生成网站的过程是完全透明的，您可以实时看到生成效果并随时进行调整。

预览窗口会显示正在生成的页面，您无需等待全部完成就能看到效果。如果某个部分不符合预期，可以直接告诉AI"我希望Banner的颜色更深一些"或"产品介绍部分需要更突出特点"，AI会理解您的意图并立即调整。

我们还提供多端预览功能，一键切换PC、手机、平板三种视图，确保您的网站在各种设备上都能完美展示。响应式设计是自动的，但您也可以针对特定设备进行微调。

步骤5：一键发布

当您对预览效果满意后，点击"发布"按钮即可让网站正式上线。发布过程完全自动化，您无需关心任何技术细节。

系统会自动为您的网站分配一个预览域名（格式如 yoursite.siteagent.io），同时自动申请和配置SSL证书，确保网站从上线第一天起就是安全的HTTPS访问。整个发布过程通常在1-2分钟内完成，您可以实时查看发布进度和状态。

发布完成后，您就可以分享网站链接了。如果您有自己的域名，可以在后续步骤中进行绑定配置。

3.3 内容更新体验

CMS后台功能概览

修改首页Banner示例

1. 登录CMS后台
2. 进入「页面管理」→「首页」
3. 找到Banner区块，点击编辑
4. 修改标题、描述、图片
5. 点击「保存」
6. 点击「发布」使更改生效

3.4 预览与发布

预览模式

在发布前，您可以通过预览功能查看网站在不同设备上的呈现效果：

• 桌面预览：查看在PC浏览器中的显示效果
• 平板预览：查看在平板设备上的响应式布局
• 手机预览：查看在移动端的显示效果

发布流程

发布过程完全自动化，通常只需几秒钟即可完成部署。

3.5 常见问题速查

4.1 三位一体架构

核心理念：一次对话，三端齐备

SiteAgent 的核心创新在于：通过一次自然语言对话，同时生成完整的品牌网站系统。这与传统建站方式有本质区别——传统方式需要分别开发前端页面、后台管理系统、搭建数据库，每个环节都需要专业技术人员参与，项目周期往往以周甚至月计算。

SiteAgent 将这三个环节融为一体：

传统方式 vs SiteAgent

沙盒隔离

每个品牌站运行在独立的沙盒环境中：

• 安全隔离：不同品牌站数据完全隔离
• 资源独占：计算资源独立分配
• 即时预览：开发过程实时可见
• 灵活配置：支持自定义配置

4.4 前台页面组成

页面类型

前台特性

4.5 CMS后台功能

功能模块

4.6 实时预览与调整

数据架构

数据安全

• 用户隔离：不同用户数据完全隔离
• 加密存储：敏感数据加密保存
• 定期备份：自动备份，支持恢复
• 访问控制：基于角色的权限管理

数据合规

• 符合GDPR数据保护要求
• 支持用户数据导出
• 支持用户数据删除
• 数据保留策略可配置

4.3 模板系统

模板分类

模板特性

• 预配置开发环境：开箱即用
• AI建站指引：内置最佳实践
• 组件化设计：灵活组合
• 响应式支持：自动适配多端

模板定制

ISV可以：

• 基于现有模板二次开发
• 申请开发专属行业模板
• 自定义组件和样式

4.2 自然语言对话建站

平台实际界面 - AI与团队并肩协作的4步建站流程

流程详解

4.7 多语言支持

国际化架构

多语言内容管理

在CMS后台：

1. 编辑默认语言内容
2. 切换到目标语言
3. 编辑翻译内容（或使用AI翻译）
4. 保存并发布

AI辅助翻译

• 一键翻译整个页面
• 保持原意的智能翻译
• 人工审核和修正
• 术语库支持

5.1 内容管理

域名配置

步骤1：准备域名 - 确保您已拥有域名，并能管理DNS设置。

步骤2：添加域名 - 在CMS后台「设置」→「域名管理」中添加您的域名。

步骤3：DNS验证 - 按照系统提示，在您的域名DNS中添加验证记录：

步骤4：等待生效 - DNS记录生效后（通常几分钟到24小时），系统会自动验证并绑定域名。

SSL证书配置

SiteAgent 自动为您的域名配置SSL证书：

• 自动申请：域名验证通过后自动申请证书
• 自动续期：证书到期前自动续期
• 强制HTTPS：自动将HTTP重定向到HTTPS

5.2 SEO优化

登录CMS

1. 访问CMS后台地址
2. 使用账号密码登录
3. 进入内容管理界面

编辑页面

修改现有内容：

1. 进入「页面管理」
2. 选择要编辑的页面
3. 点击编辑按钮
4. 修改内容
5. 保存并发布

添加新页面：

1. 点击「新建页面」
2. 选择页面模板
3. 编辑页面内容
4. 设置SEO信息
5. 保存并发布

发布审核流程

5.3 数据分析

Meta标签设置

结构化数据

系统自动生成结构化数据（Schema.org）：

• Organization：公司信息
• WebPage：页面信息
• Article：文章信息
• BreadcrumbList：面包屑导航

站点地图

系统自动生成和更新sitemap：

• 自动包含所有已发布页面
• 实时更新
• 自动提交到搜索引擎

SEO检查工具

CMS后台提供SEO检查功能：

• 标题检查：长度、关键词
• 描述检查：长度、吸引力
• 图片检查：ALT标签
• 链接检查：内链、外链
• 加载速度：页面性能

5.4 表单与线索管理

访问统计

用户行为分析

• 热力图：用户点击热点
• 滚动深度：页面阅读深度
• 转化漏斗：关键路径转化率
• 用户路径：访问页面顺序

数据报告

• 日报/周报/月报：自动生成
• 自定义报告：按需配置
• 数据导出：Excel/CSV格式
• API获取：通过API获取原始数据

第三方分析集成

支持集成主流分析工具：

• 百度统计
• Google Analytics
• 其他自定义分析代码

7.1 一键部署优势

与传统建站的差异

核心优势

7.2 部署流程

流程概览

详细步骤

步骤1：完成建站 - 确保网站内容已完成：所有页面内容已填充、图片和媒体资源已上传、SEO信息已配置、多语言内容已翻译

步骤2：预览确认 - 在发布前进行全面预览：PC端预览、移动端预览、功能测试、链接检查、加载速度

步骤3：一键发布 - 点击「发布」按钮，系统自动：构建生产版本、配置运行环境、分配/绑定域名、配置SSL证书、部署到生产环境、健康检查

步骤4：上线成功 - 发布成功后：获取访问地址、查看部署状态、开始运营工作

7.3 域名配置

自定义域名

1. 进入「设置」→「域名管理」
2. 点击「添加域名」
3. 输入您的域名（如 www.example.com）
4. 按提示配置DNS记录

DNS配置

SSL证书

自动SSL：

• 自动申请：域名验证通过后自动申请
• 自动部署：证书申请成功后自动部署
• 自动续期：证书到期前自动续期
• 强制HTTPS：自动重定向HTTP到HTTPS

通配符域名

支持通配符域名配置（如 *.example.com）：

• 适用于多子站场景
• 需要通配符SSL证书

7.4 SSL证书

预览域名

每个品牌站自动分配预览域名：

• 格式：[app-id].preview.siteagent.com
• 用途：开发和测试阶段访问
• 说明：预览域名始终可用

环境隔离

多端预览

支持多种设备预览：

• 桌面端：1920px、1440px、1280px
• 平板端：768px
• 移动端：375px、414px

7.5 状态监控

部署状态

实时查看网站部署状态：

健康检查

平台自动监控网站健康状态：

• 可用性监控：7x24小时检测网站是否可访问
• SSL证书监控：证书到期前自动提醒和续期
• 域名监控：DNS配置异常自动告警
• 性能监控：页面加载时间监测

告警通知

支持多种告警通知方式：

• 邮件通知：发送到管理员邮箱
• 站内消息：控制台消息中心
• Webhook：集成到企业监控系统

6.1 原生合规的价值

合规即基因 vs 事后补丁

原生合规的商业价值

6.2 支持的全球法规

GDPR（欧盟通用数据保护条例）

适用范围：处理欧盟居民个人数据的组织

SiteAgent 支持：Cookie同意管理、数据主体权利（访问、删除、迁移）、隐私政策自动生成、数据处理记录、数据保护影响评估支持

CCPA（加州消费者隐私法案）

适用范围：处理加州居民个人数据的组织

SiteAgent 支持：隐私声明自动生成、"不要出售我的信息"链接、数据访问和删除请求处理、数据收集披露

PIPL（中国个人信息保护法）

适用范围：处理中国境内个人信息的组织

SiteAgent 支持：个人信息处理规则、同意管理、跨境传输合规、个人信息权利支持

规划中的法规支持

• LGPD（巴西数据保护法）
• POPIA（南非信息保护法）
• 其他地区性法规

6.3 三层合规架构

6.3.1 数据合规（Data Compliance）

数据存储位置合规：支持选择数据存储区域、满足数据本地化要求、跨境传输合规机制

数据主体权利：

6.3.2 隐私合规（Privacy Compliance）

Cookie同意管理：可配置Cookie同意弹窗、分类管理（必要/功能/分析/营销）、用户偏好记录、合规样式模板

隐私政策：自动生成隐私政策、多语言支持、定期更新提醒、自定义补充条款

用户偏好中心：用户可管理隐私设置、Cookie偏好调整、通信偏好设置、数据处理同意

6.3.3 内容合规（Content Compliance）

敏感词过滤：内置敏感词库、自定义敏感词、实时检测和提醒、多语言支持

图片审核：集成图片审核服务、自动检测违规内容、人工审核流程、审核日志记录

内容审计日志：所有内容操作记录、操作人员追溯、时间戳记录、可导出审计报告

6.4 合规检查与报告

一键合规检查

合规得分仪表盘

• 总体合规得分
• 各维度得分明细
• 改进建议
• 历史趋势

审计报告导出

• 合规状态报告
• 数据处理记录
• 同意记录
• 审计日志

9.1 API概述

7.1.1 数字人播报

价值：7x24小时企业形象代言

集成方式：作为扩展组件嵌入品牌站：首页欢迎位、固定悬浮窗、指定页面触发

7.1.2 AI智能问答

价值：替代人工客服，捕获客户线索

集成方式：基于AI建站引擎构建：对话窗口组件、浮动按钮触发、页面嵌入

9.2 内容管理API

7.2.1 内容管理API

使用场景：历史资产迁移、批量内容更新

接口示例：创建文章

POST /api/v1/articles

{
  "title": "文章标题",
  "content": "<p>文章正文内容</p>",
  "category": "新闻动态",
  "tags": ["产品", "发布"],
  "status": "published",
  "locale": "zh"
}

7.2.2 网站管理API

使用场景：批量创建客户网站、统一管理

接口示例：创建应用

POST /api/v1/apps

{
  "name": "客户品牌站",
  "templateId": "template-enterprise",
  "description": "某企业官网"
}

接口示例：发布应用

POST /api/v1/apps/{appId}/publish

接口示例：查询部署状态

GET /api/v1/deployments/{deploymentId}/status

// 响应
{
  "status": "deployed",  // provisioning | deploying | deployed | failed
  "url": "https://www.example.com",
  "deployedAt": "2025-12-01T10:05:00Z"
}

7.2.3 数据分析API

使用场景：运营数据报告、客户价值分析

9.3 认证与授权

SSO单点登录

支持企业级身份认证：

• OIDC协议支持
• SAML协议支持
• 与企业目录集成

API密钥管理

多租户隔离

• 每个客户数据完全隔离
• 独立的权限体系
• 审计日志分离

9.4 事件通知（Webhook）

Webhook配置

支持配置Webhook接收事件通知：

配置方式

1. 在ISV后台配置Webhook URL
2. 选择需要订阅的事件
3. 配置签名密钥
4. 测试连通性

事件消息格式

{
  "event": "app.published",
  "timestamp": "2025-12-01T10:00:00Z",
  "data": {
    "appId": "app-uuid",
    "url": "https://www.example.com"
  },
  "signature": "xxx"
}

9.5 SDK与示例代码

API文档

• 完整的接口说明
• 在线调试工具
• 示例代码

SDK支持

提供多语言SDK：

• JavaScript/TypeScript
• Python
• Java
• Go

技术支持

8.1 客户授权机制

账户委托

客户可授权代运营商管理其网站：

1. 客户登录后台
2. 进入「设置」→「团队管理」
3. 邀请代运营商账号
4. 设置权限级别

权限分级

操作审计

所有操作自动记录：

• 操作人员
• 操作时间
• 操作内容
• 变更详情

8.2 多租户管理

客户隔离

每个客户的数据完全独立：

• 独立的数据存储
• 独立的配置空间
• 独立的访问统计

统一后台

代运营商可在一个后台管理多个客户：

批量操作

支持的批量操作：

• 模板更新推送
• 配置同步
• 批量发布
• 批量数据导出

8.3 代运营工作流

标准流程

阶段详解

8.4 最佳实践

10.1 品牌站建设最佳实践

10.2 内容运营最佳实践

• 定期更新：保持至少每周一次的内容更新，让网站保持活力
• 多媒体结合：文字、图片、视频结合使用，提升用户体验
• 移动优先：优先考虑移动端的阅读体验
• 数据驱动：关注数据分析，根据用户行为调整内容策略

10.3 SEO优化最佳实践

10.4 合规实施最佳实践

• 建站时就启用合规模块，而非事后添加
• 根据目标市场选择适用的法规（GDPR/CCPA/PIPL）
• 定期检查并更新隐私政策
• 确保Cookie同意弹窗正确显示
• 保留用户同意记录作为合规证据

10.5 性能优化建议

• 压缩上传的图片，建议使用WebP格式
• 避免单页面内容过长，适当拆分页面
• 合理使用CDN加速资源加载
• 定期清理不再使用的媒体资源

11.1 建站相关

11.2 内容管理相关

11.3 部署相关

11.4 合规相关

11.5 API相关

A. 术语表

B. 错误码参考

通用错误码

业务错误码

C. FAQ

一般问题

Q：SiteAgent 支持哪些浏览器？

A：支持所有现代浏览器，包括 Chrome（推荐）、Firefox、Safari、Edge

Q：网站支持多少访问量？

A：根据套餐不同，支持不同级别的访问量。企业版支持高并发访问。

Q：数据如何备份？

A：系统自动进行数据备份，支持按需恢复。

技术问题

Q：API调用有频率限制吗？

A：是的，默认限制为每分钟60次请求。企业客户可申请提升。

Q：支持自定义开发吗？

A：支持。可以通过API集成自定义功能，或联系我们进行定制开发。

Q：如何处理大文件上传？

A：单文件限制50MB，大文件建议分片上传或使用专用上传接口。

合规问题

Q：数据存储在哪里？

A：数据存储在安全的云环境中，支持选择存储区域。

Q：如何满足GDPR要求？

A：平台内置GDPR合规功能，包括Cookie同意、数据权利等。详见第六篇。

Q：支持数据导出吗？

A：支持。可以导出所有用户数据，满足数据迁移需求。

D. 更新日志

v2.0 (2025年12月)

新增功能：

• 原生合规能力增强，支持PIPL
• 多语言全球化支持
• AI辅助翻译功能
• ISV API能力扩展

优化改进：

• 建站流程优化
• CMS后台体验提升
• 部署速度提升
• 文档结构优化

v1.0 (2025年6月)

• 首次发布
• 基础建站能力
• CMS后台
• 一键部署