Agent Service Spec v1

v1 是 Agent Service 平台的首个完整目标态规范版本。

内容索引

• overview/
  • 平台系统模型、术语、ID 与版本、幂等与一致性、安全模型
• domains/
  • 组织、Agent、AgentRevision、Tool、ToolRevision、McpServer、McpServerRevision、CallableGrant、ReleaseChannel、ProtocolBinding、RunSpace、Run、RunLink、Interaction Request、Message、Artifact、Checkpoint、Webhook、Session、RuntimeConnection、Tracing
• state-machines/
  • Run 生命周期、Runtime 连接、输出投影、Provider 生命周期、Span 生命周期
• api/
  • 控制面 OpenAPI、读面 OpenAPI、runtime SDK 逻辑 API、runtime SDK 实现推荐、runtime tracing 逻辑 API、runtime connection AsyncAPI、run stream AsyncAPI、trace export AsyncAPI、A2A/ACP/AG-UI 协议档案与 MCP server 档案
• schemas/
  • 共享 JSON Schema
• conformance/
  • 不变量、偏离记录、测试矩阵
• examples/
  • 命令、事件、流式样例

v1 设计原则

• spec-first
• 事件为真源
• 资源模型与 transport 解耦
• 稳定资源身份与不可变 revision 解耦
• McpServer 作为 MCP server-first 集成的 canonical 资源
• 北向协议面与 canonical 资源模型解耦，但语义强绑定
• 交互阻塞模型是平台一等对象，而不是某个协议的附属字段
• 多语言实现共享同一份契约
• 明确 tenant、身份、幂等、排序与恢复语义
• Tracing 是平台级可治理能力，而不是某个 SDK 的私有辅助工具
• Tracing 需要同时支持平台原生模型与 OTel-compatible context / GenAI 语义