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żenie | Polecenie |
|---|---|
| Docker | docker compose down && docker compose up -d |
| Lokalne | Zatrzymaj 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ędzie | Zastosowanie | Wymagana konfiguracja | Szczegóły |
|---|---|---|---|
| OpenAI Image Tools | Generowanie i edycja obrazów za pomocą modeli obrazów OpenAI | IMAGE_GEN_OAI_API_KEY; opcjonalnie IMAGE_GEN_OAI_MODEL | Generowanie obrazów |
| Gemini Image Tools | Generowanie obrazów i edycja z kontekstem obrazu przy użyciu Gemini | GEMINI_API_KEY, GOOGLE_KEY lub GOOGLE_SERVICE_KEY_FILE; opcjonalnie GEMINI_IMAGE_MODEL | Generowanie obrazów Gemini |
| DALL-E-3 | Starsza metoda generowania obrazów OpenAI | DALLE3_API_KEY lub DALLE_API_KEY | DALL-E |
| Flux | Chmurowe generowanie obrazów i dostrojone modele obrazów | FLUX_API_KEY; opcjonalnie FLUX_API_BASE_URL | Flux |
| Stable Diffusion | Lokalne lub samodzielnie hostowane generowanie obrazów przez Automatic1111 | SD_WEBUI_URL | Stable Diffusion |
| Google Search | Wyniki wyszukiwania Google Custom Search dla agenta | GOOGLE_SEARCH_API_KEY oraz GOOGLE_CSE_ID | Google Search |
| Tavily Search | Aktualne wyniki internetowe zoptymalizowane pod kątem agentów | TAVILY_API_KEY | Tavily Search |
| Traversaal | Wyniki wyszukiwania AI ze źródłami | TRAVERSAAL_API_KEY | Traversaal |
| Azure AI Search | Przeszukiwanie prywatnego indeksu Azure AI Search | AZURE_AI_SEARCH_SERVICE_ENDPOINT, AZURE_AI_SEARCH_INDEX_NAME, AZURE_AI_SEARCH_API_KEY | Azure AI Search |
| OpenWeather | Bieżące, prognozowane, historyczne i dzienne dane pogodowe | OPENWEATHER_API_KEY | OpenWeather |
| Wolfram|Alpha | Matematyka, obliczenia, jednostki, wyselekcjonowana wiedza i dane w czasie rzeczywistym | WOLFRAM_APP_ID | Wolfram|Alpha |
| Calculator | Podstawowe i złożone obliczenia | Brak | Kalkulator |
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
- googleJeś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?