Criando ElevenAgents com Claude Code

Antes, criar agentes de voz exigia semanas de trabalho e vários fornecedores. Agora, você pode montar tudo em uma tarde com o Claude Code. Este guia mostra o passo a passo: persona, base de conhecimento, workflow, ferramentas, regras de segurança, testes e até um número de telefone para ligar.

O que você pode criar em uma tarde:

• Agente de voz que te acorda com um resumo dos erros de CI durante a noite
• Central de suporte multilíngue para seu projeto paralelo ainda hoje
• Agente interativo para seu portfólio que fala como você

As limitações que faziam agentes de voz parecerem robóticos, como latência, prosódia e alternância de fala, melhoraram muito. Nosso modelo mais rápido tem latência de cerca de 75ms, com um sistema que lida com pausas e interrupções em tempo real. O Eleven v3 é nosso modelo de Transformar Texto em Áudio mais expressivo, capaz de mudar o tom, rir e suspirar como uma pessoa.

Configuração rápida

Primeiro, instale a skill da ElevenLabs com o seguinte prompt no Claude Code:

Install the ElevenLabs skill globally - npx skills add elevenlabs/skills

Depois, execute a skill setup-api-key para conectar sua chave da API ElevenLabs:

Set up the elevenlabs key using the setup-api-key skill.

Dica: limite a chave apenas para "agents-write" e defina um limite diário de gastos. Um loop fora de controle pode consumir créditos rapidamente.

Crie o agente

O ElevenAgents foi criado para você montar um agente de voz pronto para produção no Claude Code em poucos minutos, usando prompts em linguagem natural. O restante deste guia traz esses prompts, levando você de um espaço em branco até um número de telefone para ligar.

Vamos começar pelo agente em si. Este primeiro prompt cria um agente com persona, voz e um LLM para lidar com o raciocínio. Sem ferramentas, base de conhecimento ou workflow ainda — é o caminho mais rápido do zero até o agente mínimo viável.

Create an ElevenAgent: a warm, knowledgeable product expert. Use a v3 conversational voice and Qwen-3.6 as the LLM. Return the dashboard URL.

Adicione uma base de conhecimento

A base de conhecimento é o conjunto de documentos, URLs e FAQs que seu agente pode consultar quando alguém faz uma pergunta. O ElevenAgents cuida do pipeline de busca (RAG, ou geração aumentada por recuperação) para você. Quando um usuário pergunta algo, a plataforma busca o conteúdo indexado, seleciona os trechos mais relevantes e envia para o LLM como contexto antes de gerar a resposta. As fontes são reindexadas automaticamente quando mudam, então o agente fica sempre atualizado com seus documentos sem precisar subir nada de novo.

Add a knowledge base to my agent. Index 
https://elevenlabs.io/docs/eleven-agents/overview
 and ./README.md if it exists. 

Auto-reindex on.

Adicione um workflow

Um agente com um único prompt resolve tarefas específicas. Workflows permitem conversas com múltiplas intenções. Em vez de colocar todos os comportamentos possíveis em um único prompt, você divide o agente em nós, cada um cuidando de uma intenção, e faz o roteamento entre eles conforme a necessidade do usuário. Cada nó tem um comportamento próprio, e as conexões entre eles são feitas com base em condições avaliadas pelo LLM.

Add a workflow to my agent: greeting, classify intent, then branch to either answer from KB or escalate to human, then wrap up.

Adicione ferramentas

O ElevenAgents suporta três categorias de ferramentas, cada uma com uma função diferente. Ferramentas de cliente executam ações na interface, permitindo que o agente navegue, destaque ou atualize o que o usuário vê. Ferramentas webhook chamam APIs do seu servidor, permitindo que o agente leia ou escreva dados nos seus sistemas. Ferramentas nativas cobrem ações comuns da plataforma que você não precisa criar, como encerrar a chamada, detectar o idioma do usuário ou transferir para um atendente humano.

Add three tools to my agent: 
1. A client tool called show_help_article that takes an article_id. 
2. A webhook tool called get_weather hitting 
https://wttr.in/
{location}?format=j1. 
3. Enable the built-in end_call and language_detection tools.

Adicione regras de segurança

As regras de segurança funcionam de forma independente do LLM, ou seja, pegam situações que o prompt do sistema pode não cobrir. O ideal é configurá-las em platform_settings, e não só no prompt do sistema, mas para regras críticas, vale usar as duas opções. Inclua no prompt e também como regra personalizada independente. Assim, você tem uma camada extra de proteção: se o LLM fugir das instruções, o validador de respostas intercepta antes de chegar ao usuário.

Add guardrails to my agent. Enable focus and prompt injection protection. Add custom rules to block specific pricing claims, speculation about unreleased features, and any write access to billing systems.

Adicione testes

Antes de liberar seu agente para usuários reais, é importante garantir que ele funciona como esperado. O ElevenAgents oferece três tipos de testes, e normalmente você vai querer usar todos. Testes de resposta verificam se o agente fala o que deve, no tom certo. Testes de ferramentas checam se ele chama a ferramenta certa com os parâmetros corretos. Testes de simulação avaliam se o fluxo de várias interações se mantém mesmo quando a conversa foge do roteiro.

Add three tests to my agent: one that checks the greeting tone, one that checks it calls show_help_article when asked about password resets, and a simulation that checks if it defers to sales when asked about pricing.

Coloque no telefone

Até aqui, o agente funciona só no painel. Conectando a um número de telefone, o tráfego de voz passa por um provedor de telefonia, permitindo chamadas recebidas e feitas. Usuários podem ligar, seu agente pode retornar ligações, e o áudio é roteado pelo provedor. O ElevenAgents tem integrações nativas com Twilio, SIP trunk, Vonage, Telnyx, Plivo e Genesys, então não há servidor de mídia externo nem configuração manual de TwiML. Todo o fluxo — do modelo de voz ao LLM e ao provedor de telefonia — fica integrado em uma única plataforma.

A integração nativa com Twilio é a configuração mais rápida. Você importa um número do Twilio para o painel do ElevenAgents usando seu Account SID e Auth Token, e a plataforma configura automaticamente os webhooks de voz e o formato de áudio. Um detalhe importante: números comprados no Twilio aceitam chamadas recebidas e feitas. Números verificados como caller ID no Twilio aceitam apenas chamadas feitas.

Connect my Twilio account to ElevenAgents. Reserve a +1 number from Twilio's available pool, assign it my ElevenAgent via the native Twilio integration, and return the number to dial.

Dica: se você ainda não tem Twilio, o botão Falar com Agente no painel funciona direto no navegador. O número de telefone é para produção.

Agora você tem um agente de voz que não parece um robô.