Ligue para o seu agente Hermes usando o ElevenAgents

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

E se 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 a ElevenLabs integrada, mas para torná-lo verdadeiramente conversacional, você precisa do ElevenAgents.

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

**

A Arquitetura

Diagrama do Fluxo do Agente

Os ElevenLabs Agents cuidam da 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 na 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 suportada pela 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 de seu gateway. Habilite-o adicionando estes valores ao ~/.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 espaço reservado. 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 Agente ElevenLabs:

1. Crie ou abra um Agente de IA Conversacional da 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 para seu endpoint ngrok https://seu-subdominio-ngrok.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 de 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: SUA_CHAVE_DA_API_ELEVENLABS" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "type": "new",
6    "name": "hermes_gateway_token",
7    "value": "SUA_CHAVE_ALEATORIA_DO_SERVIDOR_DE_API_HERMES"
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: SUA_CHAVE_DA_API_ELEVENLABS" \\\\
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": "Você é o Agente Hermes falando através do ElevenLabs em uma conversa de voz ao vivo. Seja caloroso, conversacional e conciso. Use as ferramentas Hermes quando claramente necessário, depois resuma os resultados naturalmente.",
13          "custom_llm": {
14            "url": "https://SEU_URL_NGROK.ngrok-free.app/v1",
15            "api_type": "chat_completions",
16            "api_key": {
17              "secret_id": "SECRET_ID_RETORNADO"
18            }
19          }
20        }
21      }
22    }
23  }'

Vinculando um Número de Telefone

É aqui que a coisa fica divertida.

Se você estiver usando Twilio:

1. Compre um número de telefone.
2. Copie o SID da sua Conta Twilio e o 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 suportada pela 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.