创建智能体模板
创建智能体模板时，先定义模型、提示词和必要行为，再决定是否添加能力、渠道参数或子智能体。保存后的智能体模板可以被多个智能体实例复用。
控制台首页的 创建智能体 是本流程的快捷入口。它创建可复用的智能体模板；完成配置后，再创建智能体实例以运行、测试或接入。
从最小配置开始
创建页面只要求完成以下核心配置。新建智能体模板时，文件系统功能默认开启；Todo、上下文压缩和工具权限默认不启用。若本次只验证模型，请在创建前关闭 启用文件系统，使最小配置不暴露文件工具。
打开创建智能体模板页面。
也可以打开 智能体模板，再选择 创建智能体模板。控制台首页的 创建智能体 也是同一流程的快捷入口。
填写 模板名称。
选择 模型凭证 和 模型。
输入 系统提示词。
按用途检查默认能力：
- 只验证模型时，关闭 启用文件系统。
- 需要使用 Skill 时，必须开启 启用文件系统，并保留
read_file。只需读取 Skill 和参考文件时，建议选择 仅只读；还需关联技能组。 - 需要让模型读取或整理当前任务的文件时，保留 启用文件系统；只允许读取时，选择 仅只读，并核对保留的
ls、read_file、glob和grep。 - 需要模型列出并更新当前任务的步骤时，开启 启用待办列表。例如，模型可以把“搜索资料、比较结果、撰写简报”列成三步并逐项更新。如果开始新会话后仍要保留进度，或需要系统自动继续执行后续步骤，请使用组织已有的工单或工作流系统。
- 没有工具权限规则且默认处理为 未指定 时，不会产生人工审批中断。
选择 创建智能体模板。
清空 工具选择会使用默认工具集；需要完全停用文件工具时，应关闭 启用文件系统。需要编辑已有文件时，可开启 写前必须读，让写入和编辑前先读取当前版本。
按任务补充交互能力
只启用当前任务需要的选项，保存后在测试实例中检查实际效果：
- 启用用户提问：让智能体通过问题表单收集缺失信息。在网页版对话中，用户可以填写文本、单选或多选答案，再提交或跳过。
- 启用联网搜索：需要事先准备 Tavily API Key。填写密钥和单次搜索最大结果数后，用公开、非敏感问题验证搜索和网页读取结果；输入会发送到外部搜索服务，企业内部资料不应直接作为搜索词。
- 注入当前时间：需要智能体参考时间时开启。时间信息不能代替业务系统提供的权威截止时间、时区或调度规则；创建和编辑时都应检查开关状态。
描述、上下文压缩、工具权限、Todo、渠道和插件可以在需求明确后补充。先创建模型可用的最小版本，可以缩短第一次验证路径。
注意
使用已有模板时，请检查文件系统开关；未配置文件系统的模板按关闭处理。未关联沙箱时，智能体文件工具按会话读写文件，新会话看不到上一会话创建的文件。关联沙箱后，这些工具改为使用所关联沙箱的工作区：沙箱模板为每个智能体实例创建沙箱，现有沙箱实例则由关联它的智能体共享。需要跨会话长期保存业务文件时，请写入已批准的外部存储。参见选择文件系统功能、沙箱和对象存储。
给智能体清晰命名
名称应说明业务职责，而不是底层技术。例如：
合同条款问答研发工单分诊门店运营助手
不要把环境名放入智能体模板名称。开发、预发布和生产通常通过不同的智能体实例区分，例如 合同条款问答-staging 和 合同条款问答-prod。
决定哪些值由实例填写
部分系统提示词、渠道参数和能力模板参数可以标记为实例创建时可配置。只有确实因环境、客户或渠道而变化的值才开放：
- 环境相关服务地址。
- 客户或业务线标识。
- 不同实例需要使用的知识库集合。
- 渠道应用凭证或允许名单。
共用的智能体级工具权限规则、基础系统指令和能力配置应保留在智能体模板或能力模板中，避免每次创建实例时重复填写。不可绕过的访问限制仍应由工具服务授权、最小权限凭证或沙箱策略提供。
继续创建智能体实例
智能体模板创建成功后，继续创建智能体实例，才能获得可调用的运行对象。随后可以使用 网页版对话、API 或渠道。
参见创建智能体实例。
区分平台运行循环和外部编排
创建智能体模板时，你定义的是智能体开发服务平台（AgentWorks）单次运行中的模型行为、可用能力和授权边界，不是在平台中定义固定工作流。平台运行循环始终存在；外部编排只在业务需要跨多次调用固定控制流程时使用。
由平台托管单次运行
每次输入都会触发一次平台托管的运行。模型可以在一次运行中直接返回响应，也可以调用已添加的能力，并在收到中断响应后继续运行。
模型调用、能力调用、响应和中断之间的循环由平台处理。添加子代理后，模型还可以根据任务动态委托已有智能体实例，但这种委托不定义固定节点、分支、重试或终止条件。具体选择过程参见理解模型驱动的动态委托。
在业务流程中调用智能体
例如，工单系统收到问题后，把描述发给智能体，请它判断问题类别。工单系统记下工单处理到哪一步；收到符合要求的分类后，再分派工单。
图中的接入代码属于工单系统：它通过 HTTP SendMessage 发送问题，通过 WebSocket 接收回复和运行状态。如果智能体需要审批或业务工具结果，工单系统先停在当前步骤，处理后通过 HTTP RespondInterrupt 回传结果。
收到智能体这次处理成功的事件后，还要检查分类是否符合工单系统的要求。两项都确认后才能分派。需要审批或工具结果时，先处理并回传，继续等待。运行失败或取消时，记录原因，不分派工单。回复无法判断类别时，交人工确认。具体做法见确认结果后再执行下一步。
如果业务需要固定的处理顺序、条件分支、并行任务或重试规则，就由你的应用或现有工作流系统记录进度、决定下一步。HTTP 和 WebSocket 用于发送请求、接收事件，不负责保存工单走到哪一步。
现有方案依赖 LangGraph 图、CrewAI Crew/Flow 或自定义 Agent 框架代码时，请保留原有外部编排，并通过 API 调用所需智能体实例。需要向 AgentWorks 接入外部工具时，使用 MCP；需要由调用方业务系统执行工具时，使用用户工具包。平台工具包仅用于平台已经提供的现成工具。
完整的责任划分参见区分平台单次运行和可选的外部编排。