interactive

Overview ¶

backend.go:内置 mock 业务后端(商品/库存/销售/订单/客户)。数据确定性 生成(无随机,重启一致),状态可变(改价/调库存/订单流转/退款真实生效, 后续查询能看到变化)。刻意埋入的异常,供复杂场景考察 agent:

P103 热销但库存告急(补货候选)     P108 销量持续下滑且库存积压(清仓候选)
P115 成本高于售价(亏本在售)       P117 连续 30 天零销量(滞销)
P111 已下架但仍有历史订单          P105 库存表有重复记录(数据质量)
O-1042 已付款 12 天未发货(卡单)   O-1063 已完成但客户申请退款

card.go:ops-card 装饰器——第三方定制卡片的参考实现 (机制见 docs/channel-card-design.md;框架只给事实,对原始输出内容 的一切定制都在这里,包括表格降级这类飞书特性适配)。

形态:

┌ 标题头(按 Kind 换色:处理中灰 / 完成蓝 / 提问橙 / 失败红)
├ 折叠面板「执行过程」(out.Progress;处理中展开,完成后收起)
├ 正文(markdown 表格转分组列表——飞书卡片不渲染表格语法)
└ note 灰字(out.Meta:耗时/调用数)

examples/interactive:冒烟场景的**可交互副本**——smoke 树保持纯测试用途, 本目录独立演进。真实 MiniMax + 内置 mock 业务后端 + 真实 pdf 技能。

MINIMAX_API_KEY=$(security find-generic-password -a agent-kit -s minimax-api-key -w) \
go run ./examples/interactive

默认模型 MiniMax(M2.7);切智谱 GLM:OPS_MODEL_PROVIDER=zhipu + ZHIPU_API_KEY。

业务数据(backend.go,确定性生成):20 商品 × 6 品类 × 3 仓库 × 30 天 销售序列 × 80 订单 × 10 客户,埋有异常(热销缺货 P103、下滑积压 P108、 亏本在售 P115、滞销 P117、卡单 O-1042、退款申请 O-1063…)。改动性操作 (调价/退款/发货/补货/上下架)真实生效,改完再查能看到变化。

试试(由浅入深):

> 用 quick-product-qa 查降噪耳机价格
> 给 P100 做完整定价审查
> 音频品类近 30 天卖得怎么样?出一份销售报表
> 订单 O-1042 什么情况?卡在哪一步,该怎么处理
> 客户 C3 要求给订单 O-1063 退款,查一下订单和客户等级,按售后政策处理
> 扫一遍全店:哪些商品在亏本卖?哪些滞销?哪些热销但库存撑不住?
  逐个给出处理方案(调价/清仓/补货),先列计划再执行,改动前跟我确认
> 把上面的分析结果汇总生成一份 PDF 周报(pdf 技能;宿主直跑需 pypdf)

脚本执行与沙箱:app.yaml 的 exec: 块是 app 级默认沙箱策略,覆盖计算域的 python 工具与 pdf 技能包的脚本。本 runner 启动时检测 docker:

有 docker  → OPS_SANDBOX=docker,脚本进一次性加固容器(python 打印
             platform 会看到 Linux——证明不在宿主上跑);
无 docker  → 宿主直跑并打印告警(装 docker 或 export OPS_SANDBOX=docker 强制)。

默认镜像 python:3.12-slim(公共镜像,纯计算够用);要让 pdf 技能的脚本 也进沙箱,build examples/exec-runtime/Dockerfile(预装 pypdf/nodejs)后 export OPS_SANDBOX_IMAGE=agent-kit-runtime:latest。

pdf 技能与 python 工具都是 Dangerous 风险:每次调用会在终端请求批准 (y 放行,a 本会话免问)。