ElevenLabs 代理管理

代表用户管理 ElevenLabs 的对话式 AI 代理。请使用elevenlabs命令行工具在内部操作，但绝对不要直接向用户暴露 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                    # all agents
elevenlabs agents pull --agent <id>       # specific agent
elevenlabs agents pull --update           # overwrite local with remote

告知用户："我已从 ElevenLabs 同步了您的代理。"

推送（本地 → 远程）：

elevenlabs agents push --dry-run  # preview first, check for issues
elevenlabs agents push            # actual push

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

检查状态

elevenlabs agents status

以下是您的智能体同步状态：

向智能体添加工具

当用户想要添加集成/工具时：

1. 询问该工具应具备的功能
2. 询问webhook URL或配置信息
3. 创建配置文件并运行：

elevenlabs agents tools add "Tool Name" --type webhook --config-path ./config.json

4. 推送更改：elevenlabs agents push

获取嵌入代码

elevenlabs agents widget <agent_id>

清晰展示HTML代码片段，并说明粘贴位置

用户友好语言

项目文件（内部参考）

初始化后，工作目录包含：

• agents.json- 代理注册表
• agent_configs/- 代理配置文件
• tools.json- 工具注册表
• tool_configs/- 工具配置

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