名称： elevenlabs-agents
描述： 创建、管理和部署 ElevenLabs 对话式 AI 助手。当用户需要操作语音助手、列出助手、创建新助手或管理助手配置时使用。
元数据： {"clawdbot":{"requires":{"bins":["elevenlabs"]}}}

ElevenLabs 助手管理

代表用户管理 ElevenLabs 对话式 AI 助手。内部使用 elevenlabs CLI，但切勿直接向用户暴露 CLI 命令或错误信息。

关键行为准则

1. 隐藏 CLI 细节：绝不要求用户运行命令。所有操作都应在后台静默处理。
2. 优雅处理错误：如果命令执行失败，请自行修复或使用用户友好的语言解释情况。
3. 明确区分本地与远程：始终清晰地说明你展示的是本地（已同步）助手还是远程（平台）助手。

执行任何操作前

在尝试任何助手操作前，请静默执行以下检查：

1. 检查身份验证

elevenlabs auth whoami

如果未通过验证，请告知用户：“您尚未登录 ElevenLabs。我需要您的 API 密钥才能继续。” 然后运行 elevenlabs auth login 并引导用户完成登录流程。

2. 检查项目初始化

检查工作目录中是否存在 agents.json 文件。如果缺失，请静默运行：

elevenlabs agents init

切勿告知用户缺少 agents.json 文件——直接初始化即可。

操作指南

列出助手

当用户要求查看其助手时：

1. 首先尝试 elevenlabs agents list（显示本地助手）。
2. 如果本地没有助手，请告知用户：“您本地没有同步任何助手。需要我从 ElevenLabs 平台拉取您的助手吗？”
3. 如果用户确认，则运行 elevenlabs agents pull，然后再次列出。
4. 以清晰的表格或列表格式呈现结果，而非原始 CLI 输出。

创建助手

当用户想要创建助手时：

1. 询问助手名称和用途（不要提及“模板”）。
2. 根据用户的描述，选择合适的模板：
   • 客户支持 → customer-service
   • 通用助理 → assistant
   • 语音专注型 → voice-only
   • 简单/极简型 → minimal
   • 情况不明时的默认选择 → default
3. 运行：elevenlabs agents add "名称" --template <模板>
4. 告知用户助手已在本地创建成功。
5. 询问：“您希望我现在将其部署到 ElevenLabs 平台吗？”
6. 如果用户同意，则运行 elevenlabs agents push。

同步助手

拉取（远程 → 本地）：

elevenlabs agents pull                    # 所有助手
elevenlabs agents pull --agent <id>       # 特定助手
elevenlabs agents pull --update           # 用远程版本覆盖本地

告知用户：“我已从 ElevenLabs 同步了您的助手。”

推送（本地 → 远程）：

elevenlabs agents push --dry-run  # 先预览，检查潜在问题
elevenlabs agents push            # 实际推送

告知用户：“我已将您的更改部署到 ElevenLabs。”

检查状态

elevenlabs agents status

以以下格式呈现：“这是您助手的同步状态：”，后跟一个清晰的摘要。

为助手添加工具

当用户想要添加集成/工具时：
1. 询问该工具应具备的功能。
2. 询问 Webhook URL 或配置信息。
3. 创建配置文件并运行：

elevenlabs agents tools add "工具名称" --type webhook --config-path ./config.json

4. 推送更改：elevenlabs agents push

获取嵌入代码

elevenlabs agents widget <agent_id>

清晰地呈现 HTML 代码片段，并解释将其粘贴到何处。

用户友好语言对照表

项目文件（内部参考）

初始化后，工作目录包含：
* agents.json - 助手注册表
* agent_configs/ - 助手配置文件
* tools.json - 工具注册表
* tool_configs/ - 工具配置文件

这些是内部实现细节——除非用户明确询问项目结构，否则不要提及。