Outils

Les outils LibreChat sont sélectionnés depuis l'Agent Builder et sont exécutés lorsqu'un agent décide qu'ils sont utiles. Cette section couvre les outils d'agent intégrés tels que la génération d'images, la recherche, la météo, le calcul et la consultation d'index privés.

Pas la même chose que Web Search ou MCP

Les outils de recherche sur cette page sont des outils que vous ajoutez à un agent spécifique. La fonctionnalité de Web Search intégrée à LibreChat est configurée séparément, et les outils tiers personnalisés sont généralement ajoutés via MCP ou Actions.

Configuration rapide

Choisir l'outil

Choisissez un outil dans le tableau ci-dessous et rassemblez toutes les clés API, URL de service ou noms d'index requis.

Ajouter des identifiants

Ajoutez les valeurs requises à votre fichier .env, ou laissez les utilisateurs fournir leurs propres identifiants depuis l'interface utilisateur de LibreChat lorsque l'outil les leur demande.

Redémarrer LibreChat

Les changements de variables d'environnement sont chargés au redémarrage.

Déploiement	Commande
Docker	`docker compose down && docker compose up -d`
Local	Arrêtez le serveur, puis exécutez à nouveau `npm run backend`

Ajouter l'outil à un Agent

Dans LibreChat, sélectionnez Agents, créez ou modifiez un agent, ouvrez la liste Tools de l'agent, sélectionnez l'outil et enregistrez l'agent.

Tester dans le chat

Démarrez une discussion avec cet agent et demandez-lui quelque chose qui nécessite l'outil, comme une recherche, un calcul, un bulletin météo ou une image.

Outils intégrés actuels

Outil	Utilisation	Configuration requise	Détails
OpenAI Image Tools	Générer et modifier des images avec les modèles d'image OpenAI	`IMAGE_GEN_OAI_API_KEY` ; `IMAGE_GEN_OAI_MODEL` optionnel	Génération d'images
Gemini Image Tools	Générer des images et les modifier avec le contexte d'image en utilisant Gemini	`GEMINI_API_KEY`, `GOOGLE_KEY` ou `GOOGLE_SERVICE_KEY_FILE` ; `GEMINI_IMAGE_MODEL` optionnel	Génération d'images Gemini
DALL-E-3	Génération d'images OpenAI héritée	`DALLE3_API_KEY` ou `DALLE_API_KEY`	DALL-E
Flux	Génération d'images dans le cloud et modèles d'image affinés	`FLUX_API_KEY` ; `FLUX_API_BASE_URL` optionnel	Flux
Stable Diffusion	Génération d'images locale ou auto-hébergée via Automatic1111	`SD_WEBUI_URL`	Stable Diffusion
Google Search	Résultats de recherche personnalisée Google pour un agent	`GOOGLE_SEARCH_API_KEY` et `GOOGLE_CSE_ID`	Google Search
Tavily Search	Résultats web actuels optimisés pour les agents	`TAVILY_API_KEY`	Tavily Search
Traversaal	Résultats de recherche IA avec sources	`TRAVERSAAL_API_KEY`	Traversaal
Azure AI Search	Rechercher dans un index Azure AI Search privé	`AZURE_AI_SEARCH_SERVICE_ENDPOINT`, `AZURE_AI_SEARCH_INDEX_NAME`, `AZURE_AI_SEARCH_API_KEY`	Azure AI Search
OpenWeather	Données météorologiques actuelles, prévisions, historiques et quotidiennes	`OPENWEATHER_API_KEY`	OpenWeather
Wolfram\|Alpha	Mathématiques, calculs, unités, connaissances organisées et données en temps réel	`WOLFRAM_APP_ID`	Wolfram\|Alpha
Calculator	Calculs basiques et complexes	Aucun	Calculatrice

Création d'outils personnalisés

La plupart des outils personnalisés devraient être ajoutés sans modifier le code source de LibreChat.

Utilisez MCP lorsque vous souhaitez connecter un agent à un script local, un service interne, une base de données, un serveur d'automatisation de navigateur ou un wrapper d'API personnalisé. Par exemple, un outil de recherche DuckDuckGo peut être exposé via un serveur MCP, puis sélectionné depuis l'Agent Builder.
Utilisez les Actions lorsque l'outil est une API HTTP qui peut être décrite avec un schéma OpenAPI.
Modifiez les outils structurés au niveau du code source de LibreChat uniquement lorsque vous développez LibreChat lui-même. Le guide de développement des Tools and Plugins hérité reste disponible pour les contributeurs, mais MCP et les Actions sont les voies d'extension recommandées pour les déploiements.

Disponibilité des outils

Les outils sont identifiés en interne par leur pluginKey provenant du fichier api/app/clients/tools/manifest.json de LibreChat.

Utilisez filteredTools pour masquer des outils, ou includedTools pour n'autoriser que des outils spécifiques :

includedTools:
  - calculator
  - image_gen_oai
  - google

Si un outil n'est pas visible dans l'Agent Builder après un redémarrage, vérifiez les variables d'environnement de l'outil, includedTools, filteredTools, et si la capacité tools de l'agent est activée.