驱动一切的 规范 �?/span>
AI-Protocol 将「做什么」与「怎么做」分离。V2 规范采用三层架构：核心协�?→ 能力扩展 → 环境配置。供应商清单声明端点、认证、参数映射、流式解码器和错误处�?�? 全部使用 YAML，全部由 JSON Schema 验证�?
V2 三层架构
V2 将规范组织为三层�?strong class="text-[var(--text)]">核心协议（基础聊天、流式、错误）→ 能力扩展（工具、视觉、结构化输出�?rarr; 环境配置（供应商特定配置）。V2-alpha 清单已支�?OpenAI、Anthropic �?Gemini�?
协议内容
核心规范
定义标准参数（temperature、max_tokens）、流式事件（PartialContentDelta、ToolCallStarted）、错误类型（13 种）和重试策略�?
37 供应商清�?/h3>
每个 YAML 文件声明供应商的端点、认证、参数映射、SSE 解码器配置、错误分类、限速响应头和能力�?
模型注册�?/h3>
模型实例包含供应商引用、上下文窗口、能力标志和�?token 计价。支�? GPT、Claude、Gemini、DeepSeek、Qwen 等�?
JSON Schema 验证
JSON Schema 2020-12 定义验证每个清单。CI 流程确保配置正确。零运行时意外�?
供应商清单示�?/h2>
每个供应商由一�?YAML 清单描述。它声明运行时与供应商通信所需的一�?�? 端点、认证、参数映射、流式解码器、错误处理与能力�?
运行时读取这些清单，将用户请求「编译」为供应商特定的 HTTP 调用。无需任何 if provider == "openai" 分支�?
- 端点与认�?/strong> �?基础 URL、协议、Bearer 令牌、API 密钥�?/span >
- 参数映射 �?标准名称到供应商特定 JSON 字段
- 流式解码�?/strong> �?SSE/NDJSON 格式、JSONPath 事件提取规则
- 错误分类 �?HTTP 状态码�?13 种标准错误类�?/span >
id: anthropic
protocol_version: "1.0.0"
endpoint:
base_url: "https://api.anthropic.com/v1"
chat_path: "/messages"
auth:
type: bearer
token_env: "ANTHROPIC_API_KEY"
parameter_mappings:
temperature: "temperature"
max_tokens: "max_tokens"
stream: "stream"
streaming:
decoder:
format: "anthropic_sse"
event_map:
- match: "$.type == 'content_block_delta'"
emit: "PartialContentDelta"
error_classification:
by_http_status:
"429": "rate_limited"
"401": "authentication"
capabilities:
streaming: true
tools: true
vision: true协议所处位�?/h2>
AI-Protocol 是基础层。运行时消费它，应用消费运行时�?
支持的供应商
每个供应商都有完整的 YAML 清单，包含端点、认证、参数映射、流式解码器、错误处理与能力标志�?