Strumenti

Gli strumenti di LibreChat vengono selezionati dall'Agent Builder e vengono eseguiti quando un agente decide che sono utili. Questa sezione copre gli strumenti integrati per gli agenti, come la generazione di immagini, la ricerca, il meteo, il calcolo e la consultazione di indici privati.

Non è la stessa cosa di Web Search o MCP

Gli strumenti di ricerca in questa pagina sono strumenti che aggiungi a un agente specifico. La funzionalità di Web Search integrata di LibreChat viene configurata separatamente, mentre gli strumenti personalizzati di terze parti vengono solitamente aggiunti tramite MCP o Actions.

Configurazione rapida

Scegli lo strumento

Scegli uno strumento dalla tabella sottostante e raccogli le chiavi API, gli URL del servizio o i nomi degli indici richiesti.

Aggiungi credenziali

Aggiungi i valori richiesti al tuo file .env, oppure consenti agli utenti di fornire le proprie credenziali dall'interfaccia utente di LibreChat quando lo strumento le richiede.

Riavviare LibreChat

Le modifiche alle variabili d'ambiente vengono caricate al riavvio.

Deployment	Command
Docker	`docker compose down && docker compose up -d`
Locale	Arresta il server, quindi esegui nuovamente `npm run backend`

Aggiungi lo strumento a un Agent

In LibreChat, seleziona Agents, crea o modifica un agente, apri l'elenco Tools dell'agente, seleziona lo strumento e salva l'agente.

Test in Chat

Avvia una chat con quell'agente e chiedi qualcosa che richieda lo strumento, come una ricerca, un calcolo, un bollettino meteorologico o un'immagine.

Strumenti integrati attuali

Strumento	Utilizzalo per	Configurazione richiesta	Dettagli
OpenAI Image Tools	Generare e modificare immagini con i modelli di immagine OpenAI	`IMAGE_GEN_OAI_API_KEY`; opzionale `IMAGE_GEN_OAI_MODEL`	Generazione di immagini
Gemini Image Tools	Generare immagini e modificare con contesto immagine usando Gemini	`GEMINI_API_KEY`, `GOOGLE_KEY`, o `GOOGLE_SERVICE_KEY_FILE`; opzionale `GEMINI_IMAGE_MODEL`	Generazione di immagini Gemini
DALL-E-3	Generazione di immagini OpenAI legacy	`DALLE3_API_KEY` o `DALLE_API_KEY`	DALL-E
Flux	Generazione di immagini nel cloud e modelli di immagine ottimizzati	`FLUX_API_KEY`; opzionale `FLUX_API_BASE_URL`	Flux
Stable Diffusion	Generazione di immagini locale o self-hosted tramite Automatic1111	`SD_WEBUI_URL`	Stable Diffusion
Google Search	Risultati di Google Custom Search per un agente	`GOOGLE_SEARCH_API_KEY` e `GOOGLE_CSE_ID`	Google Search
Tavily Search	Risultati web attuali ottimizzati per gli agenti	`TAVILY_API_KEY`	Tavily Search
Traversaal	Risultati di ricerca AI con fonti	`TRAVERSAAL_API_KEY`	Traversaal
Azure AI Search	Cercare in un indice privato Azure AI Search	`AZURE_AI_SEARCH_SERVICE_ENDPOINT`, `AZURE_AI_SEARCH_INDEX_NAME`, `AZURE_AI_SEARCH_API_KEY`	Azure AI Search
OpenWeather	Dati meteo attuali, previsioni, storici e giornalieri	`OPENWEATHER_API_KEY`	OpenWeather
Wolfram\|Alpha	Matematica, calcoli, unità di misura, conoscenza curata e dati in tempo reale	`WOLFRAM_APP_ID`	Wolfram\|Alpha
Calculator	Calcoli di base e complessi	Nessuna	Calcolatrice

Creazione di Custom Tools

La maggior parte degli strumenti personalizzati dovrebbe essere aggiunta senza modificare il codice sorgente di LibreChat.

Usa MCP quando vuoi connettere un agente a uno script locale, un servizio interno, un database, un server di automazione del browser o un wrapper API personalizzato. Ad esempio, uno strumento di ricerca DuckDuckGo può essere esposto tramite un server MCP e quindi selezionato dall'Agent Builder.
Usa le Actions quando lo strumento è un'API HTTP che può essere descritta con uno schema OpenAPI.
Modifica gli strumenti strutturati a livello di codice sorgente di LibreChat solo quando stai sviluppando LibreChat stesso. La guida legacy Tools and Plugins development guide rimane disponibile per i collaboratori, ma MCP e Actions sono i percorsi di estensione consigliati per le implementazioni.

Disponibilità degli strumenti

I tool vengono identificati internamente tramite il loro pluginKey dal file api/app/clients/tools/manifest.json di LibreChat.

Usa filteredTools per nascondere strumenti, o includedTools per consentire solo strumenti specifici:

includedTools:
  - calculator
  - image_gen_oai
  - google

Se uno strumento non è visibile nel Agent Builder dopo il riavvio, controlla le variabili d'ambiente dello strumento, includedTools, filteredTools e se la funzionalità tools dell'agente è abilitata.

Strumenti

In questa pagina