LibreChatFerramentas
Configure ferramentas de agente integradas no LibreChat
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
- googleSe 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.
Como estĆ” este guia?