Ferramentas

As ferramentas do LibreChat são selecionadas a partir do Agent Builder e executadas quando um agente decide que elas são úteis. Esta seção aborda as ferramentas integradas do agente, como geração de imagens, pesquisa, clima, computação e consulta de índice privado.

Não é o mesmo que Web Search ou MCP

As ferramentas de busca nesta página são ferramentas que você adiciona a um agente específico. O recurso de Web Search integrado do LibreChat é configurado separadamente, e ferramentas personalizadas de terceiros geralmente são adicionadas por meio de MCP ou Actions.

Configuração Rápida

Escolha a Tool

Escolha uma ferramenta da tabela abaixo e colete quaisquer chaves de API, URLs de serviço ou nomes de índice necessários.

Adicionar Credenciais

Adicione os valores necessários ao seu .env file, ou permita que os usuários forneçam suas próprias credenciais a partir da interface do LibreChat quando a ferramenta solicitar.

Reiniciar o LibreChat

As alterações nas variáveis de ambiente são carregadas ao reiniciar.

Deployment	Command
Docker	`docker compose down && docker compose up -d`
Local	Pare o servidor e, em seguida, execute `npm run backend` novamente

Adicionar a Ferramenta a um Agent

No LibreChat, selecione Agents, crie ou edite um agente, abra a lista de Tools do agente, selecione a ferramenta e salve o agente.

Testar no Chat

Inicie um chat com esse agente e peça algo que exija a ferramenta, como uma pesquisa, cálculo, previsão do tempo ou imagem.

Ferramentas Integradas Atuais

Ferramenta	Use para	Configuração necessária	Detalhes
OpenAI Image Tools	Gerar e editar imagens com modelos de imagem da OpenAI	`IMAGE_GEN_OAI_API_KEY`; opcional `IMAGE_GEN_OAI_MODEL`	Geração de Imagem
Gemini Image Tools	Gerar imagens e editar com contexto de imagem usando o Gemini	`GEMINI_API_KEY`, `GOOGLE_KEY` ou `GOOGLE_SERVICE_KEY_FILE`; opcional `GEMINI_IMAGE_MODEL`	Geração de Imagem Gemini
DALL-E-3	Geração de imagem legada da OpenAI	`DALLE3_API_KEY` ou `DALLE_API_KEY`	DALL-E
Flux	Geração de imagem na nuvem e modelos de imagem ajustados	`FLUX_API_KEY`; opcional `FLUX_API_BASE_URL`	Flux
Stable Diffusion	Geração de imagem local ou auto-hospedada via Automatic1111	`SD_WEBUI_URL`	Stable Diffusion
Google Search	Resultados do Google Custom Search para um agente	`GOOGLE_SEARCH_API_KEY` e `GOOGLE_CSE_ID`	Google Search
Tavily Search	Resultados da web atuais otimizados para agentes	`TAVILY_API_KEY`	Tavily Search
Traversaal	Resultados de busca de IA com fontes	`TRAVERSAAL_API_KEY`	Traversaal
Azure AI Search	Pesquisar um índice privado do Azure AI Search	`AZURE_AI_SEARCH_SERVICE_ENDPOINT`, `AZURE_AI_SEARCH_INDEX_NAME`, `AZURE_AI_SEARCH_API_KEY`	Azure AI Search
OpenWeather	Dados meteorológicos atuais, de previsão, históricos e diários	`OPENWEATHER_API_KEY`	OpenWeather
Wolfram\|Alpha	Matemática, computação, unidades, conhecimento curado e dados em tempo real	`WOLFRAM_APP_ID`	Wolfram\|Alpha
Calculator	Cálculos básicos e complexos	Nenhum	Calculator

Criando Ferramentas Personalizadas

A maioria das ferramentas personalizadas deve ser adicionada sem editar o código-fonte do LibreChat.

Use o MCP quando quiser conectar um agente a um script local, serviço interno, banco de dados, servidor de automação de navegador ou um wrapper de API personalizado. Por exemplo, uma ferramenta de busca do DuckDuckGo pode ser exposta através de um servidor MCP e, em seguida, selecionada no Agent Builder.
Use Actions quando a ferramenta for uma API HTTP que pode ser descrita com um esquema OpenAPI.
Edite as ferramentas estruturadas em nível de código-fonte do LibreChat apenas quando você estiver desenvolvendo o próprio LibreChat. O guia de desenvolvimento de Ferramentas e Plugins legado permanece disponível para colaboradores, mas MCP e Actions são os caminhos de extensão recomendados para implantações.

Disponibilidade de Ferramentas

As ferramentas são identificadas internamente pelo seu pluginKey a partir do arquivo api/app/clients/tools/manifest.json do LibreChat.

Use filteredTools para ocultar ferramentas, ou includedTools para permitir apenas ferramentas específicas:

includedTools:
  - calculator
  - image_gen_oai
  - google

Se uma ferramenta não estiver visível no Agent Builder após a reinicialização, verifique as variáveis de ambiente da ferramenta, includedTools, filteredTools e se a capacidade tools do agente está habilitada.

Ferramentas

Nesta página