Skip to content

创建智能体模板

创建智能体模板时,先定义模型、提示词和必要行为,再决定是否添加能力、渠道参数或子智能体。保存后的智能体模板可以被多个智能体实例复用。

控制台首页的 创建智能体 是本流程的快捷入口。它创建可复用的智能体模板;完成配置后,再创建智能体实例以运行、测试或接入。

从最小配置开始

创建页面只要求完成以下核心配置:

按钮会在新标签页打开控制台。若先进入登录页,控制台目前不会在登录后自动返回目标页面;请登录后返回本文,再次选择按钮。

  1. 打开创建智能体模板页面。

    也可以打开 智能体模板,再选择 创建智能体模板。控制台首页的 创建智能体 也是同一流程的快捷入口。

  2. 填写 模板名称

  3. 选择 模型凭证模型

  4. 输入 系统提示词

  5. 选择 创建智能体模板

描述、上下文压缩工具审批、渠道和插件可以在需求明确后补充。先创建模型可用的最小版本,可以缩短第一次验证路径。

给智能体清晰命名

名称应说明业务职责,而不是底层技术。例如:

  • 合同条款问答
  • 研发工单分诊
  • 门店运营助手

不要把环境名放入智能体模板名称。开发、预发布和生产通常通过不同的智能体实例区分,例如 合同条款问答-staging合同条款问答-prod

决定哪些值由实例填写

部分系统提示词、压缩配置、渠道参数和能力模板参数可以标记为实例创建时可配置。只有确实因环境、客户或渠道而变化的值才开放:

  • 环境相关服务地址。
  • 客户或业务线标识。
  • 不同实例需要使用的知识库集合。
  • 渠道应用凭证或允许名单。

共用的模板级审批处理规则、基础系统指令和能力配置应保留在智能体模板或能力模板中,避免每次创建实例时重复填写。不可绕过的访问限制仍应由工具服务授权、最小权限凭证或沙箱策略提供。

继续创建智能体实例

智能体模板创建成功后,继续创建智能体实例,才能获得可调用的运行对象。随后可以使用 Playground、API 或渠道。

参见创建智能体实例

区分平台运行循环和外部编排

创建智能体模板时,你定义的是一体化智能体运行与协同平台(AgentWorks)单次运行中的模型行为、可用能力和授权边界,不是在平台中定义固定工作流。平台运行循环始终存在;外部编排只在业务需要跨多次调用固定控制流程时使用。

由平台托管单次运行

每次输入都会触发一次平台托管的运行。模型可以在一次运行中直接返回响应,也可以调用已添加的能力,并在收到中断响应后继续运行。

模型调用、能力调用、响应和中断之间的循环由平台处理。添加子代理后,模型还可以根据任务动态委托已有智能体实例,但这种委托不定义固定节点、分支、重试或终止条件。具体选择过程参见理解模型驱动的动态委托

仅在需要固定流程控制时使用外部编排

需要精确控制节点顺序、条件分支、并行、重试或终止条件时,请在外部系统中实现这些控制。AgentWorks 智能体实例只是外部流程可以调用的一个步骤。

外部系统负责保存流程状态、选择下一步、限制重试次数并判断何时结束;AgentWorks 负责执行每次智能体调用。将智能体实例用作外部流程节点时,通常使用 Invoke API。WebSocket 适合自有消息系统的双向长连接,但不能代替外部流程的状态管理。

现有方案依赖 LangGraph 图、CrewAI Crew/Flow 或自定义 Agent 框架代码时,请保留原有外部编排,并通过 Invoke API 调用所需智能体实例。需要向 AgentWorks 接入外部工具时,使用 MCP;需要由调用方业务系统执行工具时,使用用户工具包。平台工具包仅用于平台已经提供的现成工具。

完整的责任划分参见区分平台单次运行和可选的外部编排