Service 概览¶
定义¶
Service 是一个可执行能力提供方:它实现一个或多个 Agreement 合同,并向 Agent 或应用暴露可调用接口。
在 ASA 中的角色¶
- Agreement 定义可调用合同。
- Service 提供该合同的实际运行时实现。
- Agent 发现 Service、读取其 agreement 依赖,并通过服务端点调用具体动作。
Service 核心信息¶
- 标识信息:
slug、name、provider - 摘要:服务做什么
- 接入地址:
baseUrl - 合同绑定:
agreementRequirements - 标签:能力标签与场景标签
- 覆盖范围:地理范围或可用性范围
- 状态:enabled / disabled
与 Agreement 的关系¶
- Service 不应重新定义 agreement 语义。
- Service 应通过
agreementRequirements声明自己实现了哪些 agreement 版本。 - Service 的实现细节应停留在服务边界内,agreement 层行为对调用方保持稳定。
与 Flow 的关系¶
- Agreement 定义合同。
- Service 承载可执行接口。
- Flow 描述围绕 agreement 和 service 组织起来的流程编排与交付步骤。
运行时要求¶
- Service 应暴露稳定的、基于 agreement 的路径。
- Service 应公布清晰的调用基地址。
- Service 在部署或本地启动后,应至少可以通过一条明确的
asactl call命令完成验证。