KEEL · 龙骨 · A CURRICULUM FOR THE AI ERA
术语表 — keel 龙骨
A2A Protocol Engineering 的参考信息：术语表
| 术语 | 本课程里的工作定义 |
|---|---|
| User | 发起请求的最终用户（人或服务），通常不直接参与协议交互。 |
| A2A Client | 代表 User 向远端 Agent 发起请求的客户端 Agent，即调用方。 |
| A2A Server | 远端 Agent（Remote Agent），对客户端不透明，只暴露卡面与任务状态。 |
| Agent Card | 远端 Agent 的自描述文档，发布在 /.well-known/agent-card.json。 |
| AgentInterface | 一个可访问的端点：url + protocolBinding + protocolVersion，有序数组中第一项为首选。 |
| protocolBinding | 传输绑定：JSONRPC / GRPC / HTTP+JSON，字符串开放形式。 |
| Skill | 远端 Agent 声明的一项能力（如 diagnose.incident），客户端据此决定派什么活。 |
| Message | 一次交互轮次的载体，携带若干 Part，角色为 ROLE_USER 或 ROLE_AGENT。 |
| Part | Message/Artifact 的内容单元，text / raw / url / data 四选一，v1.0 去掉了 kind 判别符。 |
| Artifact | 远端 Agent 产出的结果对象，可增量追加，也可被 lastChunk 标记结束。 |
| Task | 一次有状态委派的工作单元，携带唯一 id、状态、历史与产物。 |
| TaskState | 9 个枚举值（如 TASK_STATE_WORKING），其中 4 个终态、2 个中断态。 |
| 终态 | COMPLETED / FAILED / CANCELED / REJECTED，不再变化，重复推进必须幂等。 |
| 中断态 | INPUT_REQUIRED / AUTH_REQUIRED，任务仍活着，需要客户端补东西才能继续。 |
| A2A-Version | 逐请求协商版本的 HTTP 头，只协商 Major.Minor，补丁版本不参与。 |
| 签名卡 | 用 JWS + JCS（RFC 8785）规范化的 Agent Card，规范化时排除 signatures。 |
| 扩展卡 | GetExtendedAgentCard 返回的、对已认证调用方可见的更完整卡面。 |
| 推送通知配置 | 客户端注册的回调地址，任务状态变化时由服务端主动通知。 |
| 游标分页 | ListTasks 的 pageSize / pageToken / nextPageToken 机制。 |