Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

Narzędzia

Skonfiguruj wbudowane narzędzia agenta w LibreChat

Narzędzia LibreChat są wybierane z poziomu Agent Builder i uruchamiane, gdy agent uzna je za przydatne. Ta sekcja obejmuje wbudowane narzędzia agenta, takie jak generowanie obrazów, wyszukiwanie, pogoda, obliczenia oraz przeszukiwanie prywatnego indeksu.

Nie to samo co Web Search lub MCP

Narzędzia wyszukiwania na tej stronie to narzędzia, które dodajesz do konkretnego agenta. Wbudowana funkcja Web Search w LibreChat jest konfigurowana oddzielnie, a niestandardowe narzędzia innych firm są zazwyczaj dodawane za pośrednictwem MCP lub Actions.

Szybka konfiguracja

Wybierz narzędzie

Wybierz narzędzie z poniższej tabeli i przygotuj wymagane klucze API, adresy URL usług lub nazwy indeksów.

Dodaj poświadczenia

Dodaj wymagane wartości do pliku .env lub pozwól użytkownikom na podanie własnych danych uwierzytelniających z poziomu interfejsu LibreChat, gdy narzędzie o nie poprosi.

Restart LibreChat

Zmiany zmiennych środowiskowych są wczytywane przy ponownym uruchomieniu.

WdrożeniePolecenie
Dockerdocker compose down && docker compose up -d
LokalneZatrzymaj serwer, a następnie ponownie uruchom npm run backend

Dodawanie narzędzia do Agenta

W LibreChat wybierz Agents, utwórz lub edytuj agenta, otwórz listę Tools agenta, wybierz narzędzie i zapisz agenta.

Test w czacie

Rozpocznij czat z tym agentem i poproś o coś, co wymaga użycia narzędzia, na przykład wyszukiwanie, obliczenia, prognozę pogody lub obraz.

Obecne wbudowane narzędzia

NarzędzieZastosowanieWymagana konfiguracjaSzczegóły
OpenAI Image ToolsGenerowanie i edycja obrazów za pomocą modeli obrazów OpenAIIMAGE_GEN_OAI_API_KEY; opcjonalnie IMAGE_GEN_OAI_MODELGenerowanie obrazów
Gemini Image ToolsGenerowanie obrazów i edycja z kontekstem obrazu przy użyciu GeminiGEMINI_API_KEY, GOOGLE_KEY lub GOOGLE_SERVICE_KEY_FILE; opcjonalnie GEMINI_IMAGE_MODELGenerowanie obrazów Gemini
DALL-E-3Starsza metoda generowania obrazów OpenAIDALLE3_API_KEY lub DALLE_API_KEYDALL-E
FluxChmurowe generowanie obrazów i dostrojone modele obrazówFLUX_API_KEY; opcjonalnie FLUX_API_BASE_URLFlux
Stable DiffusionLokalne lub samodzielnie hostowane generowanie obrazów przez Automatic1111SD_WEBUI_URLStable Diffusion
Google SearchWyniki wyszukiwania Google Custom Search dla agentaGOOGLE_SEARCH_API_KEY oraz GOOGLE_CSE_IDGoogle Search
Tavily SearchAktualne wyniki internetowe zoptymalizowane pod kątem agentówTAVILY_API_KEYTavily Search
TraversaalWyniki wyszukiwania AI ze źródłamiTRAVERSAAL_API_KEYTraversaal
Azure AI SearchPrzeszukiwanie prywatnego indeksu Azure AI SearchAZURE_AI_SEARCH_SERVICE_ENDPOINT, AZURE_AI_SEARCH_INDEX_NAME, AZURE_AI_SEARCH_API_KEYAzure AI Search
OpenWeatherBieżące, prognozowane, historyczne i dzienne dane pogodoweOPENWEATHER_API_KEYOpenWeather
Wolfram|AlphaMatematyka, obliczenia, jednostki, wyselekcjonowana wiedza i dane w czasie rzeczywistymWOLFRAM_APP_IDWolfram|Alpha
CalculatorPodstawowe i złożone obliczeniaBrakKalkulator

Tworzenie własnych narzędzi (Custom Tools)

Większość niestandardowych narzędzi powinna być dodawana bez edytowania kodu źródłowego LibreChat.

  • Użyj MCP, gdy chcesz połączyć agenta z lokalnym skryptem, usługą wewnętrzną, bazą danych, serwerem automatyzacji przeglądarki lub niestandardowym wrapperem API. Na przykład narzędzie wyszukiwania DuckDuckGo może zostać udostępnione przez serwer MCP, a następnie wybrane w kreatorze Agent Builder.
  • Użyj Actions, gdy narzędzie jest interfejsem API HTTP, który można opisać za pomocą schematu OpenAPI.
  • Edytuj narzędzia strukturalne na poziomie źródłowym LibreChat tylko wtedy, gdy rozwijasz samo LibreChat. Starszy przewodnik tworzenia narzędzi i wtyczek pozostaje dostępny dla współtwórców, ale MCP oraz Actions są zalecanymi ścieżkami rozszerzeń dla wdrożeń.

Dostępność narzędzi

Narzędzia są identyfikowane wewnętrznie za pomocą pluginKey z pliku api/app/clients/tools/manifest.json w LibreChat.

Użyj filteredTools, aby ukryć narzędzia, lub includedTools, aby zezwolić tylko na określone narzędzia:

includedTools:
  - calculator
  - image_gen_oai
  - google

Jeśli narzędzie nie jest widoczne w Agent Builder po restarcie, sprawdź zmienne środowiskowe narzędzia, includedTools, filteredTools oraz to, czy funkcja tools agenta jest włączona.

Jaka jest ta instrukcja?