13. 创建可复用智能体

完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容：本章面向需要把一类工作固定下来的成员和工作空间管理员。同一类任务会反复执行，或者需要固定模型、技能和应用时，创建一个智能体比每次在对话里重新交代更合适。读完本章，你可以从模板或空白起点创建智能体，设置身份、模型和行为准则，按最小范围配置能力，把智能体分享给同事或从工作空间里移除，并用带版本的提示词把常用任务说明交给智能体执行。

13.1 智能体列表

适用场景：查找、打开、筛选当前工作空间里的智能体，或批量分享、删除。

前提：已登录工作台并选中工作空间；当前账号在该工作空间具有查看权限。

操作步骤

1. 在工作台左侧栏选择「智能体」。
2. 用顶部搜索框「搜索智能体」按名称查找；用状态页签筛选，页签依次为「全部」「运行中」「启动中」「部署中」「恢复中」「重启中」「停止中」「删除中」「升级中」「已停止」「错误」「草稿」。
3. 在某一行选择「对话」直接进入该智能体的对话；选择齿轮图标进入智能体详情的「智能体」页签。
4. 勾选多行后，底部出现「分享选中」「删除选中」。

你会看到

• 列表以表格展示，列为「名称」「状态」「IM 工具」「创建时间」和操作列。
• 「名称」列显示头像、名称、描述（无描述时显示「暂无描述」）和来源标签：「官方模板」「工作空间共享」「私有智能体」或「自定义智能体」。
• 「状态」列显示智能体当前能否提供服务：「就绪」「准备中」「恢复中」「升级中」「删除中」「不可用」或「未知」。启动、停止、升级、删除等过渡中的智能体会自动刷新，不需要手动刷新页面。
• 「IM 工具」列显示已接入的第一个 IM 工具，多个时显示「+N」；未接入时显示「未接入 IM 工具」。

注意：「分享选中」只在所选智能体全部为「草稿」状态时可用；「删除选中」只对「运行中」「错误」「已停止」「草稿」状态可用。删除不可撤销，确认框显示「确定要移除选中的 N 个智能体吗？此操作不可撤销。」提交后列表中对应行转为「删除中」。

13.2 选择起点

适用场景：开始创建一个新的智能体。

前提：当前工作空间至少有一个对你可用的模型，即包含它的模型分组已分发给你或本工作空间（见第 7 章）。

操作步骤

1. 在「智能体」页右上角选择「添加智能体」，进入「添加智能体」向导。向导分三步：「选择起点」「身份与模型」「技能与应用」。
2. 在「选择起点」页，页面提示「你可以选择一个模板 / 或者从头开始构建你的智能体」。选择「空白智能体」，或选择一张模板卡片。
3. 选中后，右侧预览区显示模板的「你会在什么时候用它？」和「默认预装」内容；选择空白智能体时显示「从一个完全空白的智能体开始，稍后再按需添加技能与应用。」
4. 选择「下一步: 身份与模型」。

你会看到

• 第一次进入时，页面会用引导气泡提示「先选择人设」，可以选择「稍后」跳过。
• 可选模板来自管理员维护的角色模板（见第 13.11 节），不同工作空间看到的模板可能不同。

注意：模板只是起点，带来的是默认人设和预装能力。创建后仍需检查模型、能力和权限。

13.3 设置身份与模型

适用场景：为智能体命名、选择模型和回答风格。

操作步骤

1. 在「身份与模型」页设置「头像」：可以上传图片，也可以选择「自动生成」。图片支持 JPG、PNG、WebP、GIF，最大 2 MB。
2. 填写「智能体名称」（必填）。名称宜说明职责，例如「任务同步员」「代码审查助手」。选择模板时会预填「模板名-随机后缀」，可以改写。
3. 在「模型」中选择一个模型。若管理员设置了全局默认的对话模型，且该模型对你可用，页面会预先选中并标注「（全局默认）」。用量计入哪个模型分组由平台按分组顺序决定，这里不选择分组。
4. 填写「描述」，选择「风格」：「专业」「友好」「简洁」「随意」「创意」「专家」之一。
5. 选择「下一步: 技能与应用」。

你会看到

• 右侧预览卡片随填写同步更新。
• 没有可用模型时，选择框显示「暂无可用的模型，请联系管理员分发」，且无法进入下一步，点击时提示「请先正确配置并选择一个可用的模型，才能进入下一步。」

注意：不要把密码、API 密钥或个人隐私写进名称和描述。智能体详细的工作指令在创建后的「行为准则」中编写（见第 13.6 节）。

13.4 配置技能与应用

适用场景：在创建时决定智能体预装哪些技能、连接哪些应用。

操作步骤

1. 在「配置预装技能与应用」页，「配置技能」页签列出当前工作空间已安装的技能，「连接应用」页签列出当前工作空间可用的应用（MCP 服务、知识库、数据连接等）。
2. 用开关启用或关闭每一项。从模板创建时，条目按「核心能力」（默认预装，建议保持开启）、「可选增强」（按需开启，创建后自动绑定）、「更多能力」分组。
3. 「连接应用」页签按「已配置」（已有授权凭据，可直接连接）和「未配置」（缺少授权凭据，连接后需补充配置）分组。
4. 标有「插槽」的一组条目中只能启用一项，页面提示「同一插槽内仅可启用其中一项。」
5. 确认后选择「添加智能体」。

你会看到

• 工作空间没有可选项时，分别显示「当前工作空间尚未安装任何技能」「当前工作空间尚未配置任何应用连接器」。
• 创建成功后页面直接进入该智能体详情的「智能体」页签。若部分技能或应用未能绑定，页面提示「智能体已创建，但部分技能/应用绑定失败，可在详情页手动调整」。

注意：只打开任务确实需要的项目。技能与应用的细节配置、凭据和状态排查在创建后完成，见第 14 章。

13.5 创建后的部署与详情页

适用场景：确认新智能体已经可以使用，并熟悉详情页的结构。

操作步骤

1. 创建后，若运行环境需要准备，详情页显示部署进度；准备完成后进入正常视图。
2. 在详情页顶部查看智能体名称和状态，右上角提供「对话」「分享」和「操作」菜单。
3. 用页签切换内容：「智能体」「应用」「技能」「定时任务」「运行历史」「文件夹」「终端」「记忆」「用量统计」「操作审计」。

你会看到

• 「智能体」页签左侧为资料卡：头像、名称、描述、「回应风格」、来源模板作者、「对话统计」（「陪伴天数」「近期消息」「完成任务」）和 IM 工具区；右侧为「行为准则」「模型」和「最近活动」。
• 运行时出现问题时，页面顶部显示状态横幅和处理建议，例如「重试」「更换模型」。

注意：智能体能否被使用，取决于智能体状态正常、模型可用、使用者有对应权限，以及最新配置已经应用到运行中的智能体。页签的用途分别在第 14、15、16 章说明。

13.6 编辑资料与行为准则

适用场景：修改智能体对外显示的信息，或编写它的工作指令。

操作步骤

1. 内容使用 Markdown 编写。建议写清职责、输入、输出格式和禁止事项。

你会看到

• 保存后的提示说明生效时机：「已保存，并已应用到运行中的智能体」「已保存（将在下次启动或重启时应用）」或「已保存，但同步失败 — 下次重启时生效」。
• 部分文件在某些运行状态下只可查看，页面会显示「此文件由智能体管理，仅供查看。」或「该文件在当前运行状态下不可用。」

注意：不要把固定密码、API 密钥或连接串写进行为准则。没有编辑权限的成员只能查看。

13.7 更换模型

适用场景：智能体需要改用另一个模型，或原模型已不可用。

操作步骤

1. 在「智能体」页签右侧的「模型」区域选择「更换模型」。
2. 在列表中选择新的模型并确认。
3. 原模型不可用时，区域内会显示推荐替代项，例如「已保存的模型不可用。推荐替代：某模型。」，确认后选择「切换」。

你会看到

• 区域显示当前选择的模型。
• 切换前提示「切换模型后，后续运行会使用新的模型。」

注意：没有修改权限的成员会看到「请联系智能体编辑者或管理员来切换」。若没有任何可用的替代模型，页面显示「已保存的模型不可用，当前没有可用的替代模型。」，需要管理员把模型加入已分发的模型分组（见第 7 章）。

13.8 试运行

适用场景：在扩大共享范围前确认智能体行为符合预期。

操作步骤

1. 在详情页右上角选择「对话」，进入该智能体的对话页。
2. 发送一条代表性任务，检查答复格式、引用来源和工具调用。
3. 再发送一条信息不全或越界的请求，确认智能体会提问、拒绝或提示缺少信息。
4. 根据结果调整行为准则或能力，再次验证。

你会看到

• 对话中的工具调用会按当前的「访问权限」请求确认（见第 14.6 节）。
• 「运行历史」页签记录本次运行的事件，「用量统计」页签显示模型调用和 Token 用量。

13.9 分享与可见范围

适用场景：让同事看到并使用你的智能体，或交给对方一份副本。

前提：你对该智能体具有「管理分享」能力（创建者默认具有）。

操作步骤

1. 在详情页右上角选择「分享」，打开「分享智能体」。
2. 在「可见范围」中选择「私有」或「工作空间」。私有会从工作空间列表隐藏；选择工作空间时，成员只能看到卡片，敏感访问仍需要单独的用户授权。
3. 在「用户授权」中搜索工作空间成员，勾选要授予的能力后选择「保存授权」。可选能力为：「查看卡片」「聊天」「查看历史对话」「查看计划」「管理计划」「查看运行」「查看记忆」「管理记忆」「查看文件」「管理文件」「管理分享」。默认勾选「查看卡片」和「聊天」，勾选某项时其依赖项会自动勾选。
4. 在「当前有效授权」中可以「撤销」已有授权。
5. 需要交给对方一份独立副本时，在「认领链接」中设置是否「允许多人认领」和「过期时间」（24 小时、72 小时、7 天或 30 天后过期），生成后选择「复制链接」。接收者打开链接后认领一份此智能体的副本。

你会看到

• 修改可见范围后提示「可见范围已更新」；保存授权后提示「授权已更新」。
• 页面提示「修改可见范围不会撤销已生成的分享链接」，链接需单独失效。

注意：认领得到的是副本，之后双方各自修改互不影响。把智能体发布给外部系统调用（A2A）也在这个对话框中完成，见第 17 章。

13.10 启动、停用、迁移与删除

适用场景：暂停一个智能体、把它移到另一个工作空间，或永久删除。

操作步骤

1. 在详情页右上角打开「操作」菜单。
2. 选择「启动」或「停用」切换运行状态。
3. 选择「迁移到其他工作空间」，在「目标工作空间」中选择你有编辑权限的工作空间并确认「迁移」。智能体需处于「草稿」或「已停止」状态才能迁移。
4. 选择「删除」，确认「确定要删除『名称』吗？此操作不可撤销。」

你会看到

• 迁移前的「迁移前须知」提示：知识库与工作空间级凭据不会随之迁移，需要在目标工作空间重新关联和授权；首次启动时出网白名单、共享文件挂载路径以及技能和 MCP 策略切换为目标工作空间的配置。
• 迁移完成后，若有解除的关联，提示会列出解除的知识库、凭据、共享文件和凭据授权数量。
• 删除时页面显示「正在删除智能体…」，清理完成后自动关闭详情页。

注意：「强制重启（运维）」只对具备运维权限的账号显示，普通成员无需使用。

13.11 管理员维护角色模板

适用场景：管理员为成员准备创建向导中的模板，或调整模板在不同工作空间的可见性。

前提：具备管理后台访问权限。

操作步骤

1. 进入「管理后台 › 智能体 › 角色模板」。列表列为「名称」「分类」「状态」「可见范围」等，可用「搜索模板…」查找；「可见范围」区分「内置」「平台」「工作空间」。
2. 打开一个模板，在「基本信息」中编辑「名称」「简短描述」「描述」「图标」「分类」（必选）和「推广文案」，设置「精选」与「精选排序」（精选模板置顶到创建页的精选区域）。
3. 在「人设」页签查看或编辑「角色设定」和「工作方式」。
4. 在「能力」页签为模板绑定技能与 MCP 服务，每项可标为「必备」或「可选」，并可设置插槽与槽位默认项。
5. 用发布开关发布模板（发布后才能分发给成员），再在「启用与分发」中选择「显示模板」或「隐藏模板」，作用于部门、成员、职能组或工作空间。
6. 内置模板不能直接改动时，选择「复制」生成一份副本再编辑；不再需要的模板可以删除。

你会看到

• 模板的「必备」「可选」能力，对应创建向导中的「核心能力」「可选增强」分组。
• 对工作空间设置的显示或隐藏是资源面策略：在该工作空间创建智能体时显示或隐藏此模板，不按使用者个人解析。

注意：修改模板不会改变已经创建的智能体。

13.12 维护提示词并发送给智能体

适用场景：把反复使用的任务说明保存为提示词，像代码一样保留版本、标记生产版本，需要时一键交给智能体执行；或者复用平台预置的标准提示词。

入口：顶部导航「智能体」› 左侧导航「提示词」。

前提：已选择工作空间。在这里创建的是工作空间提示词，只在当前工作空间内使用，不能被流量规则引用。

13.12.1 查看提示词列表

列表列出名称、分类、来源（平台 / 租户 / 工作空间）、版本（如「生产 v3 · 最新 v5」）与最近更新。可在「搜索提示词…」中按名称搜索，用筛选按来源、分类、分组过滤；筛选后没有结果时，点「清除筛选」恢复。点击一行进入详情。

13.12.2 新建提示词

操作步骤

1. 在列表右上角点「新建提示词」。对话框说明：「创建工作空间提示词。首个版本会标记为「正式」与「最新」。」
2. 填写「名称」（必填）、「分组」（可选，用来给自己的提示词归类）和「内容」（必填）。
3. 在内容中用 {{name}} 形式写变量，例如 {{customer_name}}；变量名可以带点分段，例如 {{order.id}}。
4. 按需填写「提交说明」，记录这一版写了什么，保存。

你会看到：页面提示「提示词已创建。」。详情页「概览」显示正文，正文下方的「变量」区域列出识别到的变量，必填变量带「必填」标记。

注意：详情页只识别 {{name}} 写法的变量，请统一使用这种占位格式。

13.12.3 管理版本

操作步骤

1. 需要修改时，在详情页右上角点「新建版本」。对话框说明「追加新版本。版本号不会回退。」，内容默认带入当前选中版本，修改后填写「提交说明」；需要立即生效时勾选「同时标为生产版本」。
2. 打开「版本」页签，列表按版本号列出各版本、「生产」「最新」标签和提交说明；点击某个版本，回到「概览」查看该版本内容。
3. 在「概览」的「对比」中选择另一个版本，查看「之前」「之后」的差异；内容相同时显示「无差异」。
4. 确认某个版本可用后，在「概览」点「标为生产版本」，在确认对话框中点「确认」。
5. 需要回到某个历史版本时，选中该版本，点「以此内容创建新版本」并确认「创建」。

你会看到

• 标记成功后提示「生产标签已更新。」。确认对话框说明：同一时间只能有一个生产版本。
• 回滚成功后提示「已创建 vN，内容来自 vM。」，提交说明自动填为「回滚：从 vM 创建新版本」。系统创建的是一个新版本，不会把历史版本原地改回最新。
• 「指标」页签按版本列出调用次数、费用与平均延迟 (ms)；尚无调用时显示「该提示词尚无用量指标。」。

注意：版本号只增不减。不再需要的工作空间提示词可在详情页右上角「删除」，删除不可撤销。

13.12.4 派生平台预置提示词

来源为「平台」的预置提示词不能新建版本、不能标记生产版本，也不能删除。需要在其基础上修改时，在详情页右上角点「派生」，系统在当前工作空间复制一份，提示「已派生到当前工作空间。」并打开副本，之后按 13.12.3 维护副本的版本。

13.12.5 把提示词发送给智能体

操作步骤

1. 在提示词详情中选好要使用的版本（默认是当前在「概览」中显示的版本），点右上角「发送给智能体」。
2. 在「选择智能体」中选择当前工作空间的智能体。
3. 提示词含变量时，逐个填写变量值；带「必填」标记的变量必须填写。
4. 点「发送」。

你会看到：页面打开与所选智能体的新对话，提示词已按变量值渲染并填入输入框，确认无误后发送。

注意

• 当前工作空间没有可用智能体时，对话框显示「当前工作空间没有可用智能体」与「先准备一个智能体，再回来发送此提示词。」，先按本章前面各节创建智能体。
• 漏填必填变量时提示「请填写必填变量：…」，补齐后再发送。

能力说明

---

上一章：12. 文档、表格与报告 · 下一章：14. 智能体、工具与审批