OpenASA 文档

OpenASA 是一个面向 AI Agent 时代开放标准的非盈利公共机构。

本文档围绕 ASA（Agent Service Agreement，代理服务协议） 展开，介绍其定义、理念、协议模型、OAuth Provider 能力与运行时/API 边界。

名词关系

名称	它是什么	主要用途	下一步看哪里
OpenASA	公共组织名，也是运行时/API 项目的外部边界	标准、运行时模块、公开 API	指南
ASA	协议模型本身	理解基于 agreement 的交互方式	OpenASA 基础
ASAHub	构建在 ASA 之上的 Hub 产品	浏览、发布、评论、协作	ASAHub 文档
asactl	命令行客户端	本地工作区操作、协议获取、远程调用	ASAHub CLI 文档

结构

• 指南：概念说明、协议模型、OAuth Provider 接入与上手指引。
• Service：说明可执行服务与 agreement、flow、运行时调用之间的关系。
• API：按模块目录组织的接口文档与详细 endpoint 页面。
• 快速开始：基于 CLI 的最短体验路径。

按目标进入

• 我想先理解 ASA：从 OpenASA 基础 开始。
• 我想接 API 或 OAuth：看 API 概览 或 OAuth。
• 我想先跑通一条最短路径：看 快速开始。

当前状态

• 文档正随着当前项目方案持续完善。
• 当前版本以“概念讲清楚 + 可执行快速体验”为目标。