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