ElevenLabs CLI

概要

ElevenLabs CLIを使うと、ターミナルからElevenLabsエージェントにアクセスでき、新しい方法で管理できます。

• エージェントをコードとしてバージョン管理システムに保存
• CI/CDインテグレーションを設定し、エージェントを自動デプロイ
• コーディングエージェントから音声エージェントにアクセスして管理

インストール

Homebrew（macOS）とScoop（Windows）は推奨のインストール方法で、スタンドアロンバイナリを提供します。

brew install elevenlabs/tap/elevenlabs

インストール後、ターミナルでelevenlabsコマンドをグローバルに使用できます。

クイックスタート

elevenlabs agents init

elevenlabs auth login

elevenlabs agents add "My Assistant" --template assistant

elevenlabs agents push

プロジェクト構造

CLIは構造化されたプロジェクトディレクトリを作成します。

your_project/
├── agents.json              # Central agent configuration registry
├── tools.json               # Tool definitions registry
├── tests.json               # Test definitions registry
├── agent_configs/           # Agent configuration files
├── tool_configs/            # Tool configuration files
└── test_configs/            # Test configuration files

認証

elevenlabs auth loginは、認証情報をオペレーティングシステムのキーリングに保存します。macOSではKeychain、 WindowsではCredential Manager、LinuxではSecret Serviceを使用します。キーリングが利用できない場合、 CLIは0600権限で~/.config/elevenlabs/auth-keyring.jsonにフォールバックします。使用中の保存先を確認するには elevenlabs auth statusを実行し、保存済みのエントリを削除するにはelevenlabs auth logoutを実行してください。

CIではログインの代わりに、環境変数または.envファイルでELEVENLABS_API_KEYを設定してください。

認証コマンド

elevenlabs auth login

エージェント管理

エージェントの作成

事前構築済みテンプレートを使用してエージェントを作成します。

elevenlabs agents add "Agent Name" [options]

オプション：

• --template <type>：利用可能なテンプレートから選択（デフォルト：default）
• --skip-upload：プラットフォームにアップロードせずローカルで作成

例：

elevenlabs agents add "Customer Support Bot" --template customer-service

テンプレート

CLIには、一般的なユースケース向けに6つの事前構築済みテンプレートがあります。

テンプレートコマンド

elevenlabs agents templates list

同期

ローカル設定をElevenLabsプラットフォームと同期します。

elevenlabs agents push

ステータスとモニタリング

elevenlabs agents status

インポートとエクスポート

elevenlabs agents pull

ツール管理

CLIは、エージェントの機能を拡張する2種類のツールをサポートしています。

Webhookツール

認証とタイムアウトを設定できるHTTP APIインテグレーション：

elevenlabs tools add "API Integration" --type "webhook" --config-path ./config.json

クライアントツール

クライアント側との直接インテグレーション：

elevenlabs tools add "Client Function" --type "client" --config-path ./config.json

ウィジェットの生成

Webインテグレーション用のHTML埋め込みコードを生成します。

elevenlabs agents widget embed <agent_id>

次のようなHTMLコードが出力されます。

<elevenlabs-convai agent-id="agent_id_here"></elevenlabs-convai>
<script src="https://unpkg.com/@elevenlabs/convai-widget-embed" async></script>

設定ファイル

エージェント設定の構造

各エージェント設定には次の内容が含まれます。

{
  "name": "Agent Name",
  "conversation_config": {
    "agent": {
      "language": "en",
      "prompt": {
        "prompt": "You are a helpful AI assistant.",
        "llm": "gemini-2.5-flash",
        "temperature": 0.0
      }
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000"
    },
    "asr": {
      "provider": "scribe_realtime",
      "quality": "high",
      "user_input_audio_format": "pcm_16000"
    },
    "conversation": {
      "text_only": false,
      "max_duration_seconds": 600,
      "client_events": ["audio", "interruption"]
    }
  },
  "platform_settings": {
    "widget": {
      "variant": "full",
      "placement": "bottom-right"
    }
  },
  "tags": []
}

CI/CDパイプラインとのインテグレーション

# In your GitHub Actions workflow
- name: Deploy ElevenAgents agents
  run: |
    npm install -g @elevenlabs/cli
    export ELEVENLABS_API_KEY=${{ secrets.ELEVENLABS_API_KEY }}
    elevenlabs agents push --dry-run  # Preview changes
    elevenlabs agents push            # Deploy
    elevenlabs agents status          # Verify deployment