docs(dingtalk): clarify card reply master switch

This commit is contained in:
Hyu
2026-10-10 20:38:56 +08:00
parent 6f5ea77d85
commit f41981b356
3 changed files with 9 additions and 9 deletions
+3 -3
View File
@@ -30,7 +30,7 @@ LangBot 支持一键创建钉钉应用并自动填写凭证,无需手动复制
7. 点击**提交**,完成创建。当前版本会自动识别机器人身份。
<Warning>
一键配置会填写应用凭据,不会自动创建卡片模板。填写「卡片模板 ID」即自动启用流式回复,留空使用普通回复;使用按钮、输入框等人工交互,需要按下方步骤导入模板并填写「人工输入卡片模板 ID」。卡片功能还需在钉钉应用的权限管理中开通相应权限。
一键配置会填写应用凭据,不会自动创建卡片模板。开启「使用卡片回复」并填写「卡片模板 ID」即自动启用流式回复;关闭开关即可使用纯文本,无需删除模板 ID;使用按钮、输入框等人工交互,需要按下方步骤导入模板并填写「人工输入卡片模板 ID」。卡片功能还需在钉钉应用的权限管理中开通相应权限。
</Warning>
## 配置卡片模板(推荐使用 LangBot 模板)
@@ -59,7 +59,7 @@ LangBot 支持一键创建钉钉应用并自动填写凭证,无需手动复制
</Note>
5. 检查预览,**保存并发布**模板,再复制模板 ID。只保存草稿不能发送卡片;`param.templateUnpublished` 表示模板尚未发布。
6. 返回 LangBot,将 ID 填入 **卡片模板 ID** 并保存机器人配置,即自动启用流式回复。清空该字段并保存则恢复普通回复。
6. 返回 LangBot,开启 **使用卡片回复**,将 ID 填入 **卡片模板 ID** 并保存机器人配置,即自动启用流式回复。关闭开关后使用纯文本,模板 ID 等配置会隐藏并保留,再次开启即可恢复。
模板带有 LangBot 标识,思考与正文分区展示;思考区在输出时展开,完成后默认折叠,可点击展开。底部提供复制正文、赞/踩以及「内容由 AI 生成」标记。是否删除思考仍由流水线设置控制;删除后不展示思考区。普通消息保留思考时,会显示 `<think>`、`</think>` 标记并用空行分隔正文。
@@ -115,7 +115,7 @@ LangBot 支持一键创建钉钉应用并自动填写凭证,无需手动复制
### 填写配置信息
点击`凭证与基础信息`,记录`Client ID` 和 `Client Secret`。将这两项凭据填写到 LangBot 的适配器配置中。
`markdown_card` 为是否启用 Markdown 形式的回复,当此配置项关闭时,`@发送者` 配置开关不会生效。
`markdown_card`(使用卡片回复)统一控制 Markdown 和流式卡片回复。开启且配置模板时自动流式输出,未配置模板时使用普通 Markdown 回复;关闭后使用纯文本,保留模板设置。人工输入卡片用于工作流交互,单独配置。
将以上配置项 记录下来,填到 LangBot 机器人配置表单中。
点击[卡片平台](https://open-dev.dingtalk.com/fe/card?spm=ding_open_doc.document.0.0.33cf2281L0fXsV)模板列表复制绑定的对应的模板id填入卡片模板id