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 a partir de él 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 fue exitosa, o quieres iniciar una refactorización y dejar que trabaje mientras conduces.

Hermes ya viene con soporte de Texto a Voz y Voz a Texto con ElevenLabs integrado, pero para que sea 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 otras cosas relacionadas con la voz.

OpenClaw maneja las herramientas, la memoria y las habilidades.

Los sistemas se comunican utilizando 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 se encuentra el tiempo de ejecución 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 de teléfono real

**

Configurando Hermes

Hermes expone un servidor API compatible con OpenAI a través de su gateway. Actívalo añadiendo 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_API_HERMES_ALEATORIA"
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 en ejecución. ElevenLabs llamará a Hermes a través de esta URL.

Configurando ElevenLabs

En el panel de Agentes 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.

Seleccionar LLM Personalizado en el Panel

1. Establece la URL del LLM Personalizado en 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.

Configurar usando el endpoint de Hermes

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

Configurar ElevenLabs usando tu Agente

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

Paso 1: Crear el secreto de ElevenLabs

1curl -X POST <https://api.elevenlabs.io/v1/convai/secrets> \\\\
2  -H "xi-api-key: TU_CLAVE_API_ELEVENLABS" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "type": "new",
6    "name": "hermes_gateway_token",
7    "value": "TU_CLAVE_API_HERMES_ALEATORIA"
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: Crear el Agente de ElevenLabs

1curl -X POST <https://api.elevenlabs.io/v1/convai/agents/create> \\\\
2  -H "xi-api-key: TU_CLAVE_API_ELEVENLABS" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "name": "Agente de Voz Hermes",
6    "conversation_config": {
7      "agent": {
8        "language": "en",
9        "first_message": "Hola, ¿cómo puedo ayudarte?",
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_SECRETO_DEVUELTO"
18            }
19          }
20        }
21      }
22    }
23  }'

Vinculando un Número de Teléfono

Aquí es donde se pone divertido.

Si estás usando Twilio:

1. Compra un número de teléfono.
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.

Añadir número de teléfono de Twilio

1. Vincula tu número de teléfono al agente de ElevenLabs.

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