Agent Service Spec v1

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

内容索引

• overview/
  • 平台系统模型、术语、ID 与版本、幂等与一致性、安全模型
• domains/
  • 组织、Agent、Tool、Run、Message、Artifact、Checkpoint、Webhook、Sandbox Session、Tracing
• state-machines/
  • Run 生命周期、Runtime 连接、输出投影、Provider 生命周期、Span 生命周期
• api/
  • 控制面 OpenAPI、读面 OpenAPI、runtime tracing 逻辑 API、runtime session AsyncAPI、run stream AsyncAPI、trace export AsyncAPI、A2A/AG-UI/MCP 映射
• schemas/
  • 共享 JSON Schema
• conformance/
  • 不变量、兼容性说明、测试矩阵
• examples/
  • 命令、事件、流式样例

v1 设计原则

• spec-first
• 事件为真源
• 资源模型与 transport 解耦
• 多语言实现共享同一份契约
• 明确 tenant、身份、幂等、排序与恢复语义
• Tracing 是平台级可治理能力，而不是某个 SDK 的私有辅助工具
• Tracing 需要同时支持平台原生模型与 OTel-compatible context / GenAI 语义