能力与沙箱
BizBuddy 把「一次请求」拆成四段:接待、路由、作业、交付。每一段都有明确边界,也都有对应实现与可复跑的用例。
接待与路由
- 所有对话先进入入口智能体「小Z」;能自己回答的直接回答,需要领域能力的进入候选专家清单。
- 路由把任务直接委派给专家,专家回复直接交付用户,不再被二次改写。
- 专家不可用时如实降级,由小Z兜底说明,不静默失败。
作业:工具、知识库与写确认
- 专家带着只读工具、知识库与技能完成作业。
- 写工具按「允许 / 需确认 / 禁止」三档执行:
- 允许:直接执行并留痕;
- 需确认:暂停本轮,在对话内弹确认卡片,用户处置后在同一轮继续;
- 禁止:不注册给模型。
- 定时任务、渠道接入等无人值守链路代码级拒绝写工具,只有进入白名单的工具才执行。
Docker 沙箱执行(默认关闭)
需要执行命令、生成图表或导出表格时,任务落到隔离容器:
| 维度 | 做法 |
|---|---|
| 隔离 | 非 root(uid 1000)、--cap-drop=ALL、no-new-privileges、pids-limit、/tmp 为 tmpfs |
| 网络 | 默认 --network=none,不联网 |
| 数据 | 不挂载宿主目录;工作区在容器内,快照按需持久化 |
| 授权 | ALLOW / ASK / DENY 三态;无人值守链路恒为 DENY |
| 灰度 | 总开关默认关闭,按智能体编码灰度 |
| 并发 | 全局上限默认 32、等待 5 秒;超出直接拒绝 |
| 生命周期 | 每轮结束即销毁,实测无容器残留 |
socket 不裸挂
应用容器不持有 /var/run/docker.sock。启用沙箱时由覆盖层启动受限代理:
- 只有代理容器只读挂载 socket,应用仅持有
DOCKER_HOST; - 白名单按「方法 + 路径」放行容器与 exec 的最小集合;
containers/{id}/archive(工作区投影与文件读写依赖)只对带bizbuddy.sandbox=1标签的容器放行;- 代理不发布宿主端口,只接入内部网络。
代理只收窄风险,不等于强隔离。真正的强隔离需要受限执行服务或 rootless daemon,详见安全与合规。
报表分析师与产物
内置专家「报表分析师」把平台数据变成图表与表格:
- 只读工具
query_dataset取数,支持两维聚合(如dept,status); - 沙箱内
chart.py生成图表或 Excel; - 会话结束后自动导出
/workspace/out→ 对象存储 → 对话卡片; - 图表可在对话内内联预览,历史消息可回填;
- 产物随消息 / 会话删除级联回收,另有每日清理策略。
支持的图型:
| 类型 | 适用场景 |
|---|---|
bar / barh | 类别比较;类目多或名称长用条形 |
pie / donut | 占比;环形突出中间汇总 |
line / area | 时间趋势;面积强调量感 |
histogram | 数值分布 |
scatter | 两个数值的相关性 |
kpi | 只要几个关键数字 |
table / xlsx | 明细与导出 |
stackedBar / groupedBar | 两维聚合的堆叠 / 并排 |
multiline | 多序列趋势对比 |
沙箱未启用时,报表专家无法执行出图,会如实说明,不编造数据。
知识与记忆
- 知识库支持
vector与hybrid两种检索;hybrid 为向量 + BM25 双路召回、RRF 融合,再走可选重排。 - 长期记忆由平台托管:抽取、注入、合并、归档与清理;删除前保留版本快照,可恢复。
集成与渠道
- MCP 出口:把平台只读工具以 MCP 协议对外提供。
- MCP 客户端:接入外部 MCP Server,回参逐块脱敏。
- 多渠道:飞书、企业微信、钉钉、GitHub;Webhook 与长连接双形态,长连接免公网 IP。
启用沙箱需要什么
- 构建基础镜像:
deploy/sandbox-image/build.ps1(默认产出bizbuddy/sandbox:1.1.3); - 用沙箱目标构建后端:
ADMIN_BUILD_TARGET=sandbox; - 叠加覆盖层启动:
docker-compose.yml+docker-compose.sandbox.yml; - 在「模型与推理 → 沙箱执行」页开启、选择镜像与灰度智能体并保存(保存前会校验镜像契约)。