跳转至

Service 概览

定义

Service 是一个可执行能力提供方:它实现一个或多个 Agreement 合同,并向 Agent 或应用暴露可调用接口。

在 ASA 中的角色

  • Agreement 定义可调用合同。
  • Service 提供该合同的实际运行时实现。
  • Agent 发现 Service、读取其 agreement 依赖,并通过服务端点调用具体动作。

Service 核心信息

  • 标识信息:slugnameprovider
  • 摘要:服务做什么
  • 接入地址:baseUrl
  • 合同绑定:agreementRequirements
  • 标签:能力标签与场景标签
  • 覆盖范围:地理范围或可用性范围
  • 状态:enabled / disabled

与 Agreement 的关系

  • Service 不应重新定义 agreement 语义。
  • Service 应通过 agreementRequirements 声明自己实现了哪些 agreement 版本。
  • Service 的实现细节应停留在服务边界内,agreement 层行为对调用方保持稳定。

与 Flow 的关系

  • Agreement 定义合同。
  • Service 承载可执行接口。
  • Flow 描述围绕 agreement 和 service 组织起来的流程编排与交付步骤。

运行时要求

  • Service 应暴露稳定的、基于 agreement 的路径。
  • Service 应公布清晰的调用基地址。
  • Service 在部署或本地启动后,应至少可以通过一条明确的 asactl call 命令完成验证。

相关 API 文档