Araçlar

LibreChat araçları Agent Builder içerisinden seçilir ve bir ajan bunları yararlı bulduğunda çalıştırılır. Bu bölüm; görsel oluşturma, arama, hava durumu, hesaplama ve özel dizin arama gibi yerleşik ajan araçlarını kapsar.

Web Search veya MCP ile aynı değil

Bu sayfadaki arama araçları, belirli bir asistana eklediğiniz araçlardır. LibreChat'in yerleşik Web Search özelliği ayrı olarak yapılandırılır ve özel üçüncü taraf araçlar genellikle MCP veya Actions aracılığıyla eklenir.

Hızlı Kurulum

Aracı Seçin

Aşağıdaki tablodan bir araç seçin ve gerekli API anahtarlarını, hizmet URL'lerini veya dizin adlarını toplayın.

Kimlik Bilgileri Ekle

Gerekli değerleri .env dosyanıza ekleyin veya araç bunları istediğinde kullanıcıların LibreChat arayüzünden kendi kimlik bilgilerini girmelerine izin verin.

LibreChat'i Yeniden Başlatın

Ortam değişkeni değişiklikleri yeniden başlatma sırasında yüklenir.

Dağıtım	Komut
Docker	`docker compose down && docker compose up -d`
Yerel	Sunucuyu durdurun, ardından tekrar `npm run backend` komutunu çalıştırın

Bir Araca Ajan Ekleme

LibreChat içinde Agents kısmını seçin, bir agent oluşturun veya düzenleyin, agent'ın Tools listesini açın, aracı seçin ve agent'ı kaydedin.

Sohbet İçinde Test Et

O ajanla bir sohbet başlatın ve arama, hesaplama, hava durumu raporu veya görsel gibi aracı gerektiren bir şey isteyin.

Mevcut Yerleşik Araçlar

Araç	Kullanım amacı	Gerekli yapılandırma	Detaylar
OpenAI Image Tools	OpenAI görüntü modelleriyle görüntü oluşturma ve düzenleme	`IMAGE_GEN_OAI_API_KEY`; isteğe bağlı `IMAGE_GEN_OAI_MODEL`	Görüntü Oluşturma
Gemini Image Tools	Gemini kullanarak görüntü oluşturma ve görüntü bağlamıyla düzenleme	`GEMINI_API_KEY`, `GOOGLE_KEY` veya `GOOGLE_SERVICE_KEY_FILE`; isteğe bağlı `GEMINI_IMAGE_MODEL`	Gemini Görüntü Oluşturma
DALL-E-3	Eski OpenAI görüntü oluşturma	`DALLE3_API_KEY` veya `DALLE_API_KEY`	DALL-E
Flux	Bulut tabanlı görüntü oluşturma ve ince ayarlı görüntü modelleri	`FLUX_API_KEY`; isteğe bağlı `FLUX_API_BASE_URL`	Flux
Stable Diffusion	Automatic1111 aracılığıyla yerel veya kendi kendine barındırılan görüntü oluşturma	`SD_WEBUI_URL`	Stable Diffusion
Google Search	Bir aracı için Google Özel Arama sonuçları	`GOOGLE_SEARCH_API_KEY` ve `GOOGLE_CSE_ID`	Google Search
Tavily Search	Aracılar için optimize edilmiş güncel web sonuçları	`TAVILY_API_KEY`	Tavily Search
Traversaal	Kaynaklarıyla birlikte yapay zeka arama sonuçları	`TRAVERSAAL_API_KEY`	Traversaal
Azure AI Search	Özel bir Azure AI Search dizininde arama yapma	`AZURE_AI_SEARCH_SERVICE_ENDPOINT`, `AZURE_AI_SEARCH_INDEX_NAME`, `AZURE_AI_SEARCH_API_KEY`	Azure AI Search
OpenWeather	Güncel, tahmin, geçmiş ve günlük hava durumu verileri	`OPENWEATHER_API_KEY`	OpenWeather
Wolfram\|Alpha	Matematik, hesaplama, birimler, derlenmiş bilgi ve gerçek zamanlı veriler	`WOLFRAM_APP_ID`	Wolfram\|Alpha
Calculator	Temel ve karmaşık hesaplamalar	Yok	Calculator

Özel Araçlar Oluşturma

Çoğu özel araç, LibreChat kaynak kodunu düzenlemeye gerek kalmadan eklenmelidir.

Bir ajanı yerel bir betiğe, dahili bir servise, veritabanına, tarayıcı otomasyon sunucusuna veya özel bir API sarmalayıcısına bağlamak istediğinizde MCP kullanın. Örneğin, bir DuckDuckGo arama aracı bir MCP sunucusu aracılığıyla dışa aktarılabilir ve ardından Ajan Oluşturucu'dan (Agent Builder) seçilebilir.
Aracı, bir OpenAPI şeması ile tanımlanabilen bir HTTP API olduğunda Actions kullanın.
LibreChat'in kaynak seviyesindeki yapılandırılmış araçlarını yalnızca LibreChat'in kendisini geliştirirken düzenleyin. Eski Tools and Plugins development guide katkıda bulunanlar için erişilebilir durumdadır, ancak dağıtımlar için önerilen genişletme yolları MCP ve Actions'tır.

Araç Kullanılabilirliği

Araçlar, LibreChat'in api/app/clients/tools/manifest.json dosyasındaki pluginKey değerleri ile dahili olarak tanımlanır.

Araçları gizlemek için filteredTools kullanın veya yalnızca belirli araçlara izin vermek için includedTools kullanın:

includedTools:
  - calculator
  - image_gen_oai
  - google

Yeniden başlatmanın ardından bir araç Agent Builder içinde görünmüyorsa, aracın ortam değişkenlerini, includedTools ve filteredTools ayarlarını ve ajanın tools yeteneğinin etkinleştirilip etkinleştirilmediğini kontrol edin.