创建智能体实例
智能体实例是由智能体模板创建的运行对象。Playground、API 调用、渠道绑定、Trace 和 后台任务 都围绕智能体实例工作。
使用前提
创建智能体实例必须选择一个已经存在的智能体模板。如果还没有模板，先创建智能体模板，完成模型和提示词配置后再返回本页。
渠道用户通过 /init 动态创建专属实例时，平台会使用渠道账号已经绑定的智能体模板。因此，使用 /init 前也必须先为渠道账号绑定智能体模板。
按钮会在新标签页打开控制台。若先进入登录页，控制台目前不会在登录后自动返回目标页面；请登录后返回本文，再次选择按钮。
决定是否需要新实例
为以下情况创建独立智能体实例：
- 开发、预发布和生产需要隔离配置或 Token。
- 不同客户需要独立会话、能力资源或渠道绑定。
- 一个智能体模板需要同时运行多套实例参数。
- 需要先验证智能体模板更新，再更新生产实例。
如果多个调用方可以共享配置、会话边界和能力资源，可以复用同一智能体实例。不要仅为了“有一个实例”而重复创建。
创建实例
重要
创建前检查共享沙箱
如果所选智能体模板直接关联现有沙箱实例，请确认所有引用方使用相同文件、Skill 集合和执行状态。需要不同 Skill 集合或无法确认共享范围时，先返回智能体模板，把沙箱插件改为 沙箱 - 模板，再创建实例。
打开创建智能体实例页面。
也可以打开 智能体实例，再选择 创建实例。
选择 智能体模板。
输入 实例名称 和可选的 描述。
提示
如果这个实例将作为子代理
实例关联为子代理后，智能体开发服务平台（AgentWorks）会把实例名称和描述提供给主智能体。主智能体根据这些信息、当前请求和自身的系统提示词判断是否委托。
因此，名称应能区分实例承担的职责；描述应说明适合处理的任务、需要的输入、返回的结果以及不处理的情况。描述在创建实例时可以不填，但计划把实例用作子代理时，建议填写清楚。
主智能体不会自动读取该实例的模型、完整系统提示词或插件配置。不要在名称或描述中填写凭证、Token 或其他敏感信息。完整设计方法参见设计并关联子代理。
填写智能体模板或能力模板开放的实例参数。
选择 创建实例。
实例名称应包含用途或环境，例如：
研发工单分诊-dev研发工单分诊-staging研发工单分诊-prod
平台没有单独的环境对象，这些名称只是团队约定。需要环境隔离时，应同时使用不同实例、Token、渠道账号和外部能力配置。
开始使用智能体实例
创建智能体实例后，直接打开 Playground 并发起一次无副作用的测试调用。平台会按需启动新建实例；实例长时间未使用或被重启后，也会在再次使用时按需启动。
实例列表中的 待启动 和 运行中 表示实例当前是否已经启动。一次调用是否正在执行或已经完成，应以回复、Trace 或调用任务状态为准。
通过能力模板关联的资源可能需要为该实例单独准备；直接关联的现有能力实例仍由引用它的智能体实例共享。请在对应能力页面核对实际资源。
参见查看智能体实例状态并处理配置不同步和了解创建智能体实例时生成的资源。
检查实例可配置参数
只有智能体模板和能力模板中标记为可配置的参数才能由智能体实例覆盖。如果需要为实例设置不同的值：
- 返回智能体模板或能力模板。
- 把相应字段标记为实例创建时可配置。
- 保存后重新检查智能体实例。
不要把直接修改共享能力实例当作单个智能体实例的参数覆盖，这可能影响引用该能力实例的其他智能体模板和智能体实例。
继续验证和接入
完成测试调用后：