附录 C:PoC 技术架构图模板
老板怎么用: 这是 PoC 走向工程化前的「施工图」,帮你看清方案用哪些技术、花多少成本、谁来运维。你审批资源前可要求团队填好分层模板,避免交付物只有 Demo 没有可上生产的架构,后续被技术债拖垮。
AI 介入点图讲清「AI 插在业务哪一步」,技术架构图讲清「这一步用什么技术实现」。这张图是给技术侧看的,也是从 PoC 走向工程化时的施工图。
📎 技术深读:各组件(RAG / Agent / MCP / 多 Agent 编排)的实现细节,见 Harness Agent Book Part 2–5。本附录只给 Agent 落地工程师视角的装配模板。
分层模板
┌─────────────────────────────────────────────┐
│ 接入层:企业 IM / Web / 工单 / 定时任务 │
├─────────────────────────────────────────────┤
│ 编排层:n8n / Dify Workflow / Coze / 自研胶水 │
│ (路由、人审节点、异常处理、重试) │
├─────────────────────────────────────────────┤
│ 智能体层:意图识别 → 工具选择 → 生成 → 结构化输出 │
│ Prompt 资产 · Skill · 多 Agent 协同 │
├─────────────────────────────────────────────┤
│ 能力层:RAG 检索 · Tool/MCP 调用 · 模型推理 │
├─────────────────────────────────────────────┤
│ 数据层:向量库 · 知识库 · 业务系统 · Golden Dataset │
├─────────────────────────────────────────────┤
│ 横切:权限 / 审计日志 / 成本监控 / 评估回归 / 回滚 │
└─────────────────────────────────────────────┘
每层要回答的问题(填空)
| 层 | 要素 | 本 PoC 选择 |
|---|---|---|
| 接入层 | 用户从哪进入? | |
| 编排层 | 用 Dify / n8n / Coze / 自研?人审节点在哪? | |
| 智能体层 | 单 Agent 还是多 Agent?用哪种协同模式? | |
| 能力层 | 需要哪些工具 / MCP?RAG 检索什么? | |
| 模型 | 选哪个模型?成本 / 延迟 / 合规如何权衡? | |
| 数据层 | 数据从哪来?向量库用什么? | |
| 数据更新 | 多久更新?谁维护?失败如何告警? | |
| 横切 | 权限怎么控?成本怎么监?怎么回归? | |
| 安全 | 如何防提示注入、越权工具、跨租户泄露? | |
| 可观测 | trace id、日志字段、告警、回滚开关在哪? |
最小可观测字段
| 字段 | 说明 |
|---|---|
| trace_id | 一次完整任务的唯一追踪 ID |
| user / tenant | 谁触发、属于哪个租户 |
| prompt_version | 本次使用的提示词版本 |
| model_version | 本次使用的模型版本 |
| knowledge_version | 检索知识库或文档版本 |
| tool_calls | 调了哪些工具、成功与否、耗时 |
| human_review | 是否人审、谁确认、修改了什么 |
| cost / latency | 本次成本与耗时 |
三层 PoC 路径提示
| 阶段 | 技术选择 | 目标 |
|---|---|---|
| 快验 | Dify / Coze / n8n | 1–3 天验证业务流程与体验 |
| 定制 | Vibe Coding(Cursor / Codex)补 Demo | 补开箱工具做不了的定制页/工具 |
| 工程化 | LangGraph / LlamaIndex / FastAPI | 可维护、可扩展、可上生产 |
本模板对应正文:第 17 章(工具选型)、第 14 章(Agentic 最小闭环)、第 16 章(方案设计六要素)。