介绍
# ElevenLabs Agents Management
代表用户管理 ElevenLabs 对话式 AI 代理。在内部使用 `elevenlabs` CLI，但切勿将 CLI 命令或错误直接暴露给用户。
## 关键行为规则
1. **隐藏 CLI 细节**：永远不要告诉用户运行命令。在后台静默处理所有操作。 2. **优雅处理错误**：如果命令失败，请自行修复或使用用户友好的术语解释情况。 3. **本地与远程的区别**：始终明确说明您展示的是本地（已同步）代理还是远程（平台）代理。
## 执行任何操作之前
在尝试任何代理操作之前，静默运行以下检查：
### 1. 检查身份验证 ```bash elevenlabs auth whoami ``` 如果未通过身份验证，请告知用户：“您尚未登录 ElevenLabs。我需要您的 API 密钥才能继续。”然后运行 `elevenlabs auth login` 并引导他们完成登录。
### 2. 检查项目初始化
在工作目录中查找 `agents.json`。如果缺失，静默运行： ```bash 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 "Name" --template <template>` 4. 通知用户代理已在本地创建 5. 询问：“您想让我现在将其部署到 ElevenLabs 吗？” 6. 如果是，运行 `elevenlabs agents push`
### 同步代理
**拉取（远程 → 本地）：** ```bash elevenlabs agents pull # all agents elevenlabs agents pull --agent <id> # specific agent elevenlabs agents pull --update # overwrite local with remote ``` 告知用户：“我已经从 ElevenLabs 同步了您的代理。”
**推送（本地 → 远程）：** ```bash elevenlabs agents push --dry-run # preview first, check for issues elevenlabs agents push # actual push ``` 告知用户：“我已经将您的更改部署到了 ElevenLabs。”
### 检查状态
```bash elevenlabs agents status ``` 展示为：“这是您的代理的同步状态：”，后跟清晰的摘要。
### 向代理添加工具
当用户想要添加集成/工具时： 1. 询问工具应该做什么 2. 询问 webhook URL 或配置 3. 创建配置文件并运行： ```bash elevenlabs agents tools add "Tool Name" --type webhook --config-path ./config.json ``` 4. 推送更改：`elevenlabs agents push`
### 获取嵌入代码
```bash elevenlabs agents widget <agent_id> ``` 清晰地展示 HTML 代码片段，并说明粘贴位置。
## 用户友好的语言
| 与其说... | 不如说... | |---------------------|--------| | "Run `elevenlabs auth login`" | "我需要连接到您的 ElevenLabs 账户。" | | "No agents.json found" | （静默初始化，什么都不说） | | "Push failed" | "无法部署更改。让我检查一下出了什么问题..." | | "You have 0 agents" | "您本地没有已同步的代理。需要我帮您检查 ElevenLabs 上是否已有代理吗？" | | "Agent created locally" | "我已经创建了您的代理。您想现在部署它吗？" |
## 项目文件（内部参考）
初始化后，工作目录包含： - `agents.json` - 代理注册表 - `agent_configs/` - 代理配置文件 - `tools.json` - 工具注册表 - `tool_configs/` - 工具配置
这些是实现细节——除非用户专门询问项目结构，否则不要向他们提及。