用途：管理 ElevenLabs 智能体的分支、版本、草稿、流量拆分与合并。分支是智能体配置（提示词、语音、工具、工作流）的版本化快照，可在不影响线上生产的情况下测试改动；main 为默认分支，未配置拆分时接收 100% 流量。草稿是分支上未提交的编辑，发布后才成为版本。流量拆分按会话 id 确定性地把线上会话分配到各分支，用于 A/B 测试。合并把源分支改动并入其父分支（通常为 main），并在目标上创建新版本。
接口：Host 为 https://api.elevenlabs.io，请求头 xi-api-key: $API_KEY，需由使用者提供 $API_KEY 与 $AGENT_ID。
主要能力与用法：先读取当前分支状态（GET /v1/convai/agents/$AGENT_ID/branches），记录每个分支的 id（agtbrch_...）、current_live_percentage、protection_status、parent_branch_id、main_branch_id、draft_exists，并从 .most_recent_versions[0].id 取 HEAD 版本；再用 GET /v1/convai/agents/$AGENT_ID 确认当前活动分支。创建实验副本用 POST /v1/convai/agents/$AGENT_ID/branches，传 {name, description, parent_version_id}，新分支初始为 0% 流量。在指定分支上编辑需在所有读写中加 ?branch_id=<id>，PATCH 提交到该分支 HEAD 而非 main。分配线上流量需设置流量拆分；合并用 POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge，合并前先预览 diff。
限制：写入前必须先用分支列表按名称解析出确切 id，不得复用旧上下文或猜测的 id，无精确匹配时应向用户确认。流量拆分必须覆盖所有活动（非归档）分支且总和恰为 100%，调整一个分支需在同一次调用中同步调整其他分支。main 通常为 admin_perms_required，非管理员合并或编辑 main 会报权限错误，此时可改用流量拆分 A/B 路径或联系支持。合并目标由 parent_branch_id 决定，不能合并到无关分支。存在未提交草稿（draft_exists: true）会阻塞切换或合并，需先保存提交或显式丢弃。建议按 10%→50%→100% 逐步放量，而非一次跳到 100%。current_live_percentage 只影响未固定流量的自动路由，0% 分支仍可能被显式选中而收到会话。常见错误处理：校验失败多为流量总和不为 100 或数组结构问题，应重读分支列表重算后重发；not_found 表示 id 过期、已归档或传入了名称；wrong-state 多为草稿阻塞；权限错误不要重试。