diff --git a/docs/en/config/function/command.md b/.backup/en/config/function/command.md similarity index 100% rename from docs/en/config/function/command.md rename to .backup/en/config/function/command.md diff --git a/docs/en/config/function/pipeline.md b/.backup/en/config/function/pipeline.md similarity index 100% rename from docs/en/config/function/pipeline.md rename to .backup/en/config/function/pipeline.md diff --git a/docs/en/config/function/platform.md b/.backup/en/config/function/platform.md similarity index 100% rename from docs/en/config/function/platform.md rename to .backup/en/config/function/platform.md diff --git a/docs/en/config/function/provider.md b/.backup/en/config/function/provider.md similarity index 100% rename from docs/en/config/function/provider.md rename to .backup/en/config/function/provider.md diff --git a/docs/en/config/function/system.md b/.backup/en/config/function/system.md similarity index 100% rename from docs/en/config/function/system.md rename to .backup/en/config/function/system.md diff --git a/docs/en/config/metadata/adapter-qq-botpy.md b/.backup/en/config/metadata/adapter-qq-botpy.md similarity index 100% rename from docs/en/config/metadata/adapter-qq-botpy.md rename to .backup/en/config/metadata/adapter-qq-botpy.md diff --git a/docs/en/config/metadata/llm-models.md b/.backup/en/config/metadata/llm-models.md similarity index 100% rename from docs/en/config/metadata/llm-models.md rename to .backup/en/config/metadata/llm-models.md diff --git a/docs/en/config/metadata/sensitive-words.md b/.backup/en/config/metadata/sensitive-words.md similarity index 100% rename from docs/en/config/metadata/sensitive-words.md rename to .backup/en/config/metadata/sensitive-words.md diff --git a/docs/en/deploy/langbot/docker.md b/.backup/en/deploy/langbot/docker.md similarity index 100% rename from docs/en/deploy/langbot/docker.md rename to .backup/en/deploy/langbot/docker.md diff --git a/docs/en/deploy/langbot/manual.md b/.backup/en/deploy/langbot/manual.md similarity index 100% rename from docs/en/deploy/langbot/manual.md rename to .backup/en/deploy/langbot/manual.md diff --git a/docs/en/deploy/langbot/one-click/bt.md b/.backup/en/deploy/langbot/one-click/bt.md similarity index 100% rename from docs/en/deploy/langbot/one-click/bt.md rename to .backup/en/deploy/langbot/one-click/bt.md diff --git a/docs/en/deploy/network-details.md b/.backup/en/deploy/network-details.md similarity index 100% rename from docs/en/deploy/network-details.md rename to .backup/en/deploy/network-details.md diff --git a/docs/en/deploy/platforms/aiocqhttp/lagrange.md b/.backup/en/deploy/platforms/aiocqhttp/lagrange.md similarity index 100% rename from docs/en/deploy/platforms/aiocqhttp/lagrange.md rename to .backup/en/deploy/platforms/aiocqhttp/lagrange.md diff --git a/docs/en/deploy/platforms/aiocqhttp/llonebot.md b/.backup/en/deploy/platforms/aiocqhttp/llonebot.md similarity index 100% rename from docs/en/deploy/platforms/aiocqhttp/llonebot.md rename to .backup/en/deploy/platforms/aiocqhttp/llonebot.md diff --git a/docs/en/deploy/platforms/aiocqhttp/napcat.md b/.backup/en/deploy/platforms/aiocqhttp/napcat.md similarity index 100% rename from docs/en/deploy/platforms/aiocqhttp/napcat.md rename to .backup/en/deploy/platforms/aiocqhttp/napcat.md diff --git a/docs/en/deploy/platforms/aiocqhttp/shamrock.md b/.backup/en/deploy/platforms/aiocqhttp/shamrock.md similarity index 100% rename from docs/en/deploy/platforms/aiocqhttp/shamrock.md rename to .backup/en/deploy/platforms/aiocqhttp/shamrock.md diff --git a/docs/en/deploy/platforms/gocq.md b/.backup/en/deploy/platforms/gocq.md similarity index 100% rename from docs/en/deploy/platforms/gocq.md rename to .backup/en/deploy/platforms/gocq.md diff --git a/docs/en/deploy/platforms/mirai.md b/.backup/en/deploy/platforms/mirai.md similarity index 100% rename from docs/en/deploy/platforms/mirai.md rename to .backup/en/deploy/platforms/mirai.md diff --git a/docs/en/deploy/platforms/official.md b/.backup/en/deploy/platforms/official.md similarity index 100% rename from docs/en/deploy/platforms/official.md rename to .backup/en/deploy/platforms/official.md diff --git a/docs/en/deploy/quick-config/config.md b/.backup/en/deploy/quick-config/config.md similarity index 100% rename from docs/en/deploy/quick-config/config.md rename to .backup/en/deploy/quick-config/config.md diff --git a/docs/en/deploy/update.md b/.backup/en/deploy/update.md similarity index 100% rename from docs/en/deploy/update.md rename to .backup/en/deploy/update.md diff --git a/docs/en/develop/comp-arch.md b/.backup/en/develop/comp-arch.md similarity index 100% rename from docs/en/develop/comp-arch.md rename to .backup/en/develop/comp-arch.md diff --git a/docs/en/index.md b/.backup/en/index.md similarity index 100% rename from docs/en/index.md rename to .backup/en/index.md diff --git a/docs/en/insight/community.md b/.backup/en/insight/community.md similarity index 100% rename from docs/en/insight/community.md rename to .backup/en/insight/community.md diff --git a/docs/en/insight/guide.md b/.backup/en/insight/guide.md similarity index 100% rename from docs/en/insight/guide.md rename to .backup/en/insight/guide.md diff --git a/docs/en/insight/intro.md b/.backup/en/insight/intro.md similarity index 100% rename from docs/en/insight/intro.md rename to .backup/en/insight/intro.md diff --git a/docs/en/plugin/dev/api-ref.md b/.backup/en/plugin/dev/api-ref.md similarity index 100% rename from docs/en/plugin/dev/api-ref.md rename to .backup/en/plugin/dev/api-ref.md diff --git a/docs/en/plugin/dev/extension.md b/.backup/en/plugin/dev/extension.md similarity index 100% rename from docs/en/plugin/dev/extension.md rename to .backup/en/plugin/dev/extension.md diff --git a/docs/en/plugin/dev/messages.md b/.backup/en/plugin/dev/messages.md similarity index 100% rename from docs/en/plugin/dev/messages.md rename to .backup/en/plugin/dev/messages.md diff --git a/docs/en/plugin/dev/tutor.md b/.backup/en/plugin/dev/tutor.md similarity index 100% rename from docs/en/plugin/dev/tutor.md rename to .backup/en/plugin/dev/tutor.md diff --git a/docs/en/plugin/plugin-intro.md b/.backup/en/plugin/plugin-intro.md similarity index 100% rename from docs/en/plugin/plugin-intro.md rename to .backup/en/plugin/plugin-intro.md diff --git a/docs/en/plugin/tech-info.md b/.backup/en/plugin/tech-info.md similarity index 100% rename from docs/en/plugin/tech-info.md rename to .backup/en/plugin/tech-info.md diff --git a/docs/en/public/QChatGPT-0516.png b/.backup/en/public/QChatGPT-0516.png similarity index 100% rename from docs/en/public/QChatGPT-0516.png rename to .backup/en/public/QChatGPT-0516.png diff --git a/docs/en/public/c12e8803945846f4ea730e249db79574.txt b/.backup/en/public/c12e8803945846f4ea730e249db79574.txt similarity index 100% rename from docs/en/public/c12e8803945846f4ea730e249db79574.txt rename to .backup/en/public/c12e8803945846f4ea730e249db79574.txt diff --git a/docs/en/public/chrome-192.png b/.backup/en/public/chrome-192.png similarity index 100% rename from docs/en/public/chrome-192.png rename to .backup/en/public/chrome-192.png diff --git a/docs/en/public/chrome-512.png b/.backup/en/public/chrome-512.png similarity index 100% rename from docs/en/public/chrome-512.png rename to .backup/en/public/chrome-512.png diff --git a/docs/en/public/favicon.ico b/.backup/en/public/favicon.ico similarity index 100% rename from docs/en/public/favicon.ico rename to .backup/en/public/favicon.ico diff --git a/docs/en/public/langbot-logo-0.5x.png b/.backup/en/public/langbot-logo-0.5x.png similarity index 100% rename from docs/en/public/langbot-logo-0.5x.png rename to .backup/en/public/langbot-logo-0.5x.png diff --git a/docs/en/public/langbot-logo-block.png b/.backup/en/public/langbot-logo-block.png similarity index 100% rename from docs/en/public/langbot-logo-block.png rename to .backup/en/public/langbot-logo-block.png diff --git a/docs/en/public/langbot-logo-final.png b/.backup/en/public/langbot-logo-final.png similarity index 100% rename from docs/en/public/langbot-logo-final.png rename to .backup/en/public/langbot-logo-final.png diff --git a/docs/en/public/langbot-logo.png b/.backup/en/public/langbot-logo.png similarity index 100% rename from docs/en/public/langbot-logo.png rename to .backup/en/public/langbot-logo.png diff --git a/docs/en/public/social.png b/.backup/en/public/social.png similarity index 100% rename from docs/en/public/social.png rename to .backup/en/public/social.png diff --git a/docs/en/tob/contact.md b/.backup/en/tob/contact.md similarity index 100% rename from docs/en/tob/contact.md rename to .backup/en/tob/contact.md diff --git a/docs/en/tob/index.md b/.backup/en/tob/index.md similarity index 100% rename from docs/en/tob/index.md rename to .backup/en/tob/index.md diff --git a/docs/en/tob/platform.md b/.backup/en/tob/platform.md similarity index 100% rename from docs/en/tob/platform.md rename to .backup/en/tob/platform.md diff --git a/docs/en/tob/provider.md b/.backup/en/tob/provider.md similarity index 100% rename from docs/en/tob/provider.md rename to .backup/en/tob/provider.md diff --git a/docs/en/usage/command.md b/.backup/en/usage/command.md similarity index 100% rename from docs/en/usage/command.md rename to .backup/en/usage/command.md diff --git a/docs/en/usage/faq.md b/.backup/en/usage/faq.md similarity index 100% rename from docs/en/usage/faq.md rename to .backup/en/usage/faq.md diff --git a/docs/en/webui/intro.md b/.backup/en/webui/intro.md similarity index 100% rename from docs/en/webui/intro.md rename to .backup/en/webui/intro.md diff --git a/docs/en/webui/settings.md b/.backup/en/webui/settings.md similarity index 100% rename from docs/en/webui/settings.md rename to .backup/en/webui/settings.md diff --git a/docs/en/webui/system.md b/.backup/en/webui/system.md similarity index 100% rename from docs/en/webui/system.md rename to .backup/en/webui/system.md diff --git a/docs/en/workshop/dify-integration.md b/.backup/en/workshop/dify-integration.md similarity index 100% rename from docs/en/workshop/dify-integration.md rename to .backup/en/workshop/dify-integration.md diff --git a/docs/en/workshop/dify-service-api.md b/.backup/en/workshop/dify-service-api.md similarity index 100% rename from docs/en/workshop/dify-service-api.md rename to .backup/en/workshop/dify-service-api.md diff --git a/docs/en/workshop/impl-platform-adapter.md b/.backup/en/workshop/impl-platform-adapter.md similarity index 100% rename from docs/en/workshop/impl-platform-adapter.md rename to .backup/en/workshop/impl-platform-adapter.md diff --git a/docs/en/workshop/one-api.md b/.backup/en/workshop/one-api.md similarity index 100% rename from docs/en/workshop/one-api.md rename to .backup/en/workshop/one-api.md diff --git a/docs/assets/image/zh/workshop/dify-service-api/dify_workflow_output_key.png b/docs/assets/image/zh/workshop/dify-service-api/dify_workflow_output_key.png new file mode 100644 index 000000000..0d911abcf Binary files /dev/null and b/docs/assets/image/zh/workshop/dify-service-api/dify_workflow_output_key.png differ diff --git a/docs/assets/image/zh/workshop/dify-service-api/dify_workflow_var.png b/docs/assets/image/zh/workshop/dify-service-api/dify_workflow_var.png new file mode 100644 index 000000000..c8ede58b9 Binary files /dev/null and b/docs/assets/image/zh/workshop/dify-service-api/dify_workflow_var.png differ diff --git a/docs/zh/deploy/pipelines/readme.md b/docs/zh/deploy/pipelines/readme.md index 641397b67..669452d10 100644 --- a/docs/zh/deploy/pipelines/readme.md +++ b/docs/zh/deploy/pipelines/readme.md @@ -28,22 +28,21 @@ AI 能力主要分为两个部分，选择运行器和配置运行器参数。 more_runner -## 消息触发条件 +- 接入 Dify 的详细步骤可以[参考教程](/zh/workshop/dify-service-api.html)。 -- 群消息响应规则 -- 机器人黑/白名单 -- 消息忽略规则 +### 对话变量 -## 消息过滤 +当使用 Dify 或者阿里云百炼时，LangBot 会显式传入以下参数，您可以自行在 Dify 工作流的开始节点中添加： -- 内容过滤：敏感词检查配置 -- 消息速率管理 +- `user_message_text`：用户消息的纯文本 +- `session_id`：用户会话id，私聊为 `person_`，群聊为 `group_` +- `conversation_id`：字符串，用户会话id，由 LangBot 生成。用户重置会话后，会重新生成 +- `msg_create_time`：数字类型，收到此消息的时间戳（秒） -## 消息输出处理 +您可以[通过插件自定义任何变量](/zh/plugin/dev/api-ref.html#%E8%AE%BE%E7%BD%AE%E8%AF%B7%E6%B1%82%E5%8F%98%E9%87%8F)。 -- 长文本处理规则 -- 回复随机延迟 -- 是否@用户 -- 是否输出异常信息 -- 是否引用原消息 -- 是否跟踪函数调用 \ No newline at end of file +![Dify 工作流开始节点配置](/assets/image/zh/workshop/dify-service-api/dify_workflow_var.png) + +## 其他配置 + +请参考配置表单中的描述信息。 \ No newline at end of file diff --git a/docs/zh/deploy/platforms/qq/aiocqhttp/lagrange.md b/docs/zh/deploy/platforms/qq/aiocqhttp/lagrange.md index 6cd518eb5..512c3788f 100644 --- a/docs/zh/deploy/platforms/qq/aiocqhttp/lagrange.md +++ b/docs/zh/deploy/platforms/qq/aiocqhttp/lagrange.md @@ -61,3 +61,7 @@ Suffix 必须为 `/ws`； `平台/适配器选择`为`OneBot v11` ![napcat_webui_03](/assets/image/zh/deploy/bots/qq/onebot/napcat/napcat_webui_03.png) + +::: info +注意，如果涉及多个 docker 容器的网络连接问题，请参考[网络配置详解](/zh/workshop/network-details) +::: \ No newline at end of file diff --git a/docs/zh/deploy/platforms/qq/aiocqhttp/llonebot.md b/docs/zh/deploy/platforms/qq/aiocqhttp/llonebot.md index 4a33e7e2c..75c564c88 100644 --- a/docs/zh/deploy/platforms/qq/aiocqhttp/llonebot.md +++ b/docs/zh/deploy/platforms/qq/aiocqhttp/llonebot.md @@ -21,3 +21,7 @@ `平台/适配器选择`为`OneBot v11` ![napcat_webui_03](/assets/image/zh/deploy/bots/qq/onebot/napcat/napcat_webui_03.png) + +::: info +注意，如果涉及多个 docker 容器的网络连接问题，请参考[网络配置详解](/zh/workshop/network-details) +::: \ No newline at end of file diff --git a/docs/zh/deploy/platforms/qq/aiocqhttp/napcat.md b/docs/zh/deploy/platforms/qq/aiocqhttp/napcat.md index 9dfdc37e0..9ed352b23 100644 --- a/docs/zh/deploy/platforms/qq/aiocqhttp/napcat.md +++ b/docs/zh/deploy/platforms/qq/aiocqhttp/napcat.md @@ -27,3 +27,7 @@ `平台/适配器选择`为`OneBot v11` ![napcat_webui_03](/assets/image/zh/deploy/bots/qq/onebot/napcat/napcat_webui_03.png) + +::: info +注意，如果涉及多个 docker 容器的网络连接问题，请参考[网络配置详解](/zh/workshop/network-details) +::: \ No newline at end of file diff --git a/docs/zh/deploy/platforms/readme.md b/docs/zh/deploy/platforms/readme.md index 1b2a50f99..74cb2a92d 100644 --- a/docs/zh/deploy/platforms/readme.md +++ b/docs/zh/deploy/platforms/readme.md @@ -7,7 +7,7 @@ | 平台 | 状态 | 备注 |教程 | | ------ | ---- | ---- | ---- | -| QQ 个人号 | ✅ | 使用普通的 QQ 号作为机器人，需要使用独立的协议端，支持 OneBot v11 和 go-cqhttp 协议 | [NapCat](/zh/deploy/platforms/qq/aiocqhttp/napcat)
[Lagrange](/zh/deploy/platforms/qq/aiocqhttp/lagrange)
[LiteLoaderQQNT](/zh/deploy/platforms/qq/aiocqhttp/llonebot) | +| OneBot v11 | ✅ | 使用普通的 QQ 号作为机器人，需要使用独立的协议端，支持 OneBot v11 | [NapCat](/zh/deploy/platforms/qq/aiocqhttp/napcat)
[Lagrange](/zh/deploy/platforms/qq/aiocqhttp/lagrange)
[LiteLoaderQQNT](/zh/deploy/platforms/qq/aiocqhttp/llonebot) | | QQ 官方机器人 | ✅ | 接入 QQ 开放平台的机器人 API | [教程](/zh/deploy/platforms/qq/official_webhook) | | 企业微信 | ✅ | 企业内部机器人 | [教程](/zh/deploy/platforms/wecom/wecom) | | 企业微信客服 | ✅ | 企业对外机器人 | [教程](/zh/deploy/platforms/wecom/wecomcs) | diff --git a/docs/zh/deploy/platforms/wechat/gewechat.md b/docs/zh/deploy/platforms/wechat/gewechat.md index 379decf0e..ae640ce9a 100644 --- a/docs/zh/deploy/platforms/wechat/gewechat.md +++ b/docs/zh/deploy/platforms/wechat/gewechat.md @@ -1,7 +1,7 @@ # 通过 Gewechat 接入个人微信 :::warning -LangBot接入gewechat，仅供娱乐，请勿用于违法违规行为，否则后果自负。 +Gewechat 项目已停止维护，请勿使用。 ::: **本教程要求 LangBot 以 Docker 容器部署**，请根据 LangBot 部署文档将 LangBot 部署到 Docker 中。 @@ -50,8 +50,6 @@ docker run -itd --network langbot-network -v /root/temp:/root/temp -p 2531:2531 ## 在 LangBot 中填写信息并启动 -根据[填写配置信息](/deploy/quick-config/config)中的个人微信适配器配置，填写 LangBot 相关配置信息。 - ```json { "adapter": "gewechat", diff --git a/docs/zh/plugin/dev/api-ref.md b/docs/zh/plugin/dev/api-ref.md index 8076c926b..262a2c44d 100644 --- a/docs/zh/plugin/dev/api-ref.md +++ b/docs/zh/plugin/dev/api-ref.md @@ -68,7 +68,7 @@ ctx.add_return(name: str, value: Any) ctx.event.query.set_variable(key: str, value: typing.Any) ``` -请求变量是与此次 Query 绑定的一个 `dict`，其中包含了一些程序上下文信息。如果使用的是 Dify 或者 阿里云百炼 等 LLMOps 的runner，[这些变量将被传入对应平台的 API 作为变量](/zh/config/function/provider.html#%E8%AF%B7%E6%B1%82%E5%8F%98%E9%87%8F)。 +请求变量是与此次 Query 绑定的一个 `dict`，其中包含了一些程序上下文信息。如果使用的是 Dify 或者 阿里云百炼 等 LLMOps 的runner，[这些变量将被传入对应平台的 API 作为变量](/zh/deploy/pipelines/readme.html#%E5%AF%B9%E8%AF%9D%E5%8F%98%E9%87%8F)。 如果您需要使用插件设置变量，建议在`PromptPreProcessing`事件时处理。 - `key`：该变量的名称 diff --git a/docs/zh/plugin/dev/extension.md b/docs/zh/plugin/dev/extension.md index 162c20b88..6e2a64ddb 100644 --- a/docs/zh/plugin/dev/extension.md +++ b/docs/zh/plugin/dev/extension.md @@ -4,7 +4,7 @@ 2025年3月～4月：我们正在进行 4.0 版本重构，组件定义变化较大，现阶段不建议使用组件扩展。请优先考虑使用基于事件的插件接口。 ::: -> 请先阅读[插件介绍页](/plugin/plugin-intro) +> 请先阅读[插件介绍页](/zh/plugin/plugin-intro) :::info 目录 [[toc]] diff --git a/docs/zh/plugin/dev/messages.md b/docs/zh/plugin/dev/messages.md index edb4a2d33..e3481c9d1 100644 --- a/docs/zh/plugin/dev/messages.md +++ b/docs/zh/plugin/dev/messages.md @@ -81,14 +81,6 @@ msg_chain = MessageChain([ 除了上述实体之外，还有`好友 Friend`和`群 Group`等实体，这些实体的定义位于`pkg/platform/types/entities.py`中。 他们一般被包含于上述事件对象中，可以从中取得一些未被包含在插件事件中的信息。 -## 向后兼容性 - -以 3.x 版本为基础开发的插件，均可以无缝适配 3.4 版本。但 `import mirai` 在新版本已经不受支持，开发插件时编辑器会报错。请做如下修改： - -- `import mirai` 改为 `import pkg.platform.types as mirai` - - 不建议直接改成 `as mirai`，建议使用 `import pkg.platform.types as platform_types` 并将插件代码中对应的 `mirai.xxx` 替换为 `platform_types.xxx` -- `from mirai import *` 改为 `from pkg.platform.types import *` - ## 访问消息平台底层 API 为了抹平各个平台的差异，LangBot 在消息平台API之上，提供了一个抽象层，即上方所述的内容，以及`pkg/platform/sources`目录下的各个平台适配器。 @@ -109,7 +101,7 @@ msg_chain = MessageChain([ | 平台 | 适配器 | 访问方式 | 说明 | | --- | --- | --- | --- | -| QQ 个人号| aiocqhttp | adapter.bot | bot 对象对应 [aiocqhttp](https://github.com/nonebot/aiocqhttp) 的 CQHttp 对象，详细使用方式请参考 aiocqhttp 文档 | +| OneBot v11| aiocqhttp | adapter.bot | bot 对象对应 [aiocqhttp](https://github.com/nonebot/aiocqhttp) 的 CQHttp 对象，详细使用方式请参考 aiocqhttp 文档 | | QQ 官方API | qqofficial | adapter.bot | bot 对象为 libs/qq_official_api 下的 SDK 对象，详细使用方式可以参考 libs/qq_official_api/api.py 中`QQOfficialClient`中的`send_group_text_msg`方法发起 HTTP 请求的方式，具体接口文档请查看 QQ 官方 API 文档| | 个人微信 | gewechat | adapter.bot | bot 对象为 [hanfangyuan4396/gewechat-client](https://github.com/hanfangyuan4396/gewechat-python) 的 GewechatClient 对象，详细使用方式可以参考文档 | | 企业微信 | wecom | adapter.bot | 参考 libs/wecom_api/api.py 中`WecomClient`中的`send_image`方法发起 HTTP 请求的方式，具体接口文档请查看企业微信 API 文档 | diff --git a/docs/zh/workshop/dify-service-api.md b/docs/zh/workshop/dify-service-api.md index b6d944acd..4cc04225a 100644 --- a/docs/zh/workshop/dify-service-api.md +++ b/docs/zh/workshop/dify-service-api.md @@ -18,12 +18,25 @@ LangBot 目前支持`聊天助手`（含Chatflow）、`Agent`、`工作流`三 :::info 以上为 Dify 云服务版本的示例，若您使用本地自部署的社区版本，请使用 LangBot 访问你自己 Dify 服务的地址作为 `base-url`，后方需要添加 `/v1` 作为路径。 -- 若 LangBot 与 Dify 部署在同一台主机，并且都是使用 Docker 部署的，可以参考文章：[网络配置详解](/deploy/network-details.html#langbot-%E5%92%8C%E6%B6%88%E6%81%AF%E5%B9%B3%E5%8F%B0%E5%9D%87%E8%BF%90%E8%A1%8C%E5%9C%A8-docker-%E5%AE%B9%E5%99%A8%E4%B8%AD)。其中，请将启动 Dify 的 docker-compose.yaml 中所有容器的`networks`均添加`langbot-network`，并为`nginx`容器添加容器名`dify-nginx`，最后在 LangBot 配置中将`base-url`设置为`http://dify-nginx/v1`。 +- 若 LangBot 与 Dify 部署在同一台主机，并且都是使用 Docker 部署的，可以参考文章：[网络配置详解](/zh/workshop/network-details.html#langbot-%E5%92%8C%E6%B6%88%E6%81%AF%E5%B9%B3%E5%8F%B0%E5%9D%87%E8%BF%90%E8%A1%8C%E5%9C%A8-docker-%E5%AE%B9%E5%99%A8%E4%B8%AD)。其中，请将启动 Dify 的 docker-compose.yaml 中所有容器的`networks`均添加`langbot-network`，并为`nginx`容器添加容器名`dify-nginx`，最后在 LangBot 配置中将`base-url`设置为`http://dify-nginx/v1`。 - 其他情况请咨询贵司运维人员。 ::: ## 配置 LangBot -打开 LangBot Webui 页面，添加一个新的流水线 +打开 LangBot WebUI 页面，添加一个新的流水线或在已有流水线中切换到 AI 能力配置页面。 ![设置开发项](/assets/image/zh/deploy/pipelines/dify/dify01.png) + +::: info +### 工作流输出键 + +如果使用的是 Dify 的工作流应用，那么请使用 `summary` 作为键传递输出内容。 + +![Dify 工作流应用的输出键](/assets/image/zh/workshop/dify-service-api/dify_workflow_output_key.png) + +## 输出处理 + +使用 工作流 应用或 Agent 应用时，如果开启了 LangBot 流水线`输出处理`中的`track-function-calls`，将会在 Dify 执行每个工具调用时，输出一个`调用函数xxx`的消息给用户。 +但如果是使用`chat`应用下的`ChatFlow`（聊天助手->工作流编排），无论如何只会输出 Answer（直接回复）节点返回的文本。 +::: \ No newline at end of file diff --git a/docs/zh/workshop/mcp-details.md b/docs/zh/workshop/mcp-details.md index ae6f143c7..9168ca4da 100644 --- a/docs/zh/workshop/mcp-details.md +++ b/docs/zh/workshop/mcp-details.md @@ -21,6 +21,6 @@ ## 配置 MCP Server -查看 [配置文档](/config/function/provider.html#mcp-%E9%85%8D%E7%BD%AE-mcp) +查看 [系统设置文档](/zh/deploy/settings.html) 配置完成后即可在聊天中通过`!func`命令查看已经注册的 MCP 工具，在与支持 Function Calling 的模型对话时，LangBot 会自动调用 MCP 工具。 \ No newline at end of file