用途:在给出建议或修改前,先了解 ElevenLabs 智能体的当前配置,只获取足够行动的信息,避免每次拉取完整配置。
主要能力:按分支读取智能体配置,一次响应包含名称、系统提示词、LLM、语言、TTS 模型与音色、工具 ID、护栏和工作流;可按需单独读取某个工具、流程列表与流程正文、历史对话及转写。
使用方式:主机为 https://api.elevenlabs.io,请求头为 xi-api-key: $API_KEY,由工程师提供 $API_KEY、$AGENT_ID 及相关的 $BRANCH_ID。读取智能体:curl -s "https://api.elevenlabs.io/v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID" -H "xi-api-key: $API_KEY"。读取工具:GET /v1/convai/tools/{tool_id}。读取流程:GET /v1/convai/agents/$AGENT_ID/branches/$BRANCH_ID/procedures,再按 id 取正文。读取对话:GET /v1/convai/conversations?agent_id=$AGENT_ID,再取单条转写。独立读取可并行,但都需窄范围。
适用场景:任务开始时需要智能体现状,或其他技能要求先探查智能体,再决定推荐或改动。
限制:只读任务所需字段,不要为读一个叶子字段重新拉取完整配置;对话含客户 PII 与分析数据,不得复制到其他系统或日志,并遵守零保留模式账户;超出查看一两次通话的翻页、聚合、采样等应使用 architect-review-live-calls。空工作流(仅起始节点无边)是默认状态而非自定义配置;有流程但无工作流节点时,应描述为流程驱动、未配置工作流。最后用一句话总结当前设置,再询问工程师想改进什么。