Intégration ElevenLabs
En bref
Voie recommandée aujourd'hui : Server Tool (webhook) → REST. Le MCP distant ne supporte pas encore Streamable HTTP/SSE requis par ElevenLabs.
Prérequis
- Compte ElevenLabs avec Agents
- Clé API AskMarcel (ak_live_)
- Agent vocal configuré dans ElevenLabs
Pourquoi REST et pas MCP ?
ElevenLabs exige un serveur MCP SSE ou Streamable HTTP. Notre endpoint MCP renvoie 405 sur GET + Accept: text/event-stream. La voie webhook tool → REST est garantie et testée.
MCP en préparation
Le support Streamable HTTP est planifié. Cette page sera mise à jour quand le transport SSE sera disponible.
Configurer un Server Tool
- 1
Ouvrir votre agent ElevenLabs
Agents → votre agent → Tools → Add tool → Webhook.
- 2
URL et méthode
POST https://api.askmarcel.app/v1/diagnostic
- 3
Headers
Authorization: Bearer VOTRE_CLE_AK_LIVE et Content-Type: application/json.
- 4
Paramètres
Définissez brand (string), model (string), error_code (string) comme paramètres que l'agent peut extraire de la conversation.
Body template{ "brand": "{{brand}}", "model": "{{model}}", "error_code": "{{error_code}}" } - 5
Prompt système
Indiquez à l'agent de toujours citer la source (manuel, page) retournée par l'API avant de donner une procédure.
Traiter la réponse
Mappez steps[] pour la lecture vocale et source.page pour la traçabilité. confidence.level = low → demandez confirmation au technicien.
Vérifier que ça marche
Testez l'agent avec « J'ai un code E7 sur un Mitsubishi Ecodan ». L'agent doit appeler le tool et lire les étapes.
curl -s https://api.askmarcel.app/v1/diagnostic \
-H "Authorization: Bearer ak_live_..." \
-H "Content-Type: application/json" \
-d '{"brand":"Mitsubishi","model":"Ecodan PUHZ-W85","error_code":"E7"}'Limites connues
- MCP natif ElevenLabs non supporté aujourd'hui (pas de SSE)
- Latence vocale : prévoyez un message d'attente pendant l'appel API (~200-500 ms warm)
- Tier Developer interdit en production
Vidéo en cours de tournage
Prévenez-moi