# ElevenLabs Developers 發布 CLI v1：終端機直連語音、音樂與 Agent 工作流
> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)
> 原作者：ElevenLabs Developers (@ElevenLabsDevs) · 策展與摘要：EasyVibeCoding · 平台：X (Twitter) · 熱度：🔥 · 日期：2026-08-25
> 原始來源：https://x.com/ElevenLabsDevs/status/2091915556907532577
## 證據與延伸閱讀
- [ElevenLabs Developers 發布 CLI v1：終端機直連語音、音樂與 Agent 工作流。](https://elevenlabs.io/blog/elevenlabs-cli-v1)
- [執行 generate-skills 寫入檔案](https://video.twimg.com/amplify_video/2091890683523002368/vid/avc1/1280x720/fop8XwFHY7PqFZ2B.mp4?tag=29)
## 中文摘要
ElevenLabs Developers 發布 CLI v1：終端機直連語音、音樂與 Agent 工作流。
**核心定位** ElevenLabs CLI v1 不是只提供 API 的命令列包裝，而是以 coding agents 為優先設計。開發者可以在終端機管理 ElevenLabs 工作流程；Agent 則能讀取機器可解析的結果、串接命令，並在實際修改前預覽操作。ElevenLabs Developers 於 2026 年 8 月 24 日表示，CLI 的每個命令都有文件說明，也支援結構化 JSON 與 `--dry-run`。
> ElevenLabs CLI 的產品標題介面，深色背景上方置有圓角邊框包圍的白色字樣 ElevenLabs CLI，頂端則有較小的 IIEleven API 字樣。
**ElevenAgents 程式碼化** CLI 將 ElevenAgents 的設定視為程式碼管理。使用者可以把 workspace 中的 Agent 拉回本機設定檔，像修改其他程式庫內容一樣調整 greeting、voice 或 prompt，再檢視差異並推送回正式環境：
1. 執行 `elevenlabs agents pull`，將 workspace 內的 Agent 寫成本機設定檔。
2. 修改設定檔中的 greeting、voice 或 prompt。
3. 執行 `elevenlabs agents push --dry-run`，預覽即將套用的變更，不會真的修改遠端內容。
4. 確認差異後執行 `elevenlabs agents push`，套用更新。
> ElevenLabs CLI 的終端機操作畫面顯示於暗色字體介面中，列出已連線的 workspace、發現 12 個 agents、載入 AGENTS.md 並成功執行 pull 指令同步 agents 的過程。
示範流程接著以 `agents.json` 和多個 `agent_configs/*.json` 管理設定，並展示推送 Agent 至 ElevenLabs 的步驟。來源文章指出，Branch 可將開發與正式環境分開，例如開發環境使用測試電話號碼和較便宜的 LLM，正式環境則使用真實號碼與 frontier model；對於分布在數百個客戶組織的 Agent fleet，作者認為檔案與版本控制才是能擴展的工作流程。
**完整 API 操作** 來源文章表示，OpenAPI spec 已發布的每個 ElevenLabs API endpoint，都能透過 CLI 對應的 subcommand 呼叫。常見操作包括：
- `elevenlabs agents list --format json`：以結構化 JSON 列出 workspace 中的所有 Agent。
- `elevenlabs music compose --prompt "lo-fi track for a rainy afternoon" --output track.mp3`：根據 prompt 產生音樂並輸出為 `track.mp3`。
- `elevenlabs text-to-speech convert --voice-id gPPH6SLdL8XSX6GNJ40G --text "Hello from the CLI" --output hello.mp3`：將文字轉成語音並儲存為 `hello.mp3`。
> 黑色背景的終端機介面，顯示帶有註解的無效指令 `# invalid command` 以及一串 `elevenlabs text-to-speech convert` 指令。
影片中的 help 選單也展示 `agents`、`audio-isolation`、`dubbing`、`music`、`speech-to-text`、`text-to-speech` 與 `voices` 等產品群組；畫面顯示支援 macOS、Linux 與 Windows。這些命令可在同一個終端機介面處理 Agent、語音、音訊、影片與音樂工作流程。
**針對人與 Agent 的回應** CLI 會辨識命令是由人或 Agent 執行。人類在 TTY 中操作時，會看到較易讀的錯誤訊息與修正提示；coding agent 則會收到相同內容的 JSON，方便解析與自動修正。`--help` 主要提供給人閱讀，`--schema` 則提供給 Agent 建構有效呼叫所需的機器可讀契約，包括輸入欄位的位置、型別、必填條件與回應格式。
> 在黑色終端機介面中執行的 elevenlabs text-to-speech convert 指令，因缺少必要參數而回傳帶有 400 錯誤碼與驗證錯誤訊息的 JSON 結構。
例如缺少 `voice_id` 時，Agent 會收到 `validationError` JSON，內容指出必須透過 `--voice-id` 或 `--params` 提供該參數；人類則會看到可讀訊息，並獲得執行 `elevenlabs text-to-speech convert --help` 的提示。這種設計針對 Agent 無法回答互動式 prompt、可能持續重試，以及會依錯誤訊息調整行為等特性。
> 在黑色背景的終端機視窗中顯示了一則驗證錯誤訊息，指出缺少必要的參數「voice_id」，並提示使用者可透過命令列參數提供，或輸入指令查詢求助說明。
**內建 skills 與驗證流程** CLI 附帶可教導 coding agent 完整工作流程的 skills，涵蓋建立 Agent、產生語音與轉錄通話等任務。執行下列命令會把產品群組的 instructions 寫入專案：
```bash
elevenlabs generate-skills
```
> ElevenLabs CLI 終端機工具的介紹與操作示範
動圖顯示該命令寫入 31 個 skill 檔案至 `skills/`，接著執行 `elevenlabs agents push --dry-run` 預覽更新，再以 `elevenlabs agents test agent_2401m0fs0q68fwjra9g3jkr2d17z` 執行 3 個測試；畫面中「訂單查詢」與「問候」測試通過，最後執行 `elevenlabs agents push` 更新 `Support Agent`。這呈現出從產生 skills、測試、預覽到發布的連續 workflow，但畫面中的測試結果屬於示範流程，不代表所有 Agent 都會得到相同結果。
> terminal 視窗執行 elevenlabs 指令產生 skills 並測試 agents 的過程
**安裝方式與延伸整合** 發文者提供的 macOS 安裝方式是：
```bash
brew install elevenlabs/tap/elevenlabs
```
> ElevenLabs CLI 的標題畫面中央呈現帶有圓角外框的 ElevenLabs CLI 字樣，上方有 IIEleven API 標識，右下角則有一個嵌入畫面顯示一位戴眼鏡的男士坐在麥克風前。
ElevenLabs Developers 也提到，Agent 可依工作位置選擇 MCP 或 CLI：透過 MCP，Claude 能讀取近期對話、找出來電者掛斷的位置，再改寫 greeting；透過 CLI，則能把相同流程腳本化，套用到整個 voice agent fleet。ElevenLabs CLI v1 的完整介紹可參考 [ElevenLabs CLI v1](https://elevenlabs.io/blog/elevenlabs-cli-v1)。
> 黑底背景的 ElevenLabs API 宣傳視覺，左上角標示「IIEleven API」，左側寫有「Create your sonic identity.」，下方有「Finetunes.」，四周散落著多張黑白與彩色的人物特寫照片。
## 媒體內容
**ElevenLabs CLI 終端機工具的介紹與操作示範**
**影片中的 Prompt 與操作**
Prompt（00:31）：
```
demo # elevenlabs text-to-speech convert --voice-id gPPH6SL8X6GNJ40G --text "Hello from the new ElevenLabs CLI." --output hello.mp3
```
Prompt（01:41）：
```
demo # elevenlabs music compose --prompt "lo-fi track for a rainy afternoon" --output track.mp3
```
Prompt：
```
demo # elevenlabs agents push
```
操作步驟：
1. （00:00）顯示 ElevenLabs CLI 標題與 OpenAPI JSON 網址
2. （00:10）顯示線上 API 文件頁面與 endpoint 結構
3. （00:16）顯示終端機執行 pull 代理程式指令
4. （00:20）顯示 brew 安裝指令與 help 命令列表
5. （00:29）顯示支援的作業系統圖標 (macOS、Linux、Windows)
6. （00:31）顯示 text-to-speech 轉檔指令與執行
7. （00:46）顯示 Finder 中的 hello.mp3 檔案資訊與播放介面
8. （00:57）顯示 music compose 指令與 prompt 參數
9. （01:49）顯示產生的 track.mp3 檔案資訊與播放介面
10. （02:03）顯示 agents.json 與各 agent 設定檔 JSON 內容
11. 顯示網頁端 Agent 設定與預覽介面
12. 顯示 agent 語音通話預覽介面
13. 顯示 agents push 指令將變更同步至 workspace
14. 顯示重新發起通話與更新後的初始訊息
15. 顯示講者總結說明
16. 顯示結尾的 brew install 安裝指令畫面
**逐字稿**
- `00:00` 今天我們推出 ElevenLabs CLI，（Today we're launching the ElevenLabs CLI,）
- `00:01` 能直接在終端機中使用 ElevenLabs API。（which brings our ElevenLabs API directly in your terminal.）
- `00:05` 因此，我們在 OpenAPI 規格上發布的每個端點，都會成為這個終端機中的一個子命令。（So every endpoint we publish on the OpenAPI spec becomes a subcommand inside this terminal.）
- `00:10` 這表示它永遠不會過時。（This means it's never going to be outdated.）
- `00:12` 如果你在 API 參考文件中看得到它，就應該會有一個（If you see it in an API reference, there should be a）
- `00:14` 對應的 CLI 命令。（command in the CLI.）
- `00:15` 由於現在我們大多使用程式開發 Agent，這個 CLI 的開發以（Since these days we're mostly using coding agents, this CLI was developed to be）
- `00:19` Agent 優先為原則。（agent first.）
- `00:19` 它有完善文件的命令、結構化的 JSON 輸出，（It has well-documented commands, it has structured JSON outputs,）
- `00:23` 以及乾跑模式，（and a dry run mode）
- `00:24` 會在實際接觸 workspace 前，預覽任何操作。（that previews any operation before it actually touches the workspace.）
- `00:27` 它能在所有平台上執行，（It runs on all the platforms,）
- `00:28` 包括 macOS、Linux 和 Windows。（including macOS, Linux, and Windows.）
- `00:30` 接下來就展示幾個我們可以使用的命令。（So let's showcase a few of the commands that we can use.）
- `00:33` 剛才看到的文字轉語音功能有一個 convert 選項。（So this text-to-speech we saw has a convert option.）
- `00:35` 我們必須傳入想使用的語音 ID、（We have to pass in the voice ID that we want to use,）
- `00:38` 想使用的文字，以及要將輸出儲存在哪裡。（the text that we want to use, and where we want that output saved.）
- `00:41` 如果我按下 Enter，應該就能（If I click enter, we should be）
- `00:43` 等上幾秒鐘。（able to wait a few seconds.）
- `00:45` 好了，我們有一個名為 hello.mp3 的檔案，它應該會說出（And here we go, we have a file called hello mp3, and it should say the words）
- `00:50` 「來自全新 ElevenLabs CLI 的問候」。（hello from the new ElevenLabs CLI.）
- `00:52` 來自全新 ElevenLabs CLI 的問候。（Hello from the new ElevenLabs CLI.）
- `00:55` 太完美了。（Perfect.）
- `00:55` CLI 的其餘部分也有非常（The rest of the CLI has a very）
- `00:58` 相似的結構。（similar structure.）
- `00:59` 所以這次，我們來創作一些音樂。（So in this case, let's compose some music.）
- `01:01` 我們有 ElevenLabs music compose，prompt 是（We have ElevenLabs music compose prompt）
- `01:03` 「適合下雨午後的 lo-fi 曲目」，輸出檔應該是 track（lo-fi track for a rainy afternoon, and the output should be track.）
- `01:06` .mp3。（mp3.）
- `01:06` 我們可以送出這個命令。（We can send out that command.）
- `01:08` 幾秒鐘後，我們就取得了 track.mp3 的結果，（And here, a few seconds later, we have the result of track mp3,）
- `01:11` 來聽聽看。（and let's give it a listen.）
- `01:20` 聽起來確實像是適合下雨午後的 lo-fi 曲目。（That does sound like a lo-fi track for a rainy afternoon.）
- `01:22` 現在透過 CLI，你的 Agent 會變成（And now using the CLI, your agents become）
- `01:24` 實際存在磁碟上的 JSON 物件，你可以讓它們保持同步，（actual JSON objects living on your disk that you can keep in sync,）
- `01:28` 可以進行設定，也可以（you can configure, you can do）
- `01:30` 在檔案中完成任何你需要做的事。（anything that you need to do within your file.）
- `01:33` 這就是 agents.（This is what the agents.）
- `01:34` json 檔案的樣子。（json file looks like.）
- `01:35` 它包含（It has）
- `01:36` 所有與你帳號關聯的 Agent。（all the agents that are associated with your account.）
- `01:38` 這是個別 Agent（And this is what the individual agent）
- `01:40` 的樣子。（looks like.）
- `01:41` 從這裡可以看到，這些 Agent 能透過你可以（You can see how configurable these agents are by the amount of parameters you can）
- `01:45` 儲存的參數數量進行大量設定。（save here.）
- `01:46` 你可以用 Agent 做很多事情。（There's a lot of things you can do with agents.）
- `01:48` 而現在最棒的是，你可以在（And the beauty now is you can do it within）
- `01:49` 終端機中完成這些操作，還可以讓你的 Agent 設定其他 Agent。（terminal, and your agents can configure your agents now.）
- `01:52` 這樣做的另一個好處是，現在你可以（Another benefit of this is that now you can）
- `01:55` 對 Agent 使用 git。（use git for your agents.）
- `01:56` 你可以查看其中發生的任何變更差異，並確保（You can check the diff between any changes that happen to it, and make sure）
- `02:00` 它始終按照應有的方式運作。（that it's always working how it should be.）
- `02:02` 我們也可以隨時透過這個設定檔更新 Agent。（We can always so update our agents using this config file.）
- `02:05` 所以（So）
- `02:05` 一開始的第一則訊息是：「嗨，感謝你致電 Peak Audio 客服。」（the initial first message was, hi, thank you for calling Peak Audio Support.）
- `02:08` 我們可以使用 Agent 預覽功能（And we can preview that）
- `02:09` 來預覽這段訊息。（using our agent preview.）
- `02:11` 嗨，感謝你致電 Peak Audio 客服。（Hi, thanks for calling Peak Audio Support.）
- `02:13` 今天我可以怎麼幫你？（How can I help you today?）
- `02:14` 這就是（So that was the）
- `02:15` 我們之前使用的初始訊息。（initial message we had before.）
- `02:16` 我們可以把它改成：「嗨，我是透過 CLI 來的。」（And we can change that to say, hi, I am from the CLI.）
- `02:19` 所以我做出（So once I make）
- `02:20` 變更後，就可以執行 ElevenLabs agents push，（the change, I can do ElevenLabs agents push,）
- `02:22` 這個新的 Agent 設定就會被推送並同步到（and this new agent configuration gets pushed and synced up to）
- `02:25` 我的 workspace。（my workspace.）
- `02:26` 現在如果我重新整理，再次開始通話，（So now if I refresh, I start the call again.）
- `02:29` 嗨，我是透過 CLI 來的。（Hi, I am from the CLI.）
- `02:30` 你會看到不同的（You get a different）
- `02:32` 開場初始訊息。（starting initial message.）
- `02:33` 當然，我只是為了這個示範直接輸入這段文字。（Of course, I just typed it in for this demo.）
- `02:35` 但你可以想像，使用 Claude、（But you can imagine using Claude,）
- `02:37` Codex、Cursor，（Codex, Cursor,）
- `02:38` 或任何你正在使用的工具，直接請你的 Agent 更新你的 Agent。（or whatever tool you're using to simply ask your agent to update your agent.）
- `02:43` 而且因為它（And since it's）
- `02:43` 只是一個存在你電腦上的檔案，所以它可以執行你交代的任何變更。（just a file on your computer, it can execute any change that you give it.）
- `02:46` 這就是 ElevenLabs（And that's the ElevenLabs）
- `02:47` CLI。（CLI.）
- `02:47` 它包含 API 參考文件中的完整 API，（It's the full API that we have on the API reference,）
- `02:50` 只是改在你的終端機和檔案中使用，（except in your terminal and within files,）
- `02:53` 而且你的 Agent 可以透過程式碼管理。（and your agents can be managed as code.）
- `02:54` 我建議你把它安裝好，方便你的程式開發 Agent 使用，並告訴它（I recommend you install it handy to your coding agent, tell it）
- `02:58` 使用 help 指令探索 CLI，（to explore the CLI using the help command,）
- `02:59` 希望你能推出一些令人驚豔的成果。（and hopefully you can ship some incredible things.）
- `03:02` 如果你想進一步探索，下面有文件連結。（The docs are linked below if you want to explore more.）
**terminal 視窗執行 elevenlabs 指令產生 skills 並測試 agents 的過程**
**影片中的 Prompt 與操作**
操作步驟：
1. （00:00）elevenlabs generate-skills
2. （00:01）elevenlabs agents push --dry-run
3. （00:03）elevenlabs agents test agent_2401m0fs0
4. （00:07）elevenlabs agents push
## 標籤
CLI, 新產品, Agent, ElevenLabs