附录 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 / n8n1–3 天验证业务流程与体验
定制Vibe Coding(Cursor / Codex)补 Demo补开箱工具做不了的定制页/工具
工程化LangGraph / LlamaIndex / FastAPI可维护、可扩展、可上生产

本模板对应正文:第 17 章(工具选型)、第 14 章(Agentic 最小闭环)、第 16 章(方案设计六要素)。