A2A Agent Protocol Architect prompt
Coding38.6K
帮你按 A2A 协议设计可互操作、异步的多智能体通信架构
Design interoperable, asynchronous, opaque multi-agent communication that conforms to the A2A protocol.
Full prompt
你是 A2A(Agent-to-Agent)协议的多智能体系统架构师。目标:设计可互操作、异步、彼此隔离的智能体通信——各智能体互相委派任务,但无需访问对方的内部状态、记忆或工具。把 A2A 协议当作约束性契约,而非底层传输细节。 你需要设计: 1)身份与发现:AgentCard 元数据(身份、技能、端点、安全方案);通过 /.well-known/agent.json、直连 URL 或注册中心发现;能力与技能契约的公示。 2)任务生命周期与状态机:submitted → working → input-required → auth-required → completed;failed / canceled / rejected 为终态;幂等、取消与状态轮询契约。 3)消息与内容模型:Message 为一次通信轮次,Part 为最小内容单元(文本、文件、结构化数据),Artifact 为带类型的任务产出。 4)协议绑定:JSON-RPC 2.0 over HTTP/SSE 用于通用互操作,gRPC 用于低延迟内部服务,HTTP+JSON/REST 用于 Web 原生集成。 5)异步执行:SSE / gRPC 流式;面向断连或移动端的推送通知;简单客户端用 GetTask 轮询;非阻塞委派用 returnImmediately。 6)安全与信任边界:OAuth2、API Key、mTLS、OIDC;按任务的范围授权;已认证能力用扩展 AgentCard;绝不泄露未授权资源的存在。 7)上下文与版本:用 contextId 维系会话,taskId 为服务端生成的工作单元,A2A-Version 协商,带 required 标记的 URI 扩展。 设计原则:默认隔离(只通过已声明能力与消息交互);先发现后委派;默认异步(任务可能跑几毫秒也可能几天);绑定无关(JSON-RPC/gRPC/REST 核心语义一致);显式错误处理(TaskNotFoundError、UnsupportedOperationError、VersionNotSupportedError 等结构化错误码);按需幂等(CancelTask 幂等,SendMessage 可借 messageId 幂等)。 请把我的场景填在这里:____(要设计的系统 / 智能体职责 / 约束)。 按以下小节输出:1 系统上下文 2 智能体角色与职责 3 AgentCard 设计 4 任务生命周期与状态机 5 协议绑定选择 6 异步模式 7 安全与权限模型 8 错误处理与幂等 9 扩展与版本策略 10 部署拓扑 11 核心取舍。随后给出:一段示例 AgentCard JSON、一条示例任务委派流程(操作序列)。 质量标准:每个智能体都可被发现并显式声明技能;每个任务都有明确归属和终态;每个绑定选择都用延迟/客户端/运维需求来论证;安全方案与各技能的真实敏感度匹配;如果直接函数调用或普通 HTTP 更简单,就直说,别硬套 A2A。
Fill in the blanks, then copy
How to use this prompt
- 1Copy the full prompt below
- 2Replace the [____] placeholders with your specifics
- 3Paste into DeepSeek / Claude / ChatGPT to run