SuperAPI AI 工具集

ag2-a2a

智能体与模型

查看项目

更新于 10-15 19:49

技能介绍

用途:把 AG2 Agent 通过 Agent-to-Agent(A2A)协议暴露为网络服务,供非 AG2 的 A2A 客户端跨进程/主机调用;反向也可让 AG2 Agent 以 A2AConfig 作为模型配置去调用远程 A2A 智能体。

主要能力:提供可发现的 AgentCard(/.well-known/agent-card.json),描述技能、传输方式、认证与能力;支持 JSON-RPC、REST、gRPC 传输,可同时暴露多种;支持 bearer/API key/OAuth2/OIDC/mTLS 等认证方案声明、推送通知与多租户。公开 API 为 A2AConfig、A2AServer、build_card。

使用方式:安装 pip install "ag2[a2a]"(gRPC 另需 a2a-sdk[grpc])。用 A2AServer(agent).build_jsonrpc(url=...) 得到 Starlette ASGI 应用,再用 uvicorn 启动;build_rest、build_grpc 类似。调用方用 A2AConfig(card_url=...) 配置 Agent 后 ask() 即可。可用 build_card 自定义卡片,用 ag2.a2a.security 的工厂与 require 声明认证,用 ag2.a2a.testing 做无网络进程内测试。

限制:A2A 无中间件规范,认证仅声明不强制,需自行在 Starlette/gRPC 对象上实施;执行器无状态,每轮请求自带完整历史;url 是公开地址而非绑定地址;build_grpc 必须提供 grpc_url。若只需 Web 前端应改用 AG-UI 技能。