Ligue para o seu agente Hermes por telefone usando o ElevenAgents

se você copiar este artigo para o seu agente de codificação, ele poderá executar muitas etapas a partir dele para você

E se o seu agente de codificação pudesse atender o telefone? Você está longe da sua mesa e quer saber se o teste da noite passada foi bem-sucedido ou quer iniciar uma refatoração e deixá-la rodando enquanto dirige.

O Hermes já vem com suporte a Texto para Fala e Fala para Texto com ElevenLabs integrado, mas para torná-lo verdadeiramente conversacional, você precisa do ElevenAgents.

Conecte os dois e o Hermes poderá atender suas chamadas telefônicas.

**

A Arquitetura

Diagrama do Fluxo do Agente

Os ElevenLabs Agents gerenciam a alternância de turnos, síntese e reconhecimento de fala, integração telefônica e outros aspectos relacionados à voz.

O OpenClaw gerencia ferramentas, memória e habilidades.

Os sistemas se comunicam usando o protocolo padrão Chat Completions compatível com OpenAI. O ElevenLabs envia cada turno de conversa para o Hermes através de:

1POST /v1/chat/completions

O Hermes responde como um LLM compatível com OpenAI, mas por trás desse endpoint está o runtime completo do agente Hermes.

**

Pré-requisitos

• Uma conta ElevenLabs
• Um Agente Hermes configurado com um modelo/provedor funcional
• ngrok instalado e autenticado
• Uma conta Twilio, ou outra configuração de número de telefone compatível com ElevenLabs, se quiser conectar um número de telefone real

**

Configurando o Hermes

O Hermes expõe um servidor de API compatível com OpenAI através do seu gateway. Ative-o adicionando estes valores ao arquivo ~/.hermes/.env:

1API_SERVER_ENABLED="true"
2API_SERVER_HOST="127.0.0.1"
3API_SERVER_PORT="8642"
4API_SERVER_KEY="YOUR_RANDOM_HERMES_API_SERVER_KEY"
5API_SERVER_MODEL_NAME="hermes-agent"

Gere uma chave de API forte em vez de usar o placeholder. Em seguida, instale e inicie o gateway Hermes:

1hermes gateway install
2hermes gateway start

Verifique o servidor de API local:

1curl -sS <http://127.0.0.1:8642/health>

Você deve ver algo como:

1{"status": "ok", "platform": "hermes-agent"}

**

Expondo o Hermes com ngrok

Inicie um túnel para o servidor de API do Hermes:

1ngrok http 8642

O ngrok fornecerá uma URL HTTPS pública como:

1<https://your-ngrok-subdomain.ngrok-free.app>

Mantenha o ngrok em execução. O ElevenLabs chamará o Hermes através desta URL.

Configurando o ElevenLabs

No painel do ElevenLabs Agent:

1. Crie ou abra um Agente de IA Conversacional do ElevenLabs.
2. Vá para as configurações de LLM.
3. Selecione LLM Personalizado.

Selecione LLM Personalizado no Painel

1. Defina a URL do LLM Personalizado como seu endpoint ngrok https://your-ngrok-subdomain.ngrok-free.app/v1

1. Configure a autenticação usando a chave do servidor de API do Hermes.

Configure usando o endpoint Hermes

Uma vez configurado, o ElevenLabs roteará os turnos de conversa para o Hermes. O Hermes os processará como mensagens regulares do agente, com acesso a quaisquer ferramentas e habilidades que sua plataforma de gateway/servidor de API permitir.

Configure o ElevenLabs usando seu Agente

Em vez de usar o painel, seu agente de codificação pode fazer essas requisições de API para você.

Passo 1: Crie o segredo do ElevenLabs

1curl -X POST <https://api.elevenlabs.io/v1/convai/secrets> \\\\
2  -H "xi-api-key: YOUR_ELEVENLABS_API_KEY" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "type": "new",
6    "name": "hermes_gateway_token",
7    "value": "YOUR_RANDOM_HERMES_API_SERVER_KEY"
8  }'

Isso retorna uma resposta com um secret_id:

1{
2  "type": "stored",
3  "secret_id": "abc123...",
4  "name": "hermes_gateway_token"
5}

Passo 2: Crie o Agente ElevenLabs

1curl -X POST <https://api.elevenlabs.io/v1/convai/agents/create> \\\\
2  -H "xi-api-key: YOUR_ELEVENLABS_API_KEY" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "name": "Hermes Voice Agent",
6    "conversation_config": {
7      "agent": {
8        "language": "en",
9        "first_message": "Hello, how can I help?",
10        "prompt": {
11          "llm": "custom-llm",
12          "prompt": "You are Hermes Agent speaking through ElevenLabs in a live voice conversation. Be warm, conversational, and concise. Use Hermes tools when they are clearly needed, then summarize results naturally.",
13          "custom_llm": {
14            "url": "https://YOUR_NGROK_URL.ngrok-free.app/v1",
15            "api_type": "chat_completions",
16            "api_key": {
17              "secret_id": "RETURNED_SECRET_ID"
18            }
19          }
20        }
21      }
22    }
23  }'

Vinculando um Número de Telefone

É aqui que a coisa fica divertida.

Se você estiver usando o Twilio:

1. Compre um número de telefone.
2. Copie seu Twilio Account SID e Auth Token.

No ElevenLabs:

1. Abra seu Agente de IA Conversacional.
2. Vá para a seção Telefone.
3. Conecte sua conta Twilio ou use outra opção de número de telefone compatível com sua conta ElevenLabs.

Adicione número de telefone Twilio

1. Vincule seu número de telefone ao agente ElevenLabs.

Pronto. Seu Agente Hermes agora atende o telefone.