Appelez votre agent Hermes par téléphone avec ElevenAgents

si vous copiez cet article dans votre agent de codage, il peut effectuer de nombreuses étapes à partir de celui-ci pour vous

Et si votre agent de codage pouvait décrocher le téléphone ? Vous êtes loin de votre bureau et vous voulez savoir si le test de la nuit dernière s'est bien passé, ou vous voulez lancer une refactorisation et le laisser travailler pendant que vous conduisez.

Hermes est déjà livré avec la synthèse vocale et la reconnaissance vocale via ElevenLabs intégré, mais pour le rendre véritablement conversationnel, vous avez besoin d'ElevenAgents.

Connectez les deux et Hermes peut répondre à vos appels téléphoniques.

**

L'Architecture

Diagramme du flux de l'agent

ElevenLabs Agents gère la prise de parole, la synthèse et la reconnaissance vocales, l'intégration téléphonique et d'autres aspects liés à la voix.

OpenClaw gère les outils, la mémoire et les compétences.

Les systèmes communiquent en utilisant le protocole standard Chat Completions compatible OpenAI. ElevenLabs envoie chaque tour de conversation à Hermes via :

1POST /v1/chat/completions

Hermes répond comme un LLM compatible OpenAI, mais derrière ce point de terminaison se trouve l'intégralité de l'environnement d'exécution de l'agent Hermes.

**

Prérequis

• Un compte ElevenLabs
• Un agent Hermes configuré avec un modèle/fournisseur fonctionnel
• ngrok installé et authentifié
• Un compte Twilio, ou une autre configuration de numéro de téléphone prise en charge par ElevenLabs, si vous souhaitez connecter un vrai numéro de téléphone

**

Configuration d'Hermes

Hermes expose un serveur API compatible OpenAI via sa passerelle. Activez-le en ajoutant ces valeurs à ~/.hermes/.env :

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

Générez une clé API forte au lieu d'utiliser l'espace réservé. Ensuite, installez et démarrez la passerelle Hermes :

1hermes gateway install
2hermes gateway start

Vérifiez le serveur API local :

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

Vous devriez voir quelque chose comme :

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

**

Exposer Hermes avec ngrok

Démarrez un tunnel vers le serveur API Hermes :

1ngrok http 8642

ngrok vous donnera une URL HTTPS publique comme :

1<https://votre-sous-domaine-ngrok.ngrok-free.app>

Laissez ngrok tourner. ElevenLabs appellera Hermes via cette URL.

Configuration d'ElevenLabs

Dans le tableau de bord de l'agent ElevenLabs :

1. Créez ou ouvrez un agent conversationnel IA ElevenLabs.
2. Allez dans les paramètres LLM.
3. Sélectionnez LLM personnalisé.

Sélectionnez LLM personnalisé dans le tableau de bord

1. Définissez l'URL du LLM personnalisé sur votre point de terminaison ngrok https://votre-sous-domaine-ngrok.ngrok-free.app/v1

1. Configurez l'authentification en utilisant la clé du serveur API Hermes.

Configurez en utilisant le point de terminaison Hermes

Une fois configuré, ElevenLabs acheminera les tours de conversation vers Hermes. Hermes les traitera comme des messages d'agent normaux, avec accès aux outils et compétences que votre plateforme de passerelle/serveur API autorise.

Configurez ElevenLabs en utilisant votre agent

Au lieu d'utiliser le tableau de bord, votre agent de codage peut effectuer ces requêtes API pour vous.

Étape 1 : Créez le secret ElevenLabs

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

Cela renvoie une réponse avec un secret_id :

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

Étape 2 : Créez l'agent ElevenLabs

1curl -X POST <https://api.elevenlabs.io/v1/convai/agents/create> \\\\
2  -H "xi-api-key: VOTRE_CLE_API_ELEVENLABS" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "name": "Agent Vocal Hermes",
6    "conversation_config": {
7      "agent": {
8        "language": "en",
9        "first_message": "Bonjour, comment puis-je vous aider ?",
10        "prompt": {
11          "llm": "custom-llm",
12          "prompt": "Vous êtes l'agent Hermes parlant via ElevenLabs dans une conversation vocale en direct. Soyez chaleureux, conversationnel et concis. Utilisez les outils Hermes lorsqu'ils sont clairement nécessaires, puis résumez les résultats naturellement.",
13          "custom_llm": {
14            "url": "https://VOTRE_URL_NGROK.ngrok-free.app/v1",
15            "api_type": "chat_completions",
16            "api_key": {
17              "secret_id": "ID_SECRET_RETOURNÉ"
18            }
19          }
20        }
21      }
22    }
23  }'

Attribution d'un numéro de téléphone

C'est là que ça devient amusant.

Si vous utilisez Twilio :

1. Achetez un numéro de téléphone.
2. Copiez votre SID de compte Twilio et votre jeton d'authentification.

Dans ElevenLabs :

1. Ouvrez votre agent conversationnel IA.
2. Allez dans la section Téléphone.
3. Connectez votre compte Twilio, ou utilisez une autre option de numéro de téléphone prise en charge par votre compte ElevenLabs.

Ajoutez un numéro de téléphone Twilio

1. Attachez votre numéro de téléphone à l'agent ElevenLabs.

Et voilà. Votre agent Hermes répond désormais au téléphone.