用途:当用户希望智能体记住、学习、保存或记忆某个事实,或报告“智能体说了 X 但应该说 Y”这类一次性纠正时使用。资料明确指出:Web Architect 有 create_memory_entry 动作可创建智能体全局的临时事实,但 ConvAI REST API 没有记忆端点,应如实告知用户,而不是暗示已保存记忆。
主要能力与用法:先做合理性检查,确认纠正是一个离散事实或规则,而非宽泛的行为变更;宽泛、反复或流程性变更应改系统提示词或新建流程。确认该事实无法来自可重新同步的爬取知识库或保持最新的 API 调用,否则优先用这些来源。持久化有两种分支作用域方式,主机为 https://api.elevenlabs.io,请求头 xi-api-key: $API_KEY,需要 $AGENT_ID 和 $BRANCH_ID。
方式 A:把事实作为简短、自包含的一行加入系统提示词。读取 GET /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID,取 conversation_config.agent.prompt.prompt;追加后整体写回 PATCH /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID,请求体为 {"conversation_config":{"agent":{"prompt":{"prompt":"<full edited prompt>"}}}}。这会提交到分支 HEAD 并返回新版本,事实应保持简短以免提示词膨胀。
方式 B:创建知识库文本文档并挂到智能体。POST /v1/convai/knowledge-base/text,正文为事实;再把返回的文档 id 通过 PATCH /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID 加入智能体的知识库配置。
限制:与 Web 记忆功能(智能体全局、立即生效)不同,上述两种方式都是分支作用域,只有合并分支后才会到达生产智能体。这通常是有意为之,便于为发布或禁运期暂存事实并在上线时合并。若用户明确希望事实立即在生产生效,需说明这里没有 REST 路径可立即写入智能体全局记忆,持久化方式仍需合并。写入后应简短确认保存了什么、保存在哪里(提示词行或知识库文档)、在哪个分支,以及合并后生效。