规范优先
Markdown 规范与机器可读契约在同一套版本化源树中统一维护。
主题
Agent as a Service Spec面向 Agent 平台的版本化规范
以规范为中心定义控制面、运行时会话、Tracing、协议、Schema 与示例，并输出适合手机浏览器阅读的静态文档站点。
Skip to content
想先了解产品定位、生态兼容和运行保障，再回到规范细节，可先阅读 Agent as a Service Whitepaper。
版本
- v1 - 当前版本
简介
agent-service-spec 定义一个绿地的 Agent as a Service 平台规范，包括资源模型、控制面 API、读/流接口、runtime session 协议、事件模型、一致性规则与实现符合性要求。
本目录只包含规范，不绑定任何特定产品实现，也不预设任何现有系统已经符合本规范。
当前稳定版本
v1: 初始平台级规范
阅读顺序
GOVERNANCE.mdv1/overview/system-model.mdv1/overview/terminology.mdv1/domains/tracing.mdv1/state-machines/run-lifecycle.mdv1/api/control-plane.openapi.yamlv1/api/read-plane.openapi.yamlv1/api/trace-export.asyncapi.yamlv1/conformance/invariants.md
规范边界
- 规范描述逻辑能力与外部契约，不绑定任何特定服务目录结构或代码仓布局。
- 规范优先于实现命名与字段漂移；实现需要向规范收敛。
- 机器可读文件与 Markdown 共同构成正式交付物。
文档约定
- 正文使用中文。
- 文件名、schema 名称、字段名、枚举值、协议方法名使用英文稳定命名。
- 规范性关键词
MUST、SHOULD、MAY的含义见 GOVERNANCE.md。