Skip to content

K-brain v0.107.26

Choose a tag to compare

@github-actions github-actions released this 07 Nov 08:16
· 32 commits to main since this release
f6586f1

K-brain v0.107.26

本版从 main 的 f6586f1 构建,在 v0.107.25 的基础上支持 MCP 表单征询(elicitation)。

MCP 表单征询

MCP 服务器在工具运行中可以向用户要一份表单(例如登录信息、选项、数量),用户填写、拒绝或取消后,工具继续执行。

  • kn TUI(#175):显示表单卡片,标题最前面是配置里给这个服务器起的名字(不用服务器自报的名字),并注明“只有这个服务器会收到你的回答”。支持文本、数字、整数、开关、单选和多选,填写有误时逐项提示。看起来像密码、令牌、API key 的字段会遮挡输入,并提醒只在信任这个服务器时填写。
  • /v1 接口(#174):
    • 能力标志 capabilities.mcp_elicitation: 1;运行请求里带 options.mcp_elicitation: true 才会把表单转给客户端;
    • 事件 elicitation.requested / elicitation.resolved,回答接口 POST /v1/sessions/{id}/elicitations/{elicitation_id},动作为 accept、decline、cancel;
    • 回答不合要求时返回 400 和逐项的 field_errors,表单保持待填写;
    • 超过等待时间(与提问相同,默认 3 分钟)或运行停止时自动取消;
    • 工具结果和历史里记录每次征询的结果。
  • 不会卡住:没有声明支持的客户端、定时任务等无人值守的运行、直接调用 /v1/mcp/tools/call、一次工具调用里超过 8 次征询时,都立即拒绝,只在历史里留下记录。
  • 安全:
    • 服务器给的文字会去掉控制字符和双向文字字符再显示,不能伪装颜色或名字;
    • 敏感字段的值只在内存里交给 MCP 服务器,不写入事件、历史和日志;
    • 只接受 MCP 规范中的扁平表单结构,超出范围的请求直接以 -32602 拒绝,不打扰用户。

字段格式、校验规则和返回码见 docs/liveagent-backend.md 的“MCP 表单征询”一节。

下载与校验

提供 macOS、Linux、Windows 的 x64/ARM64 CLI 与 computer helper;SHA256SUMS 用于校验下载文件。

完整变更