AI 工程从零到一（中文）

给定 client、后端、授权要求和合规约束，产出一份网关设计。

必需输入

• 公开网关 resource URI、接受的协议修订版和传输方式。
• 已认证的主体和角色模型。
• 后端端点、issuer、resource、注册表记录、发布者证据和已批准描述符。
• 工具可见性、参数策略、成本类别和数据敏感度。
• 流、变更通知、MRTR 和 Tasks 要求。
• 审计、保留、追踪和脱敏要求。

产出

1. 无状态入口。一个 POST 端点、逐请求版本和能力、匹配的方法和名称头、JSON 或请求范围内的 SSE，以及现代 GET 和 DELETE 的 405。先校验头部相等性，再校验版本支持。指定 HTTP 400 -32020、携带精确 supported 和 requested data 的 HTTP 400 -32022、HTTP 404 -32601、可选错误 data 的序列化，以及 202 空 body notification 处理。
2. 发现计划。实现网关 server/discover，发现每个后端，只暴露安全的端到端能力交集，并包含当前 resultType、ttlMs、cacheScope 和 server 身份元数据。
3. 准入表。分别校验官方 Registry server.json 的发布形状与 com.example/* 风格名称，不把它们等同于安全准入。对每个后端，将记录关联到外部已验证的发布者命名空间、溯源来源、端点、版本策略、描述符摘要、issuer、resource、批准和过期状态。
4. 命名空间映射。为每个后端工具分配稳定的限定公开名称，并在每个 tools/list 描述符上保留有效的对象根级别 inputSchema。拒绝按顺序解决碰撞。
5. 授权矩阵。将主体和角色映射到公开工具、resource、参数和 scope。外层与后端凭证保持分离，并与 issuer 绑定。
6. 转发契约。构建全新的自包含后端请求，仅声明经调解的 client 能力，校验后端结果，并保留 trace 关联。
7. 缓存计划。将依赖主体的发现和列表设为私有。设置有界 TTL 和失效行为。
8. 限流和审计策略。以主体、issuer、resource、工具、成本类别和时间为键。脱敏凭证和不必要的敏感参数。
9. 交互路由。描述请求范围内的 SSE、subscriptions/listen 确认和重新连接行为、逐字节转发 MRTR 状态，以及通过 Mcp-Name 中的任务 id 进行 Tasks 路由。
10. 传输 adapter。如果网关接收已解析的请求和头部，则将其标记为进程内协议模型，并连接到第 09 课，实施 JSON Content-Type 以及 JSON 加 SSE Accept 要求。
11. 兼容 adapter。把旧版初始化、会话 id、GET 流、资源订阅和实验性任务方法隔离在现代网关核心之外。

必须拒绝

• 将会话亲和性、会话存储或重写 session id 表述为 2026-07-28 的必需项。
• 没有准入证据就相信注册表存在或展示名称。
• 静默处理工具碰撞，或在未经重新批准时更新描述符钉定。
• 在后端复用外层 bearer token，或在另一 issuer 或 resource 上复用后端 token。
• 公开缓存按主体过滤的列表。
• 独立的现代 GET event stream、Last-Event-ID 重放或资源订阅方法。
• 新增 tasks/list 或 tasks/result 行为。
• 限流只以已移除的协议会话为键。
• 在 server.json 内虚构安全验证，而非使用独立且已验证的准入与溯源状态。
• 省略 inputSchema 的命名空间工具描述符。

输出格式

返回名为 Ingress、Discovery、Admission、Namespace Map、Authorization、Forwarding、Cache、Rate Limits、Audit、Interactions 和 Legacy Adapter 的章节。以需要最强验收测试的一条路由结尾。