Herramientas

Las herramientas de LibreChat se seleccionan desde el Agent Builder y se ejecutan cuando un agente decide que son útiles. Esta sección cubre las herramientas integradas del agente, tales como generación de imágenes, búsqueda, clima, cálculo y búsqueda en índices privados.

No es lo mismo que Web Search o MCP

Las herramientas de búsqueda en esta página son herramientas que añades a un agente específico. La función de Web Search integrada de LibreChat se configura por separado, y las herramientas personalizadas de terceros generalmente se añaden a través de MCP o Actions.

Configuración rápida

Elegir la herramienta

Elija una herramienta de la tabla a continuación y recopile las claves de API, las URLs de servicio o los nombres de índice requeridos.

Agregar credenciales

Agregue los valores requeridos a su archivo .env, o permita que los usuarios proporcionen sus propias credenciales desde la interfaz de usuario de LibreChat cuando la herramienta se las solicite.

Reiniciar LibreChat

Los cambios en las variables de entorno se cargan al reiniciar.

Despliegue	Comando
Docker	`docker compose down && docker compose up -d`
Local	Detenga el servidor, luego ejecute `npm run backend` de nuevo

Agregar la herramienta a un Agent

En LibreChat, selecciona Agents, crea o edita un agente, abre la lista de Tools del agente, selecciona la herramienta y guarda el agente.

Probar en el chat

Inicia un chat con ese agente y pídele algo que requiera la herramienta, como una búsqueda, un cálculo, un informe meteorológico o una imagen.

Herramientas integradas actuales

Herramienta	Úsala para	Configuración requerida	Detalles
OpenAI Image Tools	Generar y editar imágenes con modelos de imagen de OpenAI	`IMAGE_GEN_OAI_API_KEY`; opcional `IMAGE_GEN_OAI_MODEL`	Generación de imágenes
Gemini Image Tools	Generar imágenes y editar con contexto de imagen usando Gemini	`GEMINI_API_KEY`, `GOOGLE_KEY`, o `GOOGLE_SERVICE_KEY_FILE`; opcional `GEMINI_IMAGE_MODEL`	Generación de imágenes con Gemini
DALL-E-3	Generación de imágenes heredada de OpenAI	`DALLE3_API_KEY` o `DALLE_API_KEY`	DALL-E
Flux	Generación de imágenes en la nube y modelos de imagen ajustados	`FLUX_API_KEY`; opcional `FLUX_API_BASE_URL`	Flux
Stable Diffusion	Generación de imágenes local o autohospedada a través de Automatic1111	`SD_WEBUI_URL`	Stable Diffusion
Google Search	Resultados de Google Custom Search para un agente	`GOOGLE_SEARCH_API_KEY` y `GOOGLE_CSE_ID`	Google Search
Tavily Search	Resultados web actuales optimizados para agentes	`TAVILY_API_KEY`	Tavily Search
Traversaal	Resultados de búsqueda de IA con fuentes	`TRAVERSAAL_API_KEY`	Traversaal
Azure AI Search	Buscar en un índice privado de Azure AI Search	`AZURE_AI_SEARCH_SERVICE_ENDPOINT`, `AZURE_AI_SEARCH_INDEX_NAME`, `AZURE_AI_SEARCH_API_KEY`	Azure AI Search
OpenWeather	Datos meteorológicos actuales, de pronóstico, históricos y diarios	`OPENWEATHER_API_KEY`	OpenWeather
Wolfram\|Alpha	Matemáticas, computación, unidades, conocimiento curado y datos en tiempo real	`WOLFRAM_APP_ID`	Wolfram\|Alpha
Calculator	Cálculos básicos y complejos	Ninguna	Calculadora

Creación de herramientas personalizadas

La mayoría de las herramientas personalizadas deben añadirse sin editar el código fuente de LibreChat.

Utilice MCP cuando desee conectar un agente a un script local, servicio interno, base de datos, servidor de automatización de navegador o un wrapper de API personalizado. Por ejemplo, una herramienta de búsqueda de DuckDuckGo puede exponerse a través de un servidor MCP y luego seleccionarse desde el Agent Builder.
Utilice Actions cuando la herramienta sea una API HTTP que pueda describirse con un esquema OpenAPI.
Edite las herramientas estructuradas a nivel de código fuente de LibreChat solo cuando esté desarrollando el propio LibreChat. La guía de desarrollo de herramientas y plugins heredada sigue estando disponible para los colaboradores, pero MCP y Actions son las rutas de extensión recomendadas para las implementaciones.

Disponibilidad de herramientas

Las herramientas se identifican internamente mediante su pluginKey desde el archivo api/app/clients/tools/manifest.json de LibreChat.

Utilice filteredTools para ocultar herramientas, o includedTools para permitir solo herramientas específicas:

includedTools:
  - calculator
  - image_gen_oai
  - google

Si una herramienta no es visible en el Agent Builder después de reiniciar, verifica las variables de entorno de la herramienta, includedTools, filteredTools y si la capacidad tools del agente está habilitada.