mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-10-28 11:25:35 +08:00
docs(dingtalk): clarify card reply master switch
This commit is contained in:
Hyu
@@ -31,7 +31,7 @@ LangBot supports one-click DingTalk app creation with automatic credential filli
|
||||
7. Click **Submit** to complete. LangBot automatically identifies the bot.
|
||||
|
||||
<Warning>
|
||||
One-click setup fills in app credentials but does not create card templates. For streaming replies, import the LangBot streaming reply template, set Card Template ID to automatically enable streaming replies; leave it empty for ordinary replies. For human input interactions, import the separate human input template and set Human Input Card Template ID. Enable the required card permissions in your DingTalk app.
|
||||
One-click setup fills in app credentials but does not create card templates. For streaming replies, import the LangBot streaming reply template, enable Use Card Replies and set Card Template ID to automatically enable streaming replies. Turn off the switch for plain text without deleting the template ID. For human input interactions, import the separate human input template and set Human Input Card Template ID. Enable the required card permissions in your DingTalk app.
|
||||
</Warning>
|
||||
|
||||
## Configure card templates (use the LangBot templates)
|
||||
@@ -60,7 +60,7 @@ The import option is inside the editor, not on the template list page. Importing
|
||||
</Note>
|
||||
|
||||
5. Review the preview, **save and publish** the template, and copy its ID. Saving a draft is insufficient: `param.templateUnpublished` means the template has not been published.
|
||||
6. Paste the ID into **Card Template ID** in LangBot and save to automatically enable streaming replies. Clear this field and save to return to ordinary replies.
|
||||
6. Enable **Use Card Replies**, paste the ID into **Card Template ID** in LangBot, and save to enable streaming replies. Turning off the switch uses plain text and hides but preserves the template settings for later use.
|
||||
|
||||
The template includes LangBot branding and separate reasoning and answer regions. Reasoning is expanded during generation and collapsed by default when finished; users can expand it again. The footer offers answer copying, thumbs-up/down controls, and an AI-generated content label. The pipeline still controls whether reasoning is removed. If removed, the reasoning region is hidden. Ordinary messages with reasoning retained show literal `<think>` and `</think>` markers separated from the answer by blank lines.
|
||||
|
||||
@@ -116,7 +116,7 @@ For card templates, follow the steps above to import and publish the templates s
|
||||
### Fill in Configuration Information
|
||||
|
||||
Click `Credentials and Basic Information`, record `Client ID` and `Client Secret`, and enter these credentials in the LangBot adapter configuration.
|
||||
`markdown_card` is whether to enable Markdown form replies. When this configuration item is disabled, the `@Sender` configuration switch will not take effect.
|
||||
`markdown_card` (Use Card Replies) controls both Markdown and streaming card replies. When enabled, a configured template enables streaming; otherwise ordinary Markdown is used. Disable it for plain text without clearing template settings. Human input cards are configured separately for workflow interactions.
|
||||
Record the above configuration items and fill them in the LangBot bot configuration form
|
||||
|
||||
Click [Card Platform](https://open-dev.dingtalk.com/fe/card?spm=ding_open_doc.document.0.0.33cf2281L0fXsV), copy the corresponding bound template ID from the template list, and fill it into the card template ID field.
|
||||
|
||||
@@ -31,7 +31,7 @@ LangBot は DingTalk アプリのワンクリック作成とクレデンシャ
|
||||
7. **送信** をクリックして完了します。LangBot がボットの識別情報を自動的に取得します。
|
||||
|
||||
<Warning>
|
||||
ワンクリック設定ではアプリの認証情報が入力されますが、カードテンプレートは作成されません。ストリーミング返信には LangBot の返信テンプレートをインポートし、Card Template ID を設定すると自動的に有効になります。空欄の場合は通常の返信になります。人工入力には別のテンプレートをインポートし、Human Input Card Template ID を設定してください。DingTalk アプリのカード権限も必要です。
|
||||
ワンクリック設定ではアプリの認証情報が入力されますが、カードテンプレートは作成されません。ストリーミング返信には LangBot の返信テンプレートをインポートし、Use Card Replies を有効にして Card Template ID を設定すると自動的に有効になります。スイッチを無効にすると、テンプレート ID を削除せずにプレーンテキストで返信できます。人工入力には別のテンプレートをインポートし、Human Input Card Template ID を設定してください。DingTalk アプリのカード権限も必要です。
|
||||
</Warning>
|
||||
|
||||
## カードテンプレートの設定（LangBot 提供のテンプレートを推奨）
|
||||
@@ -60,7 +60,7 @@ LangBot は DingTalk アプリのワンクリック作成とクレデンシャ
|
||||
</Note>
|
||||
|
||||
5. プレビューを確認して**保存・公開**し、テンプレート ID をコピーします。下書きの保存だけでは送信できません。`param.templateUnpublished` はテンプレートが未公開であることを示します。
|
||||
6. LangBot の **Card Template ID** に ID を入力して保存すると、ストリーミング返信が自動的に有効になります。空欄にして保存すると通常の返信に戻ります。
|
||||
6. LangBot の **Use Card Replies** を有効にし、**Card Template ID** に ID を入力して保存すると、ストリーミング返信が有効になります。スイッチを無効にするとプレーンテキストで返信し、テンプレート設定は非表示になりますが保持されます。再度有効にすると設定を再利用できます。
|
||||
|
||||
テンプレートには LangBot の表示があり、思考と回答を別々に表示します。生成中は思考欄が開き、完了後は折りたたまれます。クリックで再び展開できます。下部には回答のコピー、高評価・低評価、AI 生成コンテンツの表示があります。思考を削除するかどうかはパイプライン設定に従い、削除する場合は思考欄を表示しません。通常メッセージで思考を保持する場合は、`<think>` と `</think>` を文字として表示し、空行で回答と区切ります。
|
||||
|
||||
@@ -117,7 +117,7 @@ LangBot は DingTalk アプリのワンクリック作成とクレデンシャ
|
||||
|
||||
「認証情報と基本情報」をクリックし、「Client ID」と「Client Secret」を記録します。
|
||||
この認証情報を LangBot のアダプター設定に入力します。
|
||||
`markdown_card` は Markdown 形式の返信を有効にするかどうかです。この設定項目が無効になっている場合、`@送信者` 設定スイッチは有効になりません。
|
||||
`markdown_card`（Use Card Replies）は Markdown とストリーミングカード返信の共通スイッチです。有効でテンプレートが設定されていればストリーミング、未設定なら通常の Markdown で返信します。無効にすると設定を保持したままプレーンテキストで返信します。ワークフローの人工入力カードは別途設定します。
|
||||
上記の設定項目を記録し、LangBot ボット設定フォームに入力します
|
||||
|
||||
[カードプラットフォーム](https://open-dev.dingtalk.com/fe/card?spm=ding_open_doc.document.0.0.33cf2281L0fXsV)をクリックし、テンプレートリストから対応するバインドされたテンプレート ID をコピーし、カードテンプレート ID フィールドに入力します。
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user