工具 | LibreChat

LibreChat 工具在 Agent Builder 中进行选择，并在 Agent 认为有用时运行。本节涵盖了内置的 Agent 工具，例如图像生成、搜索、天气、计算和私有索引查找。

与 Web Search 或 MCP 不同

此页面上的搜索工具是您添加到特定 Agent 的工具。LibreChat 内置的 Web Search 功能是单独配置的，而自定义的第三方工具通常通过 MCP 或 Actions 添加。

快速设置

从下表中选择一个工具，并收集所需的任何 API 密钥、服务 URL 或索引名称。

将所需的值添加到您的 .env 文件中，或者在工具提示时让用户从 LibreChat UI 中提供他们自己的凭据。

重启后会加载环境变量的更改。

部署方式	命令
Docker	`docker compose down && docker compose up -d`
本地	停止服务器，然后再次运行 `npm run backend`

在 LibreChat 中，选择 Agents，创建或编辑一个 agent，打开该 agent 的 Tools 列表，选择相应的工具，然后保存该 agent。

与该 Agent 开始对话，并要求其执行需要该工具的任务，例如搜索、计算、天气预报或生成图像。

工具	用途	所需配置	详情
OpenAI Image Tools	使用 OpenAI 图像模型生成和编辑图像	`IMAGE_GEN_OAI_API_KEY`；可选 `IMAGE_GEN_OAI_MODEL`	图像生成
Gemini Image Tools	使用 Gemini 生成图像并结合图像上下文进行编辑	`GEMINI_API_KEY`、`GOOGLE_KEY` 或 `GOOGLE_SERVICE_KEY_FILE`；可选 `GEMINI_IMAGE_MODEL`	Gemini 图像生成
DALL-E-3	旧版 OpenAI 图像生成	`DALLE3_API_KEY` 或 `DALLE_API_KEY`	DALL-E
Flux	云端图像生成及微调图像模型	`FLUX_API_KEY`；可选 `FLUX_API_BASE_URL`	Flux
Stable Diffusion	通过 Automatic1111 进行本地或自托管图像生成	`SD_WEBUI_URL`	Stable Diffusion
Google Search	为智能体提供 Google 自定义搜索结果	`GOOGLE_SEARCH_API_KEY` 和 `GOOGLE_CSE_ID`	Google Search
Tavily Search	针对智能体优化的实时网络搜索结果	`TAVILY_API_KEY`	Tavily Search
Traversaal	带有来源的 AI 搜索结果	`TRAVERSAAL_API_KEY`	Traversaal
Azure AI Search	搜索私有 Azure AI Search 索引	`AZURE_AI_SEARCH_SERVICE_ENDPOINT`、`AZURE_AI_SEARCH_INDEX_NAME`、`AZURE_AI_SEARCH_API_KEY`	Azure AI Search
OpenWeather	当前、预报、历史及每日天气数据	`OPENWEATHER_API_KEY`	OpenWeather
Wolfram\|Alpha	数学、计算、单位、精选知识及实时数据	`WOLFRAM_APP_ID`	Wolfram\|Alpha
Calculator	基础及复杂计算	无	Calculator

大多数自定义工具都应在不编辑 LibreChat 源代码的情况下添加。

当您想要将 Agent 连接到本地脚本、内部服务、数据库、浏览器自动化服务器或自定义 API 包装器时，请使用 MCP。例如，可以通过 MCP 服务器公开 DuckDuckGo 搜索工具，然后从 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，以及是否启用了该 agent 的 tools 功能。