跳转到主要内容
开始创作
开发文档

模板覆盖到指定智能体

将指定模板的配置全量覆盖到目标智能体(实例)。覆盖范围包括 persona、dynamicPrompt、outputFilterRegex、LLM/ASR/TTS 配置、技能、快速回复、config 等模板可控字段,并将 templateId 关联到该模板。

将指定模板的配置全量覆盖到目标智能体(实例)。覆盖范围包括 persona、dynamicPrompt、outputFilterRegex、LLM/ASR/TTS 配置、技能、快速回复、config 等模板可控字段,并将 templateId 关联到该模板。

POST /openapi/v1/agents/apply-from-template

本接口为全量覆盖语义,不提供按字段选择性覆盖——若只需修改部分配置,请使用 agents/update。覆盖时会自动清空目标智能体的 chat_state(对话记忆、长期记忆、历史摘要等)。**若不清空记忆,旧对话上下文与新 persona/技能配置并存,极易导致 AI 上下文幻觉**(例如仍按旧人设回答、引用已移除的技能上下文)。覆盖范围含 outputFilterRegex 等 config 字段。保留目标智能体的 user_id、extra 等实例字段,不会被模板覆盖。与 copy-from-template(新建副本)和 sync-template(批量同步模板下所有子智能体)互补。

请求参数

参数

类型

请求示例

{
  "templateId": 10,
  "agentId": 42
}

响应示例

{
  "code": 0,
  "msg": "覆盖成功",
  "data": {
    "agentId": 42,
    "templateId": 10
  }
}