示例场景

apps/example/agent-example 参考实现内置了 4 个端到端的行政业务场景,演示接入方 Agent Runtime 如何把 ZAP 会话、SSE 事件、EMP 组件和 HITL 回灌组合成完整流程。话术由接入方 Agent 服务里的真实 LLM 理解后选择工具路径,不是写死的关键词匹配;下面的触发话术可直接复制到知办AI数字员工对话里体验。

截图放置规则

截图文件放到 docs/public/openapi/scenarios/,文件名按占位框标注;然后取消占位框上方被注释的图片引用、删除占位框即可。

场景一:多工具联办(客户来访安排)

帮我安排下周三客户来访,顺便查一下接待制度、最新行政通知、行政联系人、可用会议室和接待费用标准,一起给我整理成执行建议。

接入方 Agent 服务连续调用 3-5 个工具(查制度、通知、联系人、会议室、费用标准),每次调用都以 message.tool_call / message.tool_result 中间帧流出,知办AI客户端实时展示"思考 → 调用 → 结果"的过程,最后汇总成可执行的接待安排建议。

演示的能力:工具调用过程帧、推理过程、流式 markdown。

场景二:三段采购审批

帮我提个采购审批,申请购买前台访客登记设备,预算 6800 元,需要走审批流程。

典型的 HITL 多段暂停流程:接入方 Agent Runtime 依次发出三个审批表单(直属经理 → 财务复核 → 行政执行),每段用 message.awaiting_user 暂停等用户填写,提交后以 form_response 回灌恢复。采购事项和金额来自用户原话,缺失时接入方 Agent 服务会先追问;任一环节不通过必须填写原因。

演示的能力:message.awaiting_user 暂停、表单回灌恢复、多轮 HITL 串联。

场景三:行政分析报告

生成一份本月行政运营报告,重点看会议室使用率、本月行政费用、工单处理时长,并给我图表、表格、图片和文件材料。

一条消息里组合输出多种数据组件:柱状图、折线图、饼图、散点图、明细表格、图片和可下载文件,展示 message.completed.blocks 承载富报告的能力。

演示的能力:chart(多种 chart_kind)、table、image、file 组合输出。

场景四:行政服务申请表

我要填一张行政服务申请,下周一有客户来访,需要访客接待、会议支持和办公用品准备。

接入方 Agent Runtime 返回行政服务申请表等待填写;用户提交后,接入方 Agent 服务生成受理回执,返回字段明细和回执文件,演示"表单收集 → 处理 → 产物落地"的闭环。

演示的能力:form 收集、form_response 回灌、回执 file 产物。

截图占位:受理回执(字段明细 + 回执文件) — scenario-service-receipt.png

组件级回归触发词

除以上完整场景外,reference 还保留了一组仅用于自动化回归的组件级触发词(approval demo、form full demo、画个柱状图、工具 demo 等),逐个组件的触发方式和截图见 EMP 组件清单。

相关链接

• 租户自定义 Agent Runtime 接入 — 凭证申请、runtime 注册、SDK 用法
• ZAP 消息协议 — 场景背后的事件流与 HITL 回灌格式
• EMP 组件清单 — 场景中出现的全部组件