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

ツール

LibreChatで組み込みエージェントツールを設定する

LibreChatのツールはAgent Builderから選択され、エージェントが有用であると判断した際に実行されます。このセクションでは、画像生成、検索、天気、計算、プライベートインデックス検索などの組み込みエージェントツールについて説明します。

Web SearchやMCPとは異なります

このページの検索ツールは、特定のAgentに追加するツールです。LibreChatの組み込みのWeb Search機能は個別に設定され、カスタムのサードパーティ製ツールは通常MCPまたはActionsを通じて追加されます。

クイックセットアップ

ツールを選択

以下の表からツールを選択し、必要なAPIキー、サービスURL、またはインデックス名を取得してください。

認証情報の追加

.env ファイルに必要な値を追加するか、ツールが要求した際にユーザーが LibreChat UI から独自の認証情報を入力できるようにします。

LibreChatを再起動する

環境変数の変更は、再起動時に読み込まれます。

デプロイコマンド
Dockerdocker compose down && docker compose up -d
ローカルサーバーを停止し、再度 npm run backend を実行します

エージェントにツールを追加する

LibreChatで、Agentsを選択し、エージェントを作成または編集して、エージェントのToolsリストを開き、ツールを選択して、エージェントを保存します。

チャットでテストする

そのエージェントとのチャットを開始し、検索、計算、天気予報、画像生成など、ツールを必要とするリクエストを行ってください。

現在の組み込みツール

ツール用途必要な設定詳細
OpenAI Image ToolsOpenAIの画像モデルを使用した画像の生成と編集IMAGE_GEN_OAI_API_KEY; オプションで IMAGE_GEN_OAI_MODEL画像生成
Gemini Image ToolsGeminiを使用した画像の生成と画像コンテキストを用いた編集GEMINI_API_KEY, GOOGLE_KEY, または GOOGLE_SERVICE_KEY_FILE; オプションで GEMINI_IMAGE_MODELGemini画像生成
DALL-E-3レガシーなOpenAI画像生成DALLE3_API_KEY または DALLE_API_KEYDALL-E
Fluxクラウド画像生成およびファインチューニングされた画像モデルFLUX_API_KEY; オプションで FLUX_API_BASE_URLFlux
Stable DiffusionAutomatic1111を通じたローカルまたはセルフホスト型の画像生成SD_WEBUI_URLStable Diffusion
Google Searchエージェント向けのGoogleカスタム検索結果GOOGLE_SEARCH_API_KEY および GOOGLE_CSE_IDGoogle Search
Tavily Searchエージェント向けに最適化された最新のWeb検索結果TAVILY_API_KEYTavily Search
Traversaalソース付きのAI検索結果TRAVERSAAL_API_KEYTraversaal
Azure AI SearchプライベートなAzure AI Searchインデックスの検索AZURE_AI_SEARCH_SERVICE_ENDPOINT, AZURE_AI_SEARCH_INDEX_NAME, AZURE_AI_SEARCH_API_KEYAzure AI Search
OpenWeather現在、予報、過去、および日次の気象データOPENWEATHER_API_KEYOpenWeather
Wolfram|Alpha数学、計算、単位、キュレーションされた知識、およびリアルタイムデータWOLFRAM_APP_IDWolfram|Alpha
Calculator基本的および複雑な計算なしCalculator

カスタムツールの作成

ほとんどのカスタムツールは、LibreChatのソースコードを編集することなく追加できます。

  • エージェントをローカルスクリプト、内部サービス、データベース、ブラウザ自動化サーバー、またはカスタムAPIラッパーに接続したい場合は、MCP を使用してください。例えば、DuckDuckGo検索ツールをMCPサーバー経由で公開し、それをAgent Builderから選択することができます。
  • ツールがOpenAPIスキーマで記述可能なHTTP APIである場合は、Actionsを使用してください。
  • LibreChatのソースレベルの構造化ツールを編集するのは、LibreChat自体を開発している場合に限定してください。レガシーなTools and Plugins development guideはコントリビューター向けに引き続き利用可能ですが、デプロイメントにおける推奨される拡張パスはMCPおよびActionsです。

ツール利用可能性

ツールは、LibreChatの api/app/clients/tools/manifest.json にある pluginKey によって内部的に識別されます。

filteredTools を使用してツールを非表示にするか、includedTools を使用して特定のツールのみを許可します：

includedTools:
  - calculator
  - image_gen_oai
  - google

再起動後にAgent Builderでツールが表示されない場合は、そのツールの環境変数、includedTools、filteredTools、およびエージェントのtools機能が有効になっているかどうかを確認してください。

このガイドはいかがでしたか？

GitHub で編集