--- id: "2026-03-24-agent-friendly-architecture" title: "Agent Friendly 概念关系与架构全景图" slug: "agent-friendly-architecture" status: "inbox" content_type: "article" channels: ["wechat", "x"] language: "zh-CN" source_urls: - "https://www.anthropic.com/research/building-effective-agents" - "https://modelcontextprotocol.io/specification/2025-06-18/server/tools" - "https://a2a-protocol.org" - "https://agentexperience.ax/" assets: [] cover_image: "" template: "article" owner: "content-forge" created_at: "2026-03-24T00:00:00+08:00" updated_at: "2026-03-24T00:00:00+08:00" published_at: null tags: ["agent-friendly", "architecture", "concept-map", "MCP", "A2A", "AX"] --- # Agent Friendly 概念关系与架构全景图 --- ## 一、总体架构：五层模型 ``` ┌─────────────────────────────────────────────────────────────────────┐ │ │ │ ⑤ 治理与生态层 (Governance) │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────────────┐ │ │ │ AAIF │ │ CoSAI │ │ OWASP │ │ OpenAPI Initiative│ │ │ │ 标准治理 │ │ 安全联盟 │ │ 安全标准 │ │ API 描述标准 │ │ │ └──────────┘ └──────────┘ └──────────┘ └───────────────────┘ │ │ │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ④ 发现与身份层 (Discovery) │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ llms.txt │ │AGENTS.md │ │ Agent │ │ KYA │ │ │ │ 文档发现 │ │ 项目指令 │ │ Card │ │ 身份验证 │ │ │ └──────────┘ └──────────┘ │ 能力声明 │ └──────────┘ │ │ ┌──────────┐ ┌──────────┐ └──────────┘ ┌──────────┐ │ │ │ JSON-LD │ │Schema.org│ │ OpenAPI │ │ │ │ 语义标注 │ │ 词汇表 │ │ API 描述 │ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ③ 协议与连接层 (Protocol) │ │ │ │ ┌───────────────────────┐ ┌───────────────────────┐ │ │ │ MCP │ │ A2A │ │ │ │ Agent ←→ Tool │ │ Agent ←→ Agent │ │ │ │ 垂直连接（纵向） │ │ 水平互操作（横向） │ │ │ │ JSON-RPC 2.0 │ │ HTTP / SSE / gRPC │ │ │ └───────────────────────┘ └───────────────────────┘ │ │ ┌───────────────────────┐ ┌───────────────────────┐ │ │ │ Agentic Commerce │ │ A2UI │ │ │ │ Protocol │ │ Agent → 富 UI 渲染 │ │ │ │ Agent 支付/商务 │ │ │ │ │ └───────────────────────┘ └───────────────────────┘ │ │ │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ② 设计与实现层 (Design) │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ AX 设计 │ │ ACI 接口 │ │ Tool │ │ Agent │ │ │ │ 10 原则 │ │ 设计方法 │ │ Design │ │ Skills │ │ │ └──────────┘ └──────────┘ │ 7 子规约 │ │ 可移植知识│ │ │ ┌──────────┐ ┌──────────┐ └──────────┘ └──────────┘ │ │ │ Schema- │ │ Outcome- │ ┌──────────┐ ┌──────────┐ │ │ │ First │ │ Oriented │ │Idempotent│ │ Content │ │ │ │ 契约优先 │ │ 结果导向 │ │ 幂等设计 │ │Negotiation│ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │ ├─────────────────────────────────────────────────────────────────────┤ │ │ │ ① 安全与运维层 (Security & Ops) │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ Least │ │ Sandbox │ │ Policy │ │ Audit │ │ │ │ Agency │ │ /MicroVM │ │ Engine │ │ Trail │ │ │ │ 最小代理权│ │ 沙箱隔离 │ │ 策略引擎 │ │ 审计日志 │ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ HITL │ │ Circuit │ │ Token │ │ Kill │ │ │ │ 人在环路 │ │ Breaker │ │ Exchange │ │ Switch │ │ │ │ │ │ 熔断器 │ │ 令牌交换 │ │ 紧急停止 │ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │ └─────────────────────────────────────────────────────────────────────┘ ``` **阅读方式**：从下往上。安全是地基，设计是砖墙，协议是管道，发现是门牌，治理是法规。 --- ## 二、层间依赖关系 ``` ⑤ 治理层 ─── 制定规则 ──→ 所有下层必须遵循 │ │ 产出标准 ▼ ④ 发现层 ─── 让 Agent 找到你 ──→ 是协议层的前提 │ │ 提供元数据 ▼ ③ 协议层 ─── 让 Agent 连接你 ──→ 是设计层的载体 │ │ 定义通信方式 ▼ ② 设计层 ─── 让 Agent 正确使用你 ──→ 是安全层的对象 │ │ 约束行为边界 ▼ ① 安全层 ─── 让 Agent 安全运行 ──→ 保护所有上层 ``` **关键洞察**：每一层都是上一层的前提条件。没有安全层的设计是裸奔；没有发现层的协议是隐身；没有治理层的生态是丛林。 --- ## 三、协议层关系图：MCP vs A2A vs 商务协议 ``` ┌─────────────┐ │ 人类用户 │ └──────┬──────┘ │ 委托 ▼ ┌─────────────┐ │ AI Agent │ │ (客户端) │ └──┬───┬───┬──┘ │ │ │ ┌────────────┘ │ └────────────┐ │ │ │ ▼ ▼ ▼ ┌────────────────┐ ┌────────────┐ ┌────────────────┐ │ MCP 协议 │ │ A2A 协议 │ │ 商务协议 │ │ Agent → Tool │ │ Agent → │ │ Agent → 支付 │ │ │ │ Agent │ │ │ │ "我需要用工具" │ │ "我需要 │ │ "我需要付款" │ │ │ │ 别的Agent │ │ │ │ │ │ 帮忙" │ │ │ └───────┬────────┘ └─────┬──────┘ └───────┬────────┘ │ │ │ ▼ ▼ ▼ ┌────────────────┐ ┌────────────┐ ┌────────────────┐ │ MCP Server │ │ 其他 Agent │ │ Stripe / Visa │ │ (工具/数据) │ │ (协作者) │ │ (支付网关) │ │ │ │ │ │ │ │ 数据库、API、 │ │ 客服Agent、│ │ ACP, TAP, │ │ 文件系统 │ │ 分析Agent │ │ Agent Pay │ └────────────────┘ └────────────┘ └────────────────┘ ─── 垂直连接 ─── ── 水平互操作 ── ── 商务能力 ── ``` **核心关系**：MCP 和 A2A **互补而非竞争**。 | 维度 | MCP | A2A | |------|-----|-----| | 方向 | 垂直（Agent→Tool） | 水平（Agent→Agent） | | 类比 | USB 线（连接设备） | WiFi（设备间通信） | | 对方可见性 | Agent 知道 Tool 内部实现 | Agent 对另一个 Agent 不透明 | | 发现机制 | Server 定义 Tool 列表 | Agent Card (.well-known) | | 典型场景 | 查数据库、调 API | 跨组织 Agent 协作 | --- ## 四、发现层关系图：Agent 如何找到你 ``` Agent 寻找能力 │ ├─── ① 我要找一个网站/产品的信息 │ │ │ ▼ │ ┌──────────┐ ┌───────────────┐ │ │ llms.txt │────▶│ llms-full.txt │ │ │ 摘要索引 │ │ 完整内容 │ │ └──────────┘ └───────────────┘ │ │ │ │ 结构化理解 │ ▼ │ ┌──────────┐ ┌──────────┐ │ │ JSON-LD │◀───▶│Schema.org│ │ │ 语义标注 │ │ 词汇表 │ │ └──────────┘ └──────────┘ │ ├─── ② 我要调用一个 API │ │ │ ▼ │ ┌──────────┐ ┌──────────┐ │ │ OpenAPI │────▶│ Arazzo │ │ │ 端点描述 │ │ 工作流序列│ │ └──────────┘ └──────────┘ │ ├─── ③ 我要在一个代码仓库工作 │ │ │ ▼ │ ┌──────────┐ ┌──────────┐ │ │AGENTS.md │ │CLAUDE.md │ │ │ 通用指令 │ │ Claude专属│ │ └──────────┘ └──────────┘ │ └─── ④ 我要找另一个 Agent 协作 │ ▼ ┌──────────┐ ┌──────────┐ │Agent Card│────▶│ KYA 验证 │ │ 能力声明 │ │ 身份信任 │ └──────────┘ └──────────┘ ``` **关键洞察**：四种发现场景使用四种不同的元数据格式——但它们共享一个原则：**机器可读 > 人类可读**。 --- ## 五、安全层关系图：纵深防御 ``` ┌─────────────────────┐ │ 人类用户 │ │ （最终权限来源） │ └──────────┬──────────┘ │ 委托 + 权限边界 ▼ ┌──────────────────────────────────────────────────────────────┐ │ ┌──────────────────────────────────────────────────────┐ │ │ │ Kill Switch（紧急停止） │ │ │ │ 随时可中断所有 Agent 活动的全局开关 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌─── 第 1 道防线：身份与授权 ──────────────────────────┐ │ │ │ │ │ │ │ KYA ──→ Token Exchange ──→ Scoped Token │ │ │ │ 身份验证 权限降级 有限范围临时令牌 │ │ │ │ │ │ │ │ Policy Engine (OPA/Cedar) ──→ 每次调用实时鉴权 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─── 第 2 道防线：输入验证与消毒 ──────────────────────┐ │ │ │ │ │ │ │ Agent Gateway ──→ 元数据扫描（工具投毒检测） │ │ │ │ │ │ │ │ │ └──→ Prompt 注入检测 ──→ 外部数据消毒 │ │ │ │ │ │ │ │ JSON Schema 验证 ──→ 每个工具调用参数校验 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─── 第 3 道防线：执行隔离 ────────────────────────────┐ │ │ │ │ │ │ │ Sandbox / MicroVM ──→ 每个 MCP Server 独立隔离 │ │ │ │ │ │ │ │ │ └──→ 零信任网络（显式允许 > 默认放行） │ │ │ │ │ │ │ │ 四层预算 ──→ 成本 + Token + 步骤 + 时间 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─── 第 4 道防线：运行时保护 ──────────────────────────┐ │ │ │ │ │ │ │ HITL ──→ 不可逆操作前人类确认 │ │ │ │ │ │ │ │ │ Intent Preview ──→ 意图预览 + Dry-run │ │ │ │ │ │ │ │ │ Circuit Breaker ──→ 连续失败自动熔断 │ │ │ │ │ │ │ │ Graceful Degradation ──→ 降级而非崩溃 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌─── 第 5 道防线：审计与追溯 ──────────────────────────┐ │ │ │ │ │ │ │ Audit Trail ──→ 不可篡改 + 密码学可验证 │ │ │ │ │ │ │ │ │ └──→ 全链路追踪（who/what/why/tools/outcome） │ │ │ │ │ │ │ │ A2A 链路 ──→ 每次交接独立验证身份/权限/负载 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────┘ ``` **关键关系**： ``` Least Privilege（能访问什么） └──→ Least Agency（能做什么 + 做多少次） └──→ HITL（高风险操作人类确认） └──→ Kill Switch（极端情况全局停止） 四者是递进关系：权限 → 行为 → 确认 → 中断 ``` --- ## 六、攻击面与防御映射 ``` ┌─────────────────────────────────────────────────────────────┐ │ 攻击面全景 │ ├──────────────────┬──────────────────┬───────────────────────┤ │ 输入侧攻击 │ 元数据侧攻击 │ 链路侧攻击 │ ├──────────────────┼──────────────────┼───────────────────────┤ │ │ │ │ │ Direct Prompt │ Tool Poisoning │ Cascading │ │ Injection │ 工具投毒 │ Hallucination │ │ 直接注入 │ │ 级联幻觉 │ │ │ │ Schema Poisoning │ │ │ │ │ │ Schema 投毒 │ Memory Poisoning │ │ Indirect Prompt │ │ 记忆投毒 │ │ Injection │ MPMA │ │ │ │ 间接注入 │ 偏好操纵攻击 │ Slopsquatting │ │ │ │ 包名抢注 │ │ │ │ │ ├──────────────────┼──────────────────┼───────────────────────┤ │ 防御措施 │ 防御措施 │ 防御措施 │ ├──────────────────┼──────────────────┼───────────────────────┤ │ │ │ │ │ 输入消毒 │ 元数据扫描 │ 独立验证输入 │ │ 模式匹配检测 │ 版本锁定 │ 不可变共享上下文 │ │ RAG 隔离 │ 代码签名 │ 行为基线监控 │ │ 外部数据消毒 │ 基线监控 │ 依赖锁定 + hash │ │ │ │ │ └──────────────────┴──────────────────┴───────────────────────┘ ``` --- ## 七、设计概念关系图：从理念到实现 ``` ┌──────────────┐ │ AX (理念) │ │ Agent 体验学科 │ └───────┬──────┘ │ 具体化为 ┌───────────┼───────────┐ ▼ ▼ ▼ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ ACI │ │ 10 条 │ │ LLMO │ │接口设计法 │ │ AX 原则 │ │搜索优化法 │ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ │ ┌──────────┤ ┌──────┤ ┌──────┤ ▼ ▼ ▼ ▼ ▼ ▼ ┌─────────┐┌──────┐┌─────┐┌─────┐┌─────┐┌──────┐ │Schema- ││Tool ││Idem-││HATE-││JSON-││llms. │ │First ││Annot.││poten││OAS ││LD ││txt │ │契约优先 ││工具注解││幂等 ││自描述││语义 ││文档 │ └─────────┘└──────┘└─────┘└─────┘└─────┘└──────┘ │ │ │ │ │ │ └──────────┴──────┴──────┴──────┴──────┘ │ ▼ ┌──────────────────┐ │ Outcome-Oriented │ │ Tool Design │ │ 面向结果的工具设计 │ └──────────────────┘ │ ┌──────────┼──────────┐ ▼ ▼ ▼ ┌──────────┐┌──────────┐┌──────────┐ │ 更少工具 ││ 更扁 Schema││ 更丰富描述│ │ (粒度) ││ (结构) ││ (四要素) │ └──────────┘└──────────┘└──────────┘ ``` **核心逻辑**：AX 是顶层理念 → ACI/原则/LLMO 是三个实现方向 → 每个方向分解为具体设计模式 → 所有模式汇聚到"面向结果的工具设计"这一实操方法。 --- ## 八、评估体系关系图 ``` ┌─────────────────────────────────────────────────────────────┐ │ 评估体系全景 │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌─── API 层面（你的 API 对 Agent 友好吗？）────────────┐ │ │ │ │ │ │ │ Postman 48 Checks (0-100 分) │ │ │ │ └─→ 8 支柱 × 6 项 = 48 项检查 │ │ │ │ └─→ 通过线：≥70 分 + 0 Critical 失败 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ │ │ API 通过后 │ │ ▼ │ │ ┌─── 工具层面（你的 Tool 设计合格吗？）────────────────┐ │ │ │ │ │ │ │ 工具质量 10 项评分 (binary pass/fail) │ │ │ │ └─→ 名称/描述/类型/扁平/示例/返回/错误/效率/职责/ns│ │ │ │ └─→ 通过线：≥8/10 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ │ │ 工具通过后 │ │ ▼ │ │ ┌─── 安全层面（你的安全措施到位吗？）──────────────────┐ │ │ │ │ │ │ │ SlowMist MCP 安全清单 (~90 项, High/Med/Low) │ │ │ │ └─→ 通过线：所有 High 项通过 │ │ │ │ │ │ │ │ CoSAI 白皮书 8 项优先建议 │ │ │ │ └─→ 通过线：8/8 实施 │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ │ │ 安全通过后 │ │ ▼ │ │ ┌─── 系统层面（你的 Agent 系统整体可靠吗？）──────────┐ │ │ │ │ │ │ │ Google Cloud 三支柱 (A/B/C/F) │ │ │ │ ├─→ 最终输出（集成测试） │ │ │ │ ├─→ 决策过程（单元测试） │ │ │ │ └─→ 韧性（压力测试） │ │ │ │ │ │ │ │ 复合精度公式 │ │ │ │ └─→ 端到端成功率 = (单步准确率)^步骤数 │ │ │ │ └─→ 10 步工作流通过线：≥80% │ │ │ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────────────────────┘ ``` **评估顺序**：API → 工具 → 安全 → 系统。每一层是下一层的前提。 --- ## 九、治理组织关系图 ``` ┌──────────────────────┐ │ Linux Foundation │ │ 开源治理伞组织 │ └──────────┬───────────┘ │ ┌────────────────┼────────────────┐ ▼ ▼ ▼ ┌────────────────┐ ┌────────────┐ ┌────────────────┐ │ AAIF │ │ AGNTCY │ │ A2A Project │ │ Agentic AI │ │ Agent │ │ Agent-to-Agent │ │ Foundation │ │ 互联网 │ │ Protocol │ │ │ │ │ │ │ │ 创始: │ │ 75+ 公司 │ │ 创始: Google │ │ Anthropic │ │ Cisco │ │ 150+ 组织 │ │ OpenAI │ │ LangChain │ │ │ │ Block │ │ Galileo │ │ │ ├────────────────┤ └────────────┘ └────────────────┘ │ 治理项目: │ │ ├── MCP │ │ ├── AGENTS.md │ ┌─────────────────────┐ │ └── goose │ │ 独立标准组织 │ └────────────────┘ ├─────────────────────┤ │ CoSAI → MCP 安全 │ │ OWASP → LLM/Agent │ │ 安全 Top 10 │ │ OpenAPI → API 描述 │ │ Initiative 标准 │ └─────────────────────┘ ``` --- ## 十、时间线：从碎片到标准化 ``` 2024 │ ├── 09 ── Jeremy Howard 提出 llms.txt 规范 │ ├── 11 ── Anthropic 发布 MCP (Model Context Protocol) │ │ 2025 │ ├── 01 ── Matt Biilmann 命名 AX (Agent Experience) │ ├── 04 ── Google 发布 A2A 协议 (Cloud Next) │ ├── 07 ── A2A 捐赠给 Linux Foundation │ ├── 08 ── AGENTS.md 标准发布 (OpenAI + 多方) │ 60,000+ 仓库采纳 │ ├── 11 ── MCP spec 更新 (服务端身份、异步操作) │ Mastercard Agent Pay 全美上线 │ Visa 完成数百笔 Agent 交易 │ ├── 12 ── AAIF 成立 (Linux Foundation) │ Anthropic 捐赠 MCP │ Agent Skills 标准发布 │ OWASP Top 10 for Agentic Applications │ Meta 收购 Manus │ │ 2026 │ ├── 01 ── CoSAI MCP 安全白皮书 │ A2A 达到 RC 1.0 │ Google 发布 Universal Commerce Protocol │ ├── 02 ── Google 发布 WebMCP (Chrome Canary) │ ├── 03 ── MCP Tool Annotations 博客发布 │ Microsoft 发布端到端 Agent 安全指南 │ └── ── 当前位置 ── ┌──────────────────────────────────────────┐ │ 从"各自为政"到"统一标准"用了不到 2 年 │ │ 类比 HTTP 标准化花了 ~5 年 (1991-1996) │ │ Agent 生态标准化的速度快了 2.5 倍 │ └──────────────────────────────────────────┘ ``` --- ## 十一、概念分类矩阵：按角色 × 关注层 ``` 你是谁？ │ ├── API/产品开发者 ──────────────────────────────┐ │ "我要让 Agent 能用我的 API" │ │ │ │ 必须掌握: │ │ ├── AX 10 原则 │ │ ├── OpenAPI spec 完整度 │ │ ├── llms.txt │ │ ├── 错误响应格式 │ │ ├── Idempotency │ │ ├── Content Negotiation │ │ ├── Postman 48 Checks │ │ └── JSON-LD / Schema.org │ │ │ ├── MCP Server 开发者 ───────────────────────────┤ │ "我要给 Agent 提供工具" │ │ │ │ 必须掌握: │ │ ├── ACI (Agent-Computer Interface) │ │ ├── Tool Design 7 子规约 │ │ │ (命名/描述/inputSchema/outputSchema/ │ │ │ 错误/注解/粒度) │ │ ├── Outcome-Oriented 设计 │ │ ├── Schema-First │ │ ├── MCP 协议细节 │ │ ├── SlowMist 安全清单 │ │ └── 工具质量 10 项评分 │ │ │ ├── Agent 系统架构师 ────────────────────────────┤ │ "我要构建多 Agent 系统" │ │ │ │ 必须掌握: │ │ ├── A2A 协议 + Agent Card │ │ ├── Agent Skills │ │ ├── Least Agency (非仅 Least Privilege) │ │ ├── 纵深防御五道防线 │ │ ├── 级联幻觉 / 记忆投毒防御 │ │ ├── 复合精度公式 │ │ ├── Google 三支柱评估 │ │ ├── KYA (Know Your Agent) │ │ └── Token Exchange (RFC 8693) │ │ │ └── 安全工程师 ──────────────────────────────────┤ "我要保证 Agent 系统安全" │ │ 必须掌握: │ ├── 10 条不可协商安全约束 │ ├── 8 类攻击向量 + 防御映射 │ ├── CoSAI 白皮书 8 项建议 │ ├── OWASP LLM/Agentic Top 10 │ ├── SlowMist MCP 安全清单 │ ├── Prompt 不是安全边界（铁律） │ ├── Sandbox / MicroVM 隔离 │ ├── Policy Engine (OPA/Cedar) │ └── 不可篡改审计日志 │ │ ────────────────────────────────────────────────┘ ``` --- ## 十二、一张图总结：Agent Friendly 的本质 ``` ┌─────────────────────────────────────────────────────────────┐ │ │ │ Agent Friendly 的本质 │ │ │ │ = 好工程实践 × 强制化程度 │ │ │ │ ┌────────────────────┐ ┌────────────────────┐ │ │ │ 人类开发者时代 │ │ Agent 消费者时代 │ │ │ ├────────────────────┤ ├────────────────────┤ │ │ │ 好命名 → "建议" │ ──▶│ 好命名 → "必须" │ │ │ │ 类型化 → "最好有" │ ──▶│ 类型化 → "必须" │ │ │ │ 错误信息 → "方便" │ ──▶│ 错误信息 → "必须" │ │ │ │ 文档 → "对人有帮助" │ ──▶│ 文档 → "对机器可解析"│ │ │ │ 幂等性 → "好实践" │ ──▶│ 幂等性 → "必须" │ │ │ │ 最小权限 → "安全建议"│ ──▶│ 最小权限 → "不可协商"│ │ │ └────────────────────┘ └────────────────────┘ │ │ │ │ ────────────────────────────────────────────────── │ │ │ │ 每一个"新"标准都不是新发明: │ │ │ │ MCP ──────────── 借鉴了 ──→ LSP (Language Server Protocol) │ │ llms.txt ──────── 借鉴了 ──→ robots.txt │ │ Agent Card ────── 借鉴了 ──→ .well-known URI (RFC 5785) │ │ AX ──────────── 借鉴了 ──→ DX (Developer Experience) │ │ AGENTS.md ────── 借鉴了 ──→ README.md / CONTRIBUTING.md │ │ A2A ──────────── 借鉴了 ──→ HTTP + Service Discovery │ │ Tool Annotations ─ 借鉴了 ─→ HTTP Method Semantics │ │ │ │ ────────────────────────────────────────────────── │ │ │ │ Agent Friendly 不是革命，是好设计的自然演进。 │ │ 人类容忍的模糊性，Agent 不能容忍。 │ │ 当 Agent 成为主要消费者，"建议"变成了"必须"。 │ │ │ └─────────────────────────────────────────────────────────────┘ ``` --- ## 十三、完整画面：被调用方 + 构建方 ``` Agent Friendly 完整画面 ┌─────────────────────────────────────────────────────────────┐ │ │ │ 被调用方（你的系统） 构建方（Agent Harness） │ │ Agent Friendly 规约 Harness Engineering │ │ ══════════════════ ═══════════════════ │ │ │ │ "怎么让 Agent 用好 "怎么给 Agent 建好 │ │ 你的系统" 运行环境" │ │ │ │ ┌──────────────┐ ┌──────────────┐ │ │ │ §5 发现层 │ │ s05 知识加载 │ │ │ │ llms.txt │◀──找到──▶ │ 两层按需加载 │ │ │ │ Agent Card │ │ │ │ │ ├──────────────┤ ├──────────────┤ │ │ │ §2 工具设计 │ │ s02 工具调度 │ │ │ │ Schema/描述 │◀──调用──▶ │ 调度映射+沙箱 │ │ │ │ 7 子规约 │ │ │ │ │ ├──────────────┤ ├──────────────┤ │ │ │ §3 API 设计 │ │ s01 Agent Loop│ │ │ │ 10 条 AX 原则 │◀──交互──▶ │ 30 行核心循环 │ │ │ ├──────────────┤ ├──────────────┤ │ │ │ §4 安全规约 │ │ s04/s12 隔离 │ │ │ │ 10 条安全约束 │◀──保护──▶ │ Subagent + │ │ │ │ │ │ Worktree │ │ │ ├──────────────┤ ├──────────────┤ │ │ │ §6 评估规约 │ │ 12 课渐进验证 │ │ │ │ Postman 48 │ │ 3.6KB → 36KB │ │ │ └──────────────┘ └──────────────┘ │ │ │ │ │ │ └───────────┬───────────────┘ │ │ ▼ │ │ ┌────────────────┐ │ │ │ Agent 成功完成 │ │ │ │ 用户的任务 │ │ │ └────────────────┘ │ │ │ │ 共享哲学根基： │ │ 1. 模型比你想的更聪明 → 给好 Schema，不预设工作流 │ │ 2. 约束是最好的礼物 → NEVER 清单 > 功能列表 │ │ 3. 好设计是透明的 → 你几乎忘记它的存在 │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Harness 12 课与规约概念的逐项映射 ``` ┌─────────────────────────────────┬────────────────────────────────┐ │ Harness Engineering │ Agent Friendly 规约 │ │ (构建方) │ (被调用方) │ ├─────────────────────────────────┼────────────────────────────────┤ │ s01 Agent Loop │ — (规约不涉及 Agent 内部循环) │ │ s02 Tool dispatch + safe_path │ §2 Tool Design + §4 Least Agency│ │ s03 TodoWrite 一次一个 │ P2 约束>能力 │ │ s04 Subagent 上下文隔离 │ §4 Sandbox / 隔离 │ │ s05 Skill 两层加载 │ §5 发现层 (llms.txt 索引+全文) │ │ s06 Context Compact │ — (Harness 独有：内部记忆管理) │ │ s07 Task DAG 磁盘持久 │ Agent Skills 标准 │ │ s08 Background tasks │ — (Harness 独有：异步执行管理) │ │ s09 Team mailbox │ A2A 协议 (简化版) │ │ s10 Shutdown/Plan protocols │ HITL + Agent 协商 │ │ s11 Autonomous task claiming │ Agent Card 发现 (去中心化) │ │ s12 Worktree isolation │ §4 Sandbox / MicroVM (轻量版) │ │ mcp-builder skill │ §2 + §3 全部 (MCP Server 构建) │ │ "Trust the model" (全局) │ P2 约束>能力 (同一哲学) │ ├─────────────────────────────────┼────────────────────────────────┤ │ 独有领域：循环、上下文、持久化 │ 独有领域：Schema、发现、评分 │ │ 关注动词：加载、隔离、持久化 │ 关注动词：暴露、描述、约束 │ └─────────────────────────────────┴────────────────────────────────┘ ``` --- ## 附录：五份文档的关系 ``` ┌─────────────────────────────────────────────────────────────┐ │ │ │ deep-research.md 本质：证据层 │ │ 原始研究素材 "数据和来源在这里" │ │ (289 行) │ │ │ │ │ │ 提炼出 │ │ ▼ │ │ glossary.md 本质：知识层 │ │ 概念与名词解释 "每个概念是什么意思" │ │ (1001 行, ~115 概念) │ │ │ │ │ │ 揭示关系 │ │ ▼ │ │ architecture.md 本质：结构层 │ │ 概念关系与架构图 "概念之间如何连接" │ │ (761 行, 13 张图) │ │ │ │ │ │ 转化为约束 │ │ ▼ │ │ development-spec.md 本质：规约层 │ │ 开发规约 v1.0 "必须/禁止做什么" │ │ (519 行, 25 NEVER) │ │ │ │ │ │ 补充构建方视角 │ │ ▼ │ │ harness-engineering.md 本质：实现层 │ │ Harness Engineering 分析 "Agent 内部怎么运作" │ │ (359 行, 12 课映射) │ │ │ │ 五层关系: 证据 → 知识 → 结构 → 约束 → 实现 │ │ │ └─────────────────────────────────────────────────────────────┘ ```