Llama a tu agente Hermes por teléfono usando ElevenAgents

si copias este artículo a tu agente de codificación, puede realizar muchos pasos por ti

¿Qué pasaría si tu agente de codificación pudiera contestar el teléfono? Estás lejos de tu escritorio y quieres saber si la prueba de anoche salió en verde, o quieres iniciar una refactorización y dejar que avance mientras conduces.

Hermes ya viene con soporte de Texto a Voz y Voz a Texto con ElevenLabs integrado, pero para hacerlo verdaderamente conversacional, necesitas ElevenAgents.

Conecta los dos y Hermes puede contestar tus llamadas telefónicas.

**

La Arquitectura

Diagrama del Flujo del Agente

ElevenLabs Agents maneja los turnos de conversación, la síntesis y el reconocimiento de voz, la integración telefónica y otros aspectos relacionados con la voz.

OpenClaw maneja las herramientas, la memoria y las habilidades.

Los sistemas se comunican usando el protocolo estándar de Chat Completions compatible con OpenAI. ElevenLabs envía cada turno de conversación a Hermes a través de:

1POST /v1/chat/completions

Hermes responde como un LLM compatible con OpenAI, pero detrás de ese endpoint está el runtime completo del agente Hermes.

**

Requisitos Previos

• Una cuenta de ElevenLabs
• Un Agente Hermes configurado con un modelo/proveedor funcional
• ngrok instalado y autenticado
• Una cuenta de Twilio, u otra configuración de número telefónico compatible con ElevenLabs, si deseas conectar un número real

**

Configurando Hermes

Hermes expone un servidor API compatible con OpenAI a través de su gateway. Habilítalo agregando estos valores a ~/.hermes/.env:

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

Genera una clave API segura en lugar de usar el marcador de posición. Luego instala e inicia el gateway de Hermes:

1hermes gateway install
2hermes gateway start

Verifica el servidor API local:

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

Deberías ver algo como:

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

**

Exponiendo Hermes con ngrok

Inicia un túnel hacia el servidor API de Hermes:

1ngrok http 8642

ngrok te dará una URL HTTPS pública como:

1<https://tu-subdominio-ngrok.ngrok-free.app>

Mantén ngrok ejecutándose. ElevenLabs llamará a Hermes a través de esta URL.

Configurando ElevenLabs

En el panel de control del Agente de ElevenLabs:

1. Crea o abre un Agente de IA Conversacional de ElevenLabs.
2. Ve a la configuración de LLM.
3. Selecciona LLM Personalizado.

Selecciona LLM Personalizado en el Panel de Control

1. Establece la URL del LLM Personalizado a tu endpoint de ngrok https://tu-subdominio-ngrok.ngrok-free.app/v1

1. Configura la autenticación usando la clave del servidor API de Hermes.

Configura usando el endpoint de Hermes

Una vez configurado, ElevenLabs enrutará los turnos de conversación a Hermes. Hermes los procesará como mensajes regulares de agente, con acceso a las herramientas y habilidades que permita tu plataforma de gateway/servidor API.

Configura ElevenLabs usando tu Agente

En lugar de usar el panel de control, tu agente de codificación puede hacer estas solicitudes API por ti.

Paso 1: Crea el secreto de ElevenLabs

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

Esto devuelve una respuesta con un secret_id:

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

Paso 2: Crea el Agente de ElevenLabs

1curl -X POST <https://api.elevenlabs.io/v1/convai/agents/create> \\\\
2  -H "xi-api-key: TU_CLAVE_API_DE_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": "Eres el Agente Hermes hablando a través de ElevenLabs en una conversación de voz en vivo. Sé cálido, conversacional y conciso. Usa las herramientas de Hermes cuando sean claramente necesarias, luego resume los resultados de forma natural.",
13          "custom_llm": {
14            "url": "https://TU_URL_NGROK.ngrok-free.app/v1",
15            "api_type": "chat_completions",
16            "api_key": {
17              "secret_id": "ID_DEL_SECRETO_DEVUELTO"
18            }
19          }
20        }
21      }
22    }
23  }'

Vinculando un Número Telefónico

Aquí es donde se pone divertido.

Si estás usando Twilio:

1. Compra un número telefónico.
2. Copia tu SID de Cuenta de Twilio y tu Token de Autenticación.

En ElevenLabs:

1. Abre tu Agente de IA Conversacional.
2. Ve a la sección de Teléfono.
3. Conecta tu cuenta de Twilio, o usa otra opción de número telefónico compatible con tu cuenta de ElevenLabs.

Agrega número telefónico de Twilio

1. Vincula tu número telefónico al agente de ElevenLabs.

Eso es todo. Tu Agente Hermes ahora contesta el teléfono.