Passer au contenu principal
Donnez à vos agents vocaux et conversationnels ElevenAgents un contexte propre issu du web en direct, en utilisant Firecrawl pour la recherche et l’extraction. Ce guide couvre deux approches d’intégration :
  1. serveur MCP — connectez le serveur MCP Firecrawl hébergé pour une configuration sans code.
  2. outil webhook côté serveur — faites pointer un outil personnalisé vers l’API REST de Firecrawl pour un contrôle total sur les requêtes.

​
Prérequis

​
Option 1 : serveur MCP Firecrawl

Le moyen le plus rapide de donner à un agent l’accès au web. ElevenAgents prend en charge les serveurs MCP distants, et Firecrawl fournit un point de terminaison MCP hébergé.

​
Ajouter le serveur MCP

  1. Ouvrez la page Integrations dans ElevenLabs et cliquez sur Add Custom MCP Server. La première fois qu’un membre de votre espace de travail ajoute un serveur MCP, ElevenLabs vous demande d’accepter ses conditions d’utilisation des serveurs MCP, ce qui active MCP pour l’ensemble de l’espace de travail.
  2. Renseignez les champs suivants :
Le MCP sans clé expose exactement recherche, extraction et Parse, avec des limites partagées. Connectez-vous ou ajoutez une clé API pour accéder à un ensemble d’outils plus étendu. Conservez les clés API dans une variable d’environnement ou un magasin de secrets, jamais dans une URL.
Vous devez sélectionner Streamable HTTP comme type de serveur. L’option SSE par défaut ne fonctionne pas avec le point de terminaison MCP de Firecrawl.
  1. Dans Tool Approval Mode, choisissez un niveau d’approbation :
    • No Approval — l’agent utilise les outils librement. Convient pour l’extraction en lecture seule.
    • Fine-Grained Tool Approval — permet de présélectionner les outils qui peuvent s’exécuter automatiquement et ceux qui nécessitent une approbation.
    • Always Ask (par défaut) — l’agent demande une autorisation avant chaque appel d’outil.
  2. Cliquez sur Add Integration. ElevenLabs enregistre le serveur et teste la connexion.
ElevenLabs se connectera au serveur sans clé et affichera recherche, extraction et Parse. Si un Secret Token est défini, elle affiche l’ensemble d’outils complet de Firecrawl MCP.

​
L’associer à un agent

  1. Créez ou ouvrez un agent dans le tableau de bord ElevenAgents.
  2. Accédez à l’onglet Tools, puis sélectionnez le sous-onglet MCP.
  3. Cliquez sur Add server et sélectionnez l’intégration Firecrawl dans le menu déroulant.

​
Mettez à jour le prompt système

Dans l’onglet Agent, ajoutez des instructions au prompt système afin que l’agent sache quand utiliser Firecrawl. Par exemple :

​
Testez-le

Cliquez sur Preview dans la barre de navigation supérieure. Vous pouvez le tester via le champ de chat textuel ou en lançant un appel vocal. Essayez avec un prompt comme :
“Que fait firecrawl.dev ? Va sur le site et résume-le-moi.”
L’agent appellera l’outil MCP Firecrawl firecrawl_scrape, récupérera le markdown de la page et répondra avec un résumé.

​
Option 2 : Outil Webhook côté serveur

Utilisez cette approche lorsque vous avez besoin d’une maîtrise précise des paramètres de requête (formats, en-têtes, délais d’expiration, etc.) ou que vous souhaitez appeler un point de terminaison Firecrawl spécifique sans exposer l’ensemble des outils MCP.

​
Outil de scraping

Créez un outil qui scrape une seule URL et renvoie son contenu au format markdown.
  1. Ouvrez votre agent, puis accédez à l’onglet Tools.
  2. Cliquez sur Add tool, puis sélectionnez Webhook.
  3. Configurez l’outil :
Le champ Method est défini sur GET par défaut — veillez à le remplacer par POST.
  1. Faites défiler jusqu’à la section Headers, puis cliquez sur Add header pour configurer l’authentification :
Sinon, si des connexions d’authentification de l’espace de travail sont configurées, vous pouvez utiliser le menu déroulant Authentication à la place.
  1. Ajoutez des paramètres du corps :
  1. Cliquez sur Add tool.
L’API Firecrawl renvoie par défaut le contenu de la page au format markdown. L’agent reçoit la réponse JSON et peut utiliser le champ markdown pour répondre aux questions.

​
Outil de recherche

Créez un outil qui effectue une recherche sur le web et renvoie le titre, l’URL et la description de chaque résultat.
  1. Cliquez à nouveau sur Add tool → Webhook et configurez :
  1. Ajoutez le même en-tête Authorization que ci-dessus.
  2. Ajoutez des paramètres du corps :
  1. Cliquez sur Add tool.

​
Mettre à jour le prompt système

Dans l’onglet Agent, mettez à jour le prompt système :

​
Essayez-le

Cliquez sur Preview et essayez de demander :
“Recherchez les dernières fonctionnalités de Next.js et faites-m’en un résumé.”
L’agent appellera search_web, recevra les résultats de Firecrawl et répondra par un résumé des informations trouvées.

​
Conseils

  • Choix du modèle : Pour des appels d’outils fiables, utilisez un modèle performant comme GPT-4o, Claude Sonnet 5 ou Gemini 2.5 Flash. Les modèles plus petits peuvent avoir du mal à extraire les bons paramètres.
  • Gardez des prompts précis : Indiquez à l’agent exactement quand utiliser chaque outil. Des instructions vagues entraînent des appels d’outils manqués ou erronés.
  • Limitez la taille des réponses : Pour les agents vocaux, de longues pages extraites peuvent saturer le contexte du LLM. Par défaut, l’extraction ne renvoie déjà que le contenu principal (onlyMainContent: true) ; demandez donc également à l’agent de résumer de façon très concise pour garder des réponses courtes.
  • Sons d’appel d’outil : Dans les paramètres de l’outil webhook ou MCP, vous pouvez configurer un son d’appel d’outil pour diffuser un son d’ambiance pendant l’exécution d’un outil. Cela indique à l’utilisateur que l’agent est en train de travailler.

​
Ressources