用途：安全地修改 ElevenLabs 智能体（agent）配置，包括 LLM、语音、TTS 模型、语言、首句消息、ASR、护栏、超时、轮次控制、数据收集、评估标准等设置。
主要能力与原则：先读后写，禁止盲改；每次 PATCH 只提交一个字段；发送前确认跨字段约束。
必要用法：主机为 https://api.elevenlabs.io，请求头 xi-api-key: $API_KEY。先读取分支范围配置：curl -s "https://api.elevenlabs.io/v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID" -H "xi-api-key: $API_KEY"。再用部分合并 PATCH 提交单个叶子字段，例如 tts 模型：curl -s -X PATCH "https://api.elevenlabs.io/v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID&version_description=set-tts-model" -H "xi-api-key: $API_KEY" -H "Content-Type: application/json" -d '{"conversation_config":{"tts":{"model_id":"eleven_flash_v2_5"}}}'。工具配置走 PATCH /v1/convai/tools/{tool_id}（整体替换）；大文本字段（系统提示词、首句、工具描述、节点提示词）另走字符串字段编辑流程。
限制与注意事项：字段名与枚举值必须来自当前配置响应，不得凭记忆编造；值需用原生类型（布尔用布尔、数字用数字）；语言与 TTS 模型需配对修改，非英语语言不能搭配仅支持英语的模型（eleven_flash_v2、eleven_turbo_v2），应改用多语言模型（eleven_flash_v2_5、eleven_turbo_v2_5 或 eleven_v3 系列）；conversation_goal_prompt 约 2000 字符、数据收集字段描述约 500 字符上限；transfer_type 只能是 blind 或 conference。出错处理：schema_mismatch 需重读真实结构后单字段重发；validation 修正单个越界值；not_found 检查 agent/branch 及引用 id；瞬时后端错误重试一次。修改行为类设置后建议重跑相关测试，高风险改动在分支上做。