SuperAPI AI 工具集

architect-edit-existing-tool

智能体与模型

查看项目

更新于 10-15 21:37

技能介绍

用途:修改 ElevenLabs 智能体上已存在的工具配置,包括重命名、修正描述、更改 webhook 的 URL、请求头与鉴权,以及增删改参数。所有调用使用 xi-api-key: $API_KEY,基址为 https://api.elevenlabs.io。

主要能力与用法:先读取再编辑。用 GET /v1/convai/tools 获取工具 id 与类型(webhook / client / code),类型决定配置结构;用 GET /v1/convai/tools/{tool_id} 读取当前保存的配置,包括 name、description、request_body_schema 属性、request_headers、auth、响应赋值、response_timeout_secs,以及 client 工具的 expects_response / execution_mode;用 GET /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID 确认工具已挂载及被哪些节点引用。修改用 PATCH /v1/convai/tools/{tool_id},该请求会替换配置,因此需按读取到的类型发送完整配置并应用改动;只改用户要求的部分,但触及的嵌套字段要整体重发。系统工具(transfer_to_number、end_call、language_detection、skip_turn、update_state 等)不通过此方式编辑,其配置位于智能体配置中,需用 PATCH /v1/convai/agents/$AGENT_ID?branch_id=$BRANCH_ID 定位相应路径修改。

限制与注意:request_body_schema 中每个属性必须恰好具备 description、constant_value、dynamic_variable、is_system_provided 之一;数组属性必须有 items schema 且不得带 constant_value;URL 必须静态,不能含 {{variables}};request_headers 是对象而非数组,密钥用 {"secret_id": "..."};响应赋值用点号路径(如 data.items.0.id);response_timeout_secs 默认 20、最大 120;client 工具若 execution_mode 为 async,则 expects_response 必须为 false。重命名后引用旧名称的提示词或边条件将不再触发工具,需同步更新。常见错误包括 schema_mismatch、validation、not_found,应按提示重新读取并修正字段后重发,不要重复提交相同请求体。若问题是工具未被调用或运行时无结果,应改用 troubleshoot-tool-errors 技能。