指导用户完成知识库建设、智能体创建配置、调试发布、分享与 API 接入，以及日志、反馈、评估和治理等操作。

1. 手册说明本手册用于指导客户在九宸数字员工平台中完成智能体模块的日常使用，包括：登录平台并进入智能体模块。创建和维护业务知识库。创建、配置、调试和发布智能体。通过内部对话、外链分享、API 发布等方式使用智能体。查看调用日志、用户反馈、效果评估和知识库治理结果。智能体可以理解为企业的 AI 数字员工。一个可交付使用的智能体组成表格：组成部分作用模型决定智能体的语言理解、推理和生成能力系统提示词定义智能体的角色、边界、工作流程和输出风格知识库提供企业内部资料、产品信息、制度文件、问答话术等事实依据工具让智能体具备联网搜索、网页读取、图片生成、外部系统调用等能力分享与权限控制谁可以使用智能体，以及是否允许外部访问日志与评估记录使用情况，用于持续优化回答质量 2. 登录与入口 2.1 访问地址正式环境入口： https://agent.9czn.cn/9c/#/login 如客户使用私有化部署环境，请以实施人员提供的企业专属访问地址为准。 2.2 登录账号打开访问地址。输入企业管理员分配的账号、密码和租户信息。点击登录进入系统。如忘记密码，请联系企业内部管理员重置；如账号无法登录，请联系九宸实施或售后人员排查租户、角色、菜单权限是否配置正确。 2.3 常用菜单菜单菜单用途智能体管理智能体列表创建、编辑、分类、分享、发布智能体智能体管理对话测试选择智能体进行内部调试和日常对话智能体管理模板广场从预设模板导入智能体智能体管理提示词模板维护常用 Prompt 模板智能体管理 AI调用日志查看每次 AI 调用的请求、回复、耗时、Token 消耗和反馈智能体管理调用统计查看智能体、模型、时间维度的调用统计智能体管理长期记忆管理智能体沉淀的用户偏好和长期上下文智能体管理评估看板配置评测集，定期评估智能体回答效果知识库管理知识库管理新建知识库、上传文档、管理切片、知识库对话基础平台工具权限规则管理高风险工具的使用权限和审批规则 3. 推荐使用流程首次交付或新建业务智能体时，建议按以下流程操作： 4. 知识库管理知识库是智能体准确回答企业问题的基础。建议客户先整理知识库，再创建智能体。 4.1 新建知识库操作路径：知识库管理操作步骤：点击左侧“个人知识库”或“共享知识库”区域的新增按钮。填写知识库名称，例如“产品资料库”“售前 FAQ”“员工制度库”。填写描述，说明该知识库的使用场景和内容范围。选择 Embedding 模型。一般情况下使用实施人员配置好的默认模型即可。设置可见性：私有/共享设置状态为启用。点击保存。知识库业务匹配表：知识库适用智能体企业介绍与资质库官网客服、售前咨询助手产品说明与报价库销售助手、售前顾问高频问答库客服助手、内部咨询助手销售话术库销售陪练、销售教练员工制度库行政助手、IT 助手 4.2 上传文档操作步骤：在左侧选择目标知识库。点击“上传文件”。选择需要上传的文档。等待上传完成。在文档列表中查看“向量状态”。向量状态说明表：状态含义处理建议上传中文件正在上传等待完成待处理文件已上传，等待后台解析稍后刷新处理中系统正在解析并生成向量等待完成已完成文档可用于检索和问答可进入测试失败文档解析或向量化失败点击重学习或联系管理员支持文件：TXT、Markdown、PDF、Word、PPT、Excel、CSV 等。 4.3 新建文件夹与整理文档操作步骤：进入目标知识库。点击“新建文件夹”。输入文件夹名称，例如“产品资料”“报价政策”“客户案例”。勾选文档后，可批量移动到目标文件夹。可对文件夹进行重命名或删除。注意：删除文件夹会影响其中的文档，请确认无误后再操作。 4.4 导入网页链接操作步骤：进入目标知识库。点击链接导入入口。粘贴网页地址，多条链接可换行输入。提交后等待系统抓取网页正文并向量化。在文档列表中检查处理状态。建议导入结构清晰、正文完整的网页。需要登录、动态加载或图片为主的网页，抓取效果可能不稳定。 4.5 预览文档与查看切片操作步骤：在文档列表中点击“预览”，查看系统解析出的文本内容。当向量状态为“已完成”时，点击“切片”。查看每个切片的文本是否完整、语义是否清楚。如发现切片内容错误，可编辑切片并保存。编辑切片后，系统会重新向量化该切片。高质量切片标准表：标准说明语义完整单个切片能独立表达一个问题、政策或产品说明指代明确避免“该产品”“上述内容”等离开上下文后不清楚的表达事实准确价格、联系方式、版本差异等信息必须最新不含杂质尽量去掉页眉、页脚、目录、乱码和无意义表格 4.6 知识库对话测试操作步骤：选择目标知识库。在底部输入框输入问题。点击发送。查看系统回答是否符合文档内容。如需限定范围，可勾选指定文件或文件夹后再提问。对话范围优先级：已勾选文件 > 已勾选文件夹 > 当前所在文件夹 > 整个知识库回答不准确排查点：文档是否已完成向量化。问题相关内容是否确实存在于知识库。切片是否过长、过短或语义不完整。是否需要补充 FAQ 问答对。 5. 智能体管理 5.1 新建分类操作路径：智能体列表操作步骤：点击“新建分类”。输入分类名称，例如“销售智能体”“客服智能体”“内容创作智能体”。选择图标。设置排序。点击保存。分类只用于管理智能体，不会影响智能体的对话能力。 5.2 从零创建智能体操作步骤：进入“智能体列表”。点击新建智能体。按表单填写基础信息、模型配置、提示词和工具绑定。保存后，在列表中找到新建智能体。基础信息字段说明表：字段说明建议智能体名称对内或对外展示的名称简洁明确，如“售前咨询助手” 所属分类便于后台管理按业务部门或应用场景分类智能体图标展示头像选择与业务角色匹配的图标背景颜色头像或卡片背景色保持企业视觉统一工作流类型决定执行方式一般选择 ReAct 描述功能介绍写清楚服务对象和能力边界工作流类型对照表：类型适用场景 ReAct 推荐默认选项，适合需要知识库、工具调用、多轮推理的智能体顺序执行适合固定步骤输出，不需要自主调用工具的场景 Langflow 引擎适合已在工作流编排中搭建独立流程的场景多智能体协调适合需要多个子智能体协同完成复杂任务的场景 5.3 配置模型模型配置字段表：字段说明建议 LLM 供应商模型服务提供方使用管理员已配置好的供应商模型名称具体模型优先选择已验证模型温度控制回答发散程度客服/制度类建议 0.2-0.5，创作类可 0.7-1.2 最大 Token 控制最长输出常规问答建议 4096-8192，长文生成可更高深度思考模型先推理再回答复杂分析可开启，简单客服可关闭以提高速度配置建议：对外客服类智能体优先选择稳定、成本可控的模型。销售分析、方案生成、复杂推理类智能体可选择能力更强的推理模型。如果回答经常过短，可适当提高最大 Token。如果回答太随意或编造内容，降低温度并强化系统提示词约束。 5.4 编写系统提示词系统提示词四要素表格：结构内容角色你是谁，服务对象是谁目标你要帮助用户完成什么任务规则不能做什么，不知道时怎么回答风格回答口吻、格式和长度要求通用模板： Markdown # 角色你是【公司名称】的【岗位名称】，服务对象是【客户/员工/销售/运营人员】。 # 目标你的目标是基于知识库资料，帮助用户解决【具体业务问题】。 # 规则 1. 必须优先依据已绑定知识库回答。 2. 如果知识库中没有相关内容，必须明确说明暂未掌握，不允许编造。 3. 不回答与业务无关、违法违规或涉及敏感信息的问题。 4. 涉及价格、合同、法律、医疗、财务等高风险内容时，应提醒用户以正式文件或人工确认为准。 # 工作流程 1. 先识别用户意图。 2. 再检索相关知识库资料。 3. 最后用清晰、简洁、可执行的方式回答。 # 输出风格 1. 使用中文回答。 2. 回答尽量分点展示。 3. 对外客户场景保持专业、友好；内部办公场景保持简洁、高效。提示词编写建议：明确业务边界，不要让智能体“什么都回答”。对外场景必须写清楚“不能编造”“不知道就引导留资或转人工”。对内部制度类问题，要求给出制度来源或流程节点。创作类智能体应明确输出结构，例如标题、正文、脚本、CTA。使用全屏编辑适合维护较长提示词。 5.5 欢迎语与引导提问欢迎语示例：您好，我是九宸 AI 售前咨询助手，可以为您介绍产品功能、部署方式、报价模式和客户案例。您可以直接输入问题开始咨询。引导提问示例：你们支持私有化部署吗？智能体平台适合哪些业务场景？知识库可以上传哪些资料？如何申请产品演示？操作步骤：在智能体编辑页找到“欢迎语”。填写开场内容。打开“开启引导”。填写 3-5 个高频问题。保存后在对话页或分享页验证展示效果。 5.6 绑定知识库操作步骤：在智能体编辑页找到“工具绑定”。在“知识库”中选择一个或多个知识库。保存智能体。到“对话测试”中提问知识库相关问题。绑定建议：不要一次绑定过多无关知识库，否则可能降低检索准确率。对外客服建议绑定企业介绍、产品资料、FAQ、客户案例等知识库。内部助手建议绑定制度、流程、IT 文档等知识库。销售教练建议绑定销售话术、竞品分析、客户案例等知识库。 5.7 绑定内置系统工具工具适配场景表：工具类型适用场景注意事项网页搜索查询公开互联网信息对外回答需提示信息来源和时效网页正文抓取读取指定网页内容需要网页可公开访问图片生成生成营销图、插画、创意图对品牌和合规要求较高的图需人工审核 Python 执行数据计算、简单分析高风险操作需管理员控制权限 MCP 工具调用外部系统能力需先配置 MCP 服务器操作步骤：在智能体编辑页进入“工具绑定”。在“内置系统工具”中选择需要的工具。保存后在对话测试中验证工具调用效果。高风险工具建议由管理员配置工具权限规则，必要时开启审批。 5.8 绑定 MCP 服务器操作步骤：确认管理员已在 MCP 管理中配置服务器。编辑智能体。在“MCP 服务器”中选择需要绑定的服务器。保存后进行对话测试。调用失败排查点： MCP 服务器是否启用。网络地址和鉴权信息是否正确。工具权限规则是否限制当前智能体调用。外部系统是否正常运行。 5.9 设置可见性与状态智能体状态配置表：配置说明仅自己可见只有创建人或授权人员可见企业共享企业内有权限账号可见启用可以正常使用停用暂停使用，不建议对外开放操作建议：新建智能体先设为“仅自己可见”。调试通过后再改为“企业共享”。对外分享前必须完成知识库和提示词验收。已停用智能体不应继续对外提供链接或 API。 6. 模板广场与提示词模板 6.1 从模板广场导入智能体操作步骤：进入“模板广场”。搜索或筛选模板。点击模板查看详情，确认系统提示词、模型参数和适用场景。点击导入。选择导入后的可见性。导入成功后，到智能体列表中继续编辑。导入后检查项：智能体名称是否符合企业命名。系统提示词是否已替换为客户自己的公司、产品、话术。是否绑定正确知识库。是否使用当前企业可用模型。 6.2 维护提示词模板操作步骤：进入“提示词模板”。点击新增模板。填写模板名称、分类、适用场景和模板内容。如模板中需要变量，可使用 {{变量名}} 形式。保存后，在智能体编辑页选择该模板。通用变量示例： {{公司名称}}、{{产品名称}}、{{服务对象}}、{{回答风格}} 7. 对话测试 7.1 内部对话测试操作路径：对话测试操作步骤：进

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