> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # CLI da ElevenLabs ## Visão geral A CLI da ElevenLabs permite acessar seus agentes da ElevenLabs pelo terminal, oferecendo novas formas de gerenciá-los: * Armazene agentes como código no seu sistema de controle de versão * Configure a integração de CI/CD para implantar seus agentes automaticamente * Permita que seu agente de programação acesse e gerencie seus agentes de voz > **Prefere ir direto para o código?** > > Encontre o [código-fonte completo e contribua no GitHub](https://github.com/elevenlabs/cli). > **Não é necessário instalar** > > Se você trabalha pelo Claude ou outro cliente MCP, o [servidor MCP hospedado](/docs/pt/eleven-agents/operate/hosted-mcp) oferece ferramentas de gerenciamento de agentes sem instalação > local. Use a CLI quando quiser manter agentes no controle de versão; use o servidor MCP hospedado para > gerenciamento conversacional. ## Instalação Homebrew (macOS) e Scoop (Windows) são os métodos de instalação recomendados e fornecem um binário independente. **`Homebrew (macOS)`** ```bash title="Homebrew (macOS)" brew install elevenlabs/tap/elevenlabs ``` **`Scoop (Windows)`** ```powershell title="Scoop (Windows)" scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket scoop install elevenlabs ``` **`npm`** ```bash title="npm" npm install -g @elevenlabs/cli ``` **`curl`** ```bash title="curl" curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh ``` > **Tip** > > Está trabalhando com um assistente de programação com IA? Execute `elevenlabs generate-skills` no seu projeto para criar um > `SKILL.md` para cada grupo de comandos em `skills/`, para que seu assistente conheça toda a superfície da CLI > sem que você precise colar a documentação. Use `--output-dir` para colocá-los em outro lugar. Isso lê a própria > definição de API incorporada da CLI, portanto não precisa de chave de API e funciona off-line — além de acompanhar > a versão da CLI que você tiver instalado. Após a instalação, o comando `elevenlabs` estará disponível globalmente no seu terminal. ## Início rápido ### Inicialize um novo projeto ```bash elevenlabs agents init ``` Isso cria a estrutura do projeto com diretórios de configuração e arquivos de registro. ### Autentique-se na ElevenLabs ```bash elevenlabs auth login ``` Isso abrirá uma janela do navegador para autenticação via OAuth. A CLI verificará as credenciais e as armazenará com segurança. ### Crie seu primeiro agente ```bash elevenlabs agents add "My Assistant" --template assistant ``` Isso cria uma nova configuração de agente usando o modelo de assistente. ### Envie para a plataforma da ElevenLabs ```bash elevenlabs agents push ``` Isso envia a configuração local do seu agente para a plataforma da ElevenLabs. ## Estrutura do projeto A CLI cria um diretório de projeto estruturado: ``` 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 ``` ## Autenticação `elevenlabs auth login` armazena credenciais no chaveiro do seu sistema operacional — Keychain no macOS, Gerenciador de Credenciais no Windows e Secret Service no Linux. Quando não há chaveiro disponível, a CLI usa como alternativa `~/.config/elevenlabs/auth-keyring.json` com permissões `0600`. Execute `elevenlabs auth status` para ver qual fonte está em uso e `elevenlabs auth logout` para remover a entrada armazenada. Para CI, defina `ELEVENLABS_API_KEY` no ambiente ou em um arquivo `.env`, em vez de fazer login. ### Comandos de autenticação **`Login`** ```bash title="Login" elevenlabs auth login ``` **`Sair`** ```bash title="Sair" elevenlabs auth logout ``` ## Gerenciamento de agentes ### Criando agentes Crie agentes usando modelos prontos: ```bash elevenlabs agents add "Agent Name" [options] ``` **Opções:** * `--template `: escolha entre os modelos disponíveis (padrão: default) * `--skip-upload`: crie localmente sem enviar para a plataforma **Exemplo:** ```bash elevenlabs agents add "Customer Support Bot" --template customer-service ``` ### Modelos A CLI oferece seis modelos prontos para casos de uso comuns: #### default Configuração completa com todos os campos disponíveis, padrões adequados, suporte completo a voz/texto, personalização de widget e critérios de avaliação. #### minimal Apenas campos essenciais, incluindo prompt básico, idioma, TTS e configurações de conversa. #### voice-only Otimizado para interações por voz, com entrada de texto desativada e configurações avançadas de voz. #### text-only Conversas voltadas a texto, com recursos de voz desativados. #### customer-service Prompts profissionais e empáticos, baixa temperatura (0.1), duração de 30 minutos e critérios de avaliação. #### assistant Assistente de IA de uso geral, com criatividade equilibrada (temperatura 0.3) e suporte versátil a voz/texto. ### Comandos de modelos **`Listar modelos disponíveis`** ```bash title="Listar modelos disponíveis" elevenlabs agents templates list ``` **`Mostrar configuração do modelo`** ```bash title="Mostrar configuração do modelo" elevenlabs agents templates show