> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langbot.app/llms.txt
> Use this file to discover all available pages before exploring further.

# LangBot 插件

LangBot 内部由多种组件组成，如大模型工具、命令、消息平台适配器、大模型请求器等。为了满足扩展性和灵活性的需求，我们实现了一套生产级的插件系统。

每个插件被运行在独立的进程中，由 Plugin Runtime 统一管理。

<img width="600" src="https://mintcdn.com/langbot/3wTxBGgCdTnu0gxf/images/zh/plugin/dev/plugin_system_arch.png?fit=max&auto=format&n=3wTxBGgCdTnu0gxf&q=85&s=eeb9023a2ea330d608b638676b4379af" data-path="images/zh/plugin/dev/plugin_system_arch.png" />

## 插件结构

插件根据具体功能可提供以下组件：

* 事件处理器：监听流水线执行期间的事件，对上下文或流水线进行修改。
* 命令：由用户通过`!`（或其他已设置的前缀）开头的命令消息触发。
* 工具：供 LangBot 内置的 Local Agent 在执行期间由 LLM 调用。
* RAG 引擎：管理知识库的文档索引和检索。

后续还将支持更多组件的插件化。

## 安装插件

目前支持上传插件包安装、从插件市场安装以及从 GitHub Release 安装插件。\
在 LangBot 的插件管理页面，点击右上角即可选择安装方式

<img width="600" src="https://mintcdn.com/langbot/3wTxBGgCdTnu0gxf/images/zh/plugin/install_method.png?fit=max&auto=format&n=3wTxBGgCdTnu0gxf&q=85&s=6f9621bc296b374e54c667666a8dae5e" data-path="images/zh/plugin/install_method.png" />

点击本地安装，选择他人分享的或从 Marketplace 下载的`.lbpkg`文件，即可安装插件。

或点击插件市场 Tab，选择插件后点击安装。

<img width="600" src="https://mintcdn.com/langbot/3wTxBGgCdTnu0gxf/images/zh/plugin/install_from_marketplace.png?fit=max&auto=format&n=3wTxBGgCdTnu0gxf&q=85&s=b2572c71f7b71efeb040226c6e9edc85" data-path="images/zh/plugin/install_from_marketplace.png" />

安装插件后，您需要到流水线配置中，选择所需要使用的插件。

<img width="600" src="https://mintcdn.com/langbot/3wTxBGgCdTnu0gxf/images/zh/plugin/pipeline_extensions.png?fit=max&auto=format&n=3wTxBGgCdTnu0gxf&q=85&s=02f087906326eb7bb980dde7ee5cf589" data-path="images/zh/plugin/pipeline_extensions.png" />

## 插件管理

### 插件配置项

某些插件可能会要求您填入特定的配置项（请参考插件 README 说明），请点击插件卡片进入插件详情页，按照提示获取并输入。

<img width="600" src="https://mintcdn.com/langbot/3wTxBGgCdTnu0gxf/images/zh/plugin/plugin_config.png?fit=max&auto=format&n=3wTxBGgCdTnu0gxf&q=85&s=0c7808add9858c1a15c5c6ab44a4b812" data-path="images/zh/plugin/plugin_config.png" />

### 更新插件

仅支持更新从插件市场安装的插件。

<img width="600" src="https://mintcdn.com/langbot/3wTxBGgCdTnu0gxf/images/zh/plugin/update_plugin.png?fit=max&auto=format&n=3wTxBGgCdTnu0gxf&q=85&s=de79aaabf2d9c5a7c91fe7d3e971c963" data-path="images/zh/plugin/update_plugin.png" />

## 插件市场

插件市场可以从 LangBot 内部的`插件管理`页面进入，也可以访问独立站点[LangBot 插件市场](https://space.langbot.app/market)。
