1. 产品概述
1.1 纷享 Agent 架构
纷享 Agent 基于“规划—执行—判断”的 Agent Loop 架构，支持在云端安全沙箱（Sandbox）中自主运行任务，帮助企业一线销售、管理人员及运营人员通过自然语言完成复杂的 CRM 业务操作。
1.2 什么是 Agent Studio
Agent Studio 是纷享销客 Agent 的 管理后台，用于让企业管理员以可视化、低代码的方式配置、管理和发布企业内的智能体（Agent）。
1.3 谁需要使用 Agent Studio
| 角色 | 关注点 | 在 Agent Studio 中的典型操作 |
|---|---|---|
| 企业管理员 | 企业级 AI 治理、权限、合规 | 多版本发布、开启/关闭 Agent、维护企业技能库 |
| 业务负责人 | Agent 是否能解决实际业务问题 | 配置 Agent 设定（Prompt）、绑定技能与知识库 |
| 业务配置人员 | Agent 在自己业务线的能力 | 创建自定义 Skill、调整Agent设定 |
| 运维人员 | 稳定性、排障、审计 | 查看事件日志、查询工具调用链 |
2. Agent 设计器整体布局
进入路径：管理后台 → AI 平台管理 → Agent Studio → Agent
Agent 设计器采用 三栏 + 顶栏 的标准 SaaS 后台布局：
2.1 顶栏：多版本管理
顶栏元素说明
| 元素 | 说明 |
|---|---|
| Agent 名称 | 当前正在编辑的 Agent，点击可返回 Agent 列表 |
| Version 选择器 | 展示当前编辑的版本号（如 V1.0），可下拉切换版本。使用中版本代表在用户端正在生效的版本 |
| 使用此版本 | 非使用中版本显示此按钮，点击后当前版本切换为使用中版本 |
| 复制新建 | 基于当前版本内容复制为一个新版本。使用场景：创建新版本调试Agent，调试完成后切换为使用中，发布给用户使用 |
| 删除 | 删除非使用中的Agent版本 |
| 退出 | 退出 Agent 设计器 |
2.2 侧边栏菜单总览
| 菜单 | 用途 |
|---|---|
| 基本信息 | 配置 Agent 的基础信息、Agent 设定（系统提示词）、模型与欢迎语 |
| 技能 | 从企业技能库中挑选要挂载到本 Agent 的 Skill，让 Agent 能够发现并使用对应技能处理业务请求 |
| 知识库 | 为 Agent 绑定企业知识库，让 Agent 在回答时能检索企业内部文档 |
| 上下文 | 管理自动注入到 Agent 上下文的变量（系统变量、渠道变量、自定义变量） |
| 事件日志 | 查看该 Agent 历次 Query 的运行记录与工具调用详情 |
2.3 调试预览区
| 功能 | 说明 |
|---|---|
| 实时对话 | 输入问题即可看到当前草稿版本 Agent 的回复、Agent Loop 过程中的思考内容和工具链的调用信息 |
| 切换版本 | 顶栏切换版本后，调试区立即生效 |
| 上下文Mock | 支持Mock上下文内容进行会话测试 |
3. Agent 基本信息
3.1 页面分区
| 分区 | 字段 | 说明 |
|---|---|---|
| 详细信息 | 名称、API Name、Agent 设定、描述、适用范围、类型、头像 | Agent 的"身份信息" |
| 模型信息 | 模型厂商、模型选择 | Agent 的"大脑配置" |
| 欢迎语 | 欢迎语标题、欢迎语、快捷问题 | 用户首次进入 Agent 的引导语 |
3.2 字段详细说明
3.2.1 详细信息
| 字段 | 是否必填 | 说明 |
|---|---|---|
| 名称 | ✅ | Agent 的展示名，对用户可见 |
| API Name | ✅ | Agent 的唯一标识，系统调用时使用 |
| Agent 设定 | ✅ | Agent 的"系统提示词"，决定其人格、边界、风格 |
| 描述 | 可选 | 内部对 Agent 的说明，便于管理员理解用途 |
| 类型 | ✅ | Agent 的类型，决定Agent的使用场景 |
| 适用范围 | ✅ | 可以使用该Agent的企业员工 |
| 头像 | 可选 | 区分不同 Agent 的视觉标识 |
3.2.2 模型信息
| 字段 | 说明 | 常见取值 |
|---|---|---|
| 模型厂商 | 提供底层 LLM 的厂商 | 火山引擎 / 智谱 / 阿里 / DeepSeek |
| 模型选择 | 具体模型版本 | deepseek-v4-pro、kimi-k2.6 等 |
3.2.3 欢迎语
| 字段 | 说明 |
|---|---|
| 欢迎语标题 | 用户首次进入 Agent 时显示的醒目语 |
| 欢迎语 | 欢迎语正文，用于引导用户开始对话 |
| 快捷问题 | 预置几个推荐提问，覆盖用户在此Agent中最普遍的业务场景 |
💡 建议：欢迎语应包含 "Agent 能做什么 + 一句话示例提问"，降低用户首次使用门槛。
3.3 Agent 设定（核心字段）
Agent 设定是 Agent 最重要的配置项，使用 Markdown 编辑器 编写，本质上对应 Agent 的"主指令文件"，Agent 在启动时会把该文件内容加载到上下文中。
它决定的事情
| 模块 | 内容 | 为什么重要 |
|---|---|---|
| 身份定位 | 这个 Agent 是什么角色 | 决定它的名字、性格、说话风格 |
| 能力定位 | 这个 Agent 会做什么，解决什么问题 | 决定它的专业领域 |
| 职责边界 | 能做什么 / 不能做什么 | 防止越权 |
| 工具偏好 | 优先用哪些 skill/工具 | 统一执行风格 |
| 安全规则 | 不可触碰的红线 | 兜底保护 |
Agent 设定是 Agent 的"宪法"。这个文件写得越清晰，Agent 的行为就越可控
4. 技能（Skill）
4.1 什么是 Skill
Skill（技能） 是 可被 Agent 调用的业务能力封装单元。它把"如何做一件事"沉淀为一段可被模型识别和调用的资源，本质上是企业业务 Know-how 的模块化积累。
4.1.1 Skill结构
Skill 在文件系统中以目录形式存在
skillname/
├── SKILL.md ← 核心入口（AI 必读）
├── References/ ← 按需加载的文档资料
│ └── files
├── Assets/ ← 输出时用到的模板、字体等
│ └── files
└── Scripts/ ← 可执行代码（处理确定性任务）
└── Codes
4.1.2 Skill 解决了什么问题
| 问题 | Skill如何解决 |
|---|---|
| 知识零散、无法复用。每次任务都要重新"教" Agent 工具用法 | 把工具调用模式封装成可引用的 skill 模块，一次定义，按需加载 |
| 多步骤任务易出错 | skill 内置执行步骤 + 前后置条件，Agent 按图索骥，减少幻觉 |
| 能力难以组合扩展，新任务要改 prompt，牵一发动全身 | skill 像乐高积木——独立组合，新任务按需拼装不影响其他 skill |
| context 臃肿、token 开销高，所有指令一次性塞入 prompt，大量内容当前步骤用不到 | 渐进式披露——按当前执行阶段动态加载对应 skill，无关 skill 不进 context，显著压缩 token 用量 |
4.2 在 Agent 中添加技能
点击从「从技能库添加」按钮，从企业的技能库中选择技能添加到Agent
4.3 创建技能
需要在Agent 技能库统一管理Skill，进入路径：管理后台 → AI 平台管理 → Agent Studio → Agent 技能库
技能有两种创建方式：AI 创建和导入。
4.3.1 AI 创建技能
点击「AI创建Skill」按钮，唤起AI聊天框，使用自然语言描述业务功能
创建技能时，AI 将会结合业务场景，使用系统的 Built-in 工具和 ShareCRM CLI 中的业务方法，自动完成技能的创建并上传到企业的技能库中。
4.3.2 导入技能
导入技能的zip包完成创建，此方式适合把外部平台下载的skill快速迁移到纷享平台中。
注：上传的Skill中的SKILL.md文件中的YAML frontmatter部分必须包含 name 和 description 信息，具体请参考 Claude Skill 规范：https://code.claude.com/docs/zh-CN/skills
4.4 编辑技能
在 Skill 的编辑页面，可以使用编辑模式在线编辑md类型的文档，并支持导入（导入更新）和导出Skill。
Skill 的每次保存都会自动保存一个新版本，用于版本追溯和回退。
同时也可以继续在管理后台通过「AI创建Skill」唤起AI聊天框，使用自然语言让AI帮助你修改Skill。
5. Agent 工具
ShareAgent 通过 工具（Tool） 与外部世界交互。工具是 Agent 框架（Harness）调用的基本单元，每个工具都有明确的名称、描述、参数和返回值。当用户提出请求时，Agent 会：
- 判断需要完成什么任务。
- 从可用工具中选择最合适的工具。
- 根据用户输入填充参数。
- 调用工具并观察返回结果。
- 如需多步操作，则循环执行直到任务完成。
工具分为两大类：
- Built-in 工具：平台统一提供的基础能力，如文件操作、搜索、渲染、记忆管理等。
- 操作库工具（sharecrm CLI）：与纷享 CRM 业务对象、租户自定义接口、第三方 API 对接的工具集合。
5.1 Built-in 工具清单
ShareAgent 开箱即用的工具按功能分类如下：
| 类别 | 工具 | 用途 |
|---|---|---|
| CRM 业务 | sharecrm |
统一业务 CLI，查询/创建/更新 CRM 数据（客户、商机、合同等） |
| 技能管理 | read_skill |
加载技能定义 |
prepare_skill_improvement |
准备修改已有技能 | |
copy_as_personal_draft |
复制技能为个人草稿 | |
save_skill |
保存/发布技能 | |
| 定时任务 | schedule-def-create |
创建定时任务 |
schedule-def-update |
更新定时任务 | |
schedule-def-enable |
启用/停用定时任务 | |
schedule-def-delete |
删除定时任务 | |
schedule-def-list |
查询定时任务列表 | |
| 流程推进 | stage-move-to |
推进流程阶段 |
| 文件操作 | read_file / write_file / edit_file |
文件读写编辑 |
list_files |
列出目录文件 | |
file_download / file_upload |
文件服务上传下载 | |
file_parse |
解析 PDF/PPT/PPTX | |
| 内容渲染 | render_content |
实时渲染结果到前端 |
| 搜索 | web_search / web_fetch |
互联网搜索与抓取 |
knowledge_search |
企业知识库检索 | |
| 图像 | image_recognition |
图片识别分析 |
| 子智能体 | Agent |
调用子智能体（如金牌销售、客户情报等） |
| 记忆 | memory / memory_query / memory_create / memory_update / memory_delete |
长期记忆管理 |
| Shell | shell |
执行 Shell 命令 |
| 交互 | AskUserQuestion |
向用户提问收集信息 |
| 任务管理 | write_todos |
多步骤任务跟踪 |
5.2 Agent 操作库
5.2.1 sharecrm CLI
所有 sharecrm 命令，并不是平台“逐条硬编码”的，而是由纷享销客管理后台中的 Agent 操作库（路径：管理后台 > AI 平台管理 > Agent Studio > Agent 操作库）统一收口管理。
Agent 操作库的核心价值，就是把企业里零散、四散的能力 统一映射为 sharecrm CLI，让 Agent 通过同一套协议发现、调用、补全参数——企业不需要为每条业务动作单独开发适配。
5.2.2 新建/编辑操作
在操作库点击新建，选择操作的类型后，在配置页面填写操作的相关信息
新建/编辑操作时，弹出 操作设置 面板，分为 操作信息、分类与 CLI、输入输出参数 三段。
操作信息
| 字段 | 说明 |
|---|---|
| 操作类型 | 操作的类型，决定该操作能够绑定的元数据类型 |
| 选择元数据 | 操作绑定的元数据（函数、流、提示词、知识库范围等等） |
| 名称 | 操作的展示名称 |
| API Name | 操作的唯一标识符 |
| 指令 | 指令为操作添加语义信息，需要说明操作的作用以及何时执行该操作 |
| 是否显示执行状态文本 | 运行过程中是否向用户展示状态反馈（如"正在检索知识库…"） |
| 执行状态文本 | 状态文本的具体内容，需配合上一项开启后使用 |
分类与 CLI
| 字段 | 说明 |
|---|---|
| 一级分类 | 操作所属的业务大类，如「知识与检索」「CRM与销售」 |
| 二级分类 | 一级分类下的子类，如「知识」「对象操作」 |
| Method | CLI的方法名（如 helpcenterRetrieval），是 ShareAgent 执行该操作的实际接口标识 |
⚠️ CLI 命名规范：清晰并具有业务语义的 CLI 分类和Method名称，能够帮助Agent在运行时快速地找到对应的CLI方法并正确地调用它。
输入输出参数
| 字段 | 说明 |
|---|---|
| 字段选择 | 操作的参数名称，配置界面会根据绑定的元数据自动带出所有参数 |
| 数据类型 | 参数的数据类型，根据参数自动带出 |
| 必填 | 勾选后表示该参数为必传项，Agent 调用时必须提供值 |
| 指令 | 对该参数的自然语言补充说明（如"用户查询的相关内容"），帮助 Agent 正确理解该字段应传什么 |
6. 知识库管理
6.1 为什么需要知识库
Agent 自身的 LLM 不可能"知道"企业的产品手册、报价单、合同模板等。知识库 是把企业私域知识"喂"给 Agent 的标准方式。
6.2 支持的知识来源
| 来源 | 适用场景 |
|---|---|
| 企业已有知识库 | 选择企业知识库空间 |
| 本地文件上传 | 产品手册、话术、PDF 合同、FAQ |
7. 上下文管理
上下文 是 Agent 在执行任务时 自动感知到的环境信息，上下文变量通过 KV（Key-Value）方式注入到 Agent 的 System Prompt 中。
| 分类 | 说明 | 典型字段 |
|---|---|---|
| 系统变量 | 系统自动注入的运行时信息 | 当前时间、当前日期、SessionId、群聊历史、群聊消息、企业账号 |
| 渠道变量 | 不同入口带入的渠道信息 | 企信的群聊信息、当前页面的对象数据信息 |
| 自定义变量 | 管理员配置的业务变量 | 自定义员工信息、自定义查询条件 |
8. 事件日志
事件日志是 Agent 排障、调优、审计的核心入口。ShareAgent 把 每一次用户 Query 作为一次完整的事件进行记录，包含：
- 用户输入
- 模型思考过程
- 工具调用链（输入参数、输出结果）
- 最终回答
- 会话开始时间
- 耗时与 Token 消耗
需要在Agent基本信息中开启事件日志后才会记录
9. 发现
所有的纷享企业内部Agent，都可以作为智能体（subAgent）被ShareAgent（main Agent）发现并调用。
而「描述」字段是对整个Agent定位的概述，通常用一两句话，回答"这个Agent是做什么的"——这是 main Agent第一眼判断"要不要找它"的依据，它本质上是服务于Agent发现这个目的。
