Skip to content

创建智能体实例

智能体实例是由智能体模板创建的运行对象。PlaygroundAPI 调用、渠道绑定、Trace后台任务 都围绕智能体实例工作。

使用前提

创建智能体实例必须选择一个已经存在的智能体模板。如果还没有模板,先创建智能体模板,完成模型和提示词配置后再返回本页。

渠道用户通过 /init 动态创建专属实例时,平台会使用渠道账号已经绑定的智能体模板。因此,使用 /init 前也必须先为渠道账号绑定智能体模板。

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

决定是否需要新实例

为以下情况创建独立智能体实例:

  • 开发、预发布和生产需要隔离配置或 Token。
  • 不同客户需要独立会话、能力资源或渠道绑定。
  • 一个智能体模板需要同时运行多套实例参数。
  • 需要先验证智能体模板更新,再更新生产实例。

如果多个调用方可以共享配置、会话边界和能力资源,可以复用同一智能体实例。不要仅为了“有一个实例”而重复创建。

创建实例

从智能体模板创建实例时的实例信息和只读模板信息
  1. 打开创建智能体实例页面。

    也可以打开 智能体实例,再选择 创建实例

  2. 选择 智能体模板

  3. 输入 实例名称 和可选的 描述

  4. 填写智能体模板或能力模板开放的实例参数。

  5. 选择 创建实例

实例名称应包含用途或环境,例如:

  • 研发工单分诊-dev
  • 研发工单分诊-staging
  • 研发工单分诊-prod

平台没有单独的环境对象,这些名称只是团队约定。需要环境隔离时,应同时使用不同实例、Token、渠道账号和外部能力配置。

等待实例进入运行状态

实例列表主要显示:

  • 待启动:实例已经创建,但尚未准备好接受调用。
  • 运行中:实例已部署,可以进入 Playground 或被已开启的访问方式调用。

创建智能体实例后,请等待实例进入 运行中。通过能力模板关联的资源可能需要为该实例单独准备;直接关联的现有能力实例仍由引用它的智能体实例共享。请在对应能力页面核对实际资源。

参见了解创建智能体实例时生成的资源

检查实例可配置参数

只有智能体模板和能力模板中标记为可配置的参数才能由智能体实例覆盖。如果需要为实例设置不同的值:

  1. 返回智能体模板或能力模板。
  2. 把相应字段标记为实例创建时可配置。
  3. 保存后重新检查智能体实例。

不要把直接修改共享能力实例当作单个智能体实例的参数覆盖,这可能影响引用该能力实例的其他智能体模板和智能体实例。

继续验证和接入

实例运行后: