AI智能体平台-智能体模块操作手册 - 九宸智能

1. 手册说明

本手册用于指导客户在 九宸数字员工 平台中完成智能体模块的日常使用，包括：

1. 登录平台并进入智能体模块。
2. 创建和维护业务知识库。
3. 创建、配置、调试和发布智能体。
4. 通过内部对话、外链分享、API 发布等方式使用智能体。
5. 查看调用日志、用户反馈、效果评估和知识库治理结果。

智能体可以理解为企业的 AI 数字员工。一个可交付使用的智能体组成表格：

2. 登录与入口

2.1 访问地址

正式环境入口：https://agent.9czn.cn/9c/#/login
如客户使用私有化部署环境，请以实施人员提供的企业专属访问地址为准。

2.2 登录账号

1. 打开访问地址。
2. 输入企业管理员分配的账号、密码和租户信息。
3. 点击登录进入系统。

如忘记密码，请联系企业内部管理员重置；如账号无法登录，请联系九宸实施或售后人员排查租户、角色、菜单权限是否配置正确。

2.3 常用菜单

3. 推荐使用流程

首次交付或新建业务智能体时，建议按以下流程操作：

4. 知识库管理

知识库是智能体准确回答企业问题的基础。建议客户先整理知识库，再创建智能体。

4.1 新建知识库

操作路径：知识库管理
操作步骤：

1. 点击左侧“个人知识库”或“共享知识库”区域的新增按钮。
2. 填写知识库名称，例如“产品资料库”“售前 FAQ”“员工制度库”。
3. 填写描述，说明该知识库的使用场景和内容范围。
4. 选择 Embedding 模型。一般情况下使用实施人员配置好的默认模型即可。
5. 设置可见性：私有/共享
6. 设置状态为启用。
7. 点击保存。

知识库业务匹配表：

4.2 上传文档

操作步骤：

1. 在左侧选择目标知识库。
2. 点击“上传文件”。
3. 选择需要上传的文档。
4. 等待上传完成。
5. 在文档列表中查看“向量状态”。

向量状态说明表：

支持文件：TXT、Markdown、PDF、Word、PPT、Excel、CSV 等。

4.3 新建文件夹与整理文档

操作步骤：

1. 进入目标知识库。
2. 点击“新建文件夹”。
3. 输入文件夹名称，例如“产品资料”“报价政策”“客户案例”。
4. 勾选文档后，可批量移动到目标文件夹。
5. 可对文件夹进行重命名或删除。

注意：删除文件夹会影响其中的文档，请确认无误后再操作。

4.4 导入网页链接

操作步骤：

1. 进入目标知识库。
2. 点击链接导入入口。
3. 粘贴网页地址，多条链接可换行输入。
4. 提交后等待系统抓取网页正文并向量化。
5. 在文档列表中检查处理状态。

建议导入结构清晰、正文完整的网页。需要登录、动态加载或图片为主的网页，抓取效果可能不稳定。

4.5 预览文档与查看切片

操作步骤：

1. 在文档列表中点击“预览”，查看系统解析出的文本内容。

1. 当向量状态为“已完成”时，点击“切片”。
2. 查看每个切片的文本是否完整、语义是否清楚。
3. 如发现切片内容错误，可编辑切片并保存。
4. 编辑切片后，系统会重新向量化该切片。

高质量切片标准表：

4.6 知识库对话测试

操作步骤：

1. 选择目标知识库。
2. 在底部输入框输入问题。
3. 点击发送。
4. 查看系统回答是否符合文档内容。
5. 如需限定范围，可勾选指定文件或文件夹后再提问。

对话范围优先级：已勾选文件 > 已勾选文件夹 > 当前所在文件夹 > 整个知识库

回答不准确排查点：

1. 文档是否已完成向量化。
2. 问题相关内容是否确实存在于知识库。
3. 切片是否过长、过短或语义不完整。
4. 是否需要补充 FAQ 问答对。

5. 智能体管理

5.1 新建分类

操作路径：智能体列表
操作步骤：

1. 点击“新建分类”。
2. 输入分类名称，例如“销售智能体”“客服智能体”“内容创作智能体”。
3. 选择图标。
4. 设置排序。
5. 点击保存。

分类只用于管理智能体，不会影响智能体的对话能力。

5.2 从零创建智能体

操作步骤：

1. 进入“智能体列表”。
2. 点击新建智能体。
3. 按表单填写基础信息、模型配置、提示词和工具绑定。
4. 保存后，在列表中找到新建智能体。

基础信息字段说明表：

工作流类型对照表：

5.3 配置模型

模型配置字段表：

配置建议：

1. 对外客服类智能体优先选择稳定、成本可控的模型。
2. 销售分析、方案生成、复杂推理类智能体可选择能力更强的推理模型。
3. 如果回答经常过短，可适当提高最大 Token。
4. 如果回答太随意或编造内容，降低温度并强化系统提示词约束。

5.4 编写系统提示词

系统提示词四要素表格：

通用模板：

提示词编写建议：

1. 明确业务边界，不要让智能体“什么都回答”。
2. 对外场景必须写清楚“不能编造”“不知道就引导留资或转人工”。
3. 对内部制度类问题，要求给出制度来源或流程节点。
4. 创作类智能体应明确输出结构，例如标题、正文、脚本、CTA。
5. 使用全屏编辑适合维护较长提示词。

5.5 欢迎语与引导提问

欢迎语示例：
您好，我是九宸 AI 售前咨询助手，可以为您介绍产品功能、部署方式、报价模式和客户案例。您可以直接输入问题开始咨询。

引导提问示例：
你们支持私有化部署吗？
智能体平台适合哪些业务场景？
知识库可以上传哪些资料？
如何申请产品演示？

操作步骤：

1. 在智能体编辑页找到“欢迎语”。
2. 填写开场内容。
3. 打开“开启引导”。
4. 填写 3-5 个高频问题。
5. 保存后在对话页或分享页验证展示效果。

5.6 绑定知识库

操作步骤：

1. 在智能体编辑页找到“工具绑定”。
2. 在“知识库”中选择一个或多个知识库。
3. 保存智能体。
4. 到“对话测试”中提问知识库相关问题。

绑定建议：

1. 不要一次绑定过多无关知识库，否则可能降低检索准确率。
2. 对外客服建议绑定企业介绍、产品资料、FAQ、客户案例等知识库。
3. 内部助手建议绑定制度、流程、IT 文档等知识库。
4. 销售教练建议绑定销售话术、竞品分析、客户案例等知识库。

5.7 绑定内置系统工具

工具适配场景表：

操作步骤：

1. 在智能体编辑页进入“工具绑定”。
2. 在“内置系统工具”中选择需要的工具。
3. 保存后在对话测试中验证工具调用效果。

高风险工具建议由管理员配置工具权限规则，必要时开启审批。

5.8 绑定 MCP 服务器

操作步骤：

1. 确认管理员已在 MCP 管理中配置服务器。
2. 编辑智能体。
3. 在“MCP 服务器”中选择需要绑定的服务器。
4. 保存后进行对话测试。

调用失败排查点：

1. MCP 服务器是否启用。
2. 网络地址和鉴权信息是否正确。
3. 工具权限规则是否限制当前智能体调用。
4. 外部系统是否正常运行。

5.9 设置可见性与状态

智能体状态配置表：

操作建议：

1. 新建智能体先设为“仅自己可见”。
2. 调试通过后再改为“企业共享”。
3. 对外分享前必须完成知识库和提示词验收。
4. 已停用智能体不应继续对外提供链接或 API。

6. 模板广场与提示词模板

6.1 从模板广场导入智能体

操作步骤：

1. 进入“模板广场”。
2. 搜索或筛选模板。
3. 点击模板查看详情，确认系统提示词、模型参数和适用场景。
4. 点击导入。
5. 选择导入后的可见性。
6. 导入成功后，到智能体列表中继续编辑。

导入后检查项：

1. 智能体名称是否符合企业命名。
2. 系统提示词是否已替换为客户自己的公司、产品、话术。
3. 是否绑定正确知识库。
4. 是否使用当前企业可用模型。

6.2 维护提示词模板

操作步骤：

1. 进入“提示词模板”。
2. 点击新增模板。
3. 填写模板名称、分类、适用场景和模板内容。
4. 如模板中需要变量，可使用 {{变量名}} 形式。
5. 保存后，在智能体编辑页选择该模板。

通用变量示例：
{{公司名称}}、{{产品名称}}、{{服务对象}}、{{回答风格}}

7. 对话测试

7.1 内部对话测试

操作路径：对话测试
操作步骤：

1. 进入对话测试页面。
2. 选择要测试的智能体。
3. 输入问题并发送。
4. 观察回复内容、思考过程、工具调用状态和引用内容。
5. 进行多轮追问，验证上下文是否连贯。

测试用例分类表：

8. 分享与发布

8.1 企业内共享

操作步骤：

1. 进入智能体列表。
2. 找到目标智能体。
3. 点击智能体右侧更多设置-“企业共享”。

企业内共享仍受账号角色、菜单权限影响。如用户看不到智能体，请检查角色权限。

8.2 外链分享

操作步骤：

1. 进入智能体列表。
2. 找到目标智能体。
3. 点击分享设置。
4. 打开“开启外链”。
5. 选择验证方式。
6. 保存配置。
7. 复制分享链接发给使用者。

外链验证方式对照表：

分享页能力：免登录访问、流式对话、附件图片上传、点赞点踩、语音输入播放、移动端适配。

外链安全注意：

1. 对外分享前必须确认智能体不会泄露内部资料。
2. 对外智能体建议只绑定可公开知识库。
3. 密码分享应定期更换密码。
4. 手机号验证场景会在后台记录用户身份，便于统计和跟进。

8.3 发布 API

操作步骤：

1. 进入智能体列表。
2. 找到目标智能体。
3. 点击“发布 API”。
4. 如尚未发布，点击发布。
5. 获取 AppID、API Key、流式接口和普通接口地址。
6. 按需配置应用名称、启用状态、每分钟限流、每日额度、IP 白名单和域名白名单。
7. 保存配置。

API配置字段说明表：

API安全建议：

1. API Key 不要放在前端公开代码中。
2. 对生产系统必须配置限流。
3. 面向固定服务器调用时建议配置 IP 白名单。
4. API 调用异常时可在发布 API 面板查看调用记录。

9. AI 调用日志与统计

9.1 查看调用日志

操作路径：AI调用日志

日志字段说明表：

9.2 查看调用统计

操作路径：调用统计

统计维度：

1. 按时间统计调用量。
2. 按智能体统计使用量。
3. 按模型统计 Token 和成本。
4. 按用户统计使用情况。

统计数据用途：

1. 判断哪些智能体使用频率最高。
2. 评估模型成本。
3. 发现异常调用。
4. 规划知识库和智能体优化优先级。

11. 工具权限规则

适用管控场景：

1. 会修改外部系统数据的工具。
2. 会发送消息、发布内容、删除数据的工具。
3. 会调用高成本模型或外部付费服务的工具。
4. 涉及客户隐私、财务、合同、生产数据的工具。

工具权限规则对照表：

建议对外分享智能体默认关闭高风险工具，仅保留知识库问答和低风险查询能力。

12. 长期记忆

适用场景：

1. 记住用户常用输出格式。
2. 记住客户行业、岗位、偏好。
3. 记住销售跟进中的背景信息。
4. 记住长期项目中的固定约束。

使用注意：

1. 不应记录身份证号、银行卡、密码等敏感信息。
2. 对外场景如涉及个人信息，应遵循客户企业的数据合规要求。
3. 如记忆内容错误，应及时删除或修正。

13. 典型场景操作示例

1. 13.1 创建“销售话术教练”

操作流程：

1. 新建销售话术库和客户案例库。
2. 上传销冠经验、竞品对比、常见异议处理。

1. 新建智能体，名称为“CRM-聊天AI建议（销冠）”。
2. 温度设置为 0.6-0.9。

1. 系统提示词规定输出结构：客户心理诊断、应对策略、可直接复制的话术。
2. 绑定话术库和案例库。

1. 测试“客户嫌贵”“客户拖延”“客户对比竞品”等场景。
2. 根据销售反馈持续补充优秀话术。

14.常见问题

14.1 智能体回答不准确怎么办？

排查顺序：

1. 知识库中是否有正确资料。
2. 文档是否完成向量化。
3. 切片是否完整、清晰。
4. 智能体是否绑定了正确知识库。
5. 系统提示词是否要求“基于知识库回答”。
6. 模型温度是否过高。
7. 是否绑定了过多无关知识库。

14.2 上传文档后为什么不能马上问到？

上传后系统需要解析、切片和向量化。请等待文档状态变为“已完成”后再测试。如长时间未完成，可刷新页面或联系管理员查看后台任务。

14.3 为什么智能体说“不知道”？

常见原因：

1. 知识库没有对应内容。
2. 用户问法和资料表达差异较大。
3. 检索没有命中正确切片。
4. 提示词限制严格，模型不敢扩展回答。

解决方式：补充 FAQ、优化切片、增加相似问法。

14.4 如何减少编造内容？

优化方案：

1. 在提示词中明确“不允许编造”。
2. 降低温度。
3. 补充标准知识库。
4. 删除过期或冲突文档。
5. 对高风险场景增加“请以人工确认为准”的提示。

14.5 外部用户打不开分享链接怎么办？

检查清单：

1. 是否开启外链分享。
2. 分享链接是否完整。
3. 智能体是否启用。
4. 验证方式是否输入正确，例如密码或手机号验证码。
5. 网络或浏览器是否正常。
6. 如在微信内打不开附件选择，可换手机浏览器测试。

14.6 API 调用失败怎么办？

检查清单：

1. API Key 是否正确。
2. 智能体 API 是否启用。
3. 是否触发限流或每日额度。
4. IP 或域名是否在白名单中。
5. 请求参数是否符合接口要求。
6. 查看发布 API 面板中的调用记录和错误信息。

14.7 如何持续提升智能体效果？

周度优化流程：

1. 查看 AI 调用日志和点踩记录。
2. 汇总高频失败问题。
3. 补充 FAQ 或修正文档。
4. 调整系统提示词。
5. 重新进行对话测试。
6. 将典型问题加入评估集。
7. 每周查看评估看板趋势。

16. 客户协作分工建议

17. 附录：知识库资料整理建议

17.1 推荐资料格式

17.2 FAQ 表格建议字段

17.3 文档清洗规则

1. 删除目录、页眉、页脚、水印、乱码。
2. 把扫描件尽量转为可复制文本。
3. 表格内容尽量转成清晰文字说明。
4. 价格、政策、联系方式必须标明适用时间。
5. 不同版本内容不要混在同一段中。
6. 过期资料应归档或删除，避免与新资料冲突。

18. 附录：Prompt 快速模板

转换说明

1. 原文内所有原生Markdown表格全部保留；
2. 原文中块状说明、对照表、参数清单、检查清单、分工清单全部统一转换为标准Markdown表格；
3. 纯步骤文字、流程描述保留段落文字，仅结构化对比类内容转为表格；
4. 完整覆盖原文全部文字，无删减、无内容丢失。

|（注：部分内容可能由 AI 生成）

1. 附录：平台管理员相关操作说明
2. 调整租户初始化数据-智能体

1. 调整租户算力充值与共享模式