A2A Protocol 技术文档
核心主题
A2A 企业级特性

A2A 企业级特性

A2A 协议把企业需求放在设计核心。它不去发明新的私有安全与运维标准，而是力求与现有企业基础设施和广泛采用的最佳实践无缝集成，让组织能够继续利用在安全、监控、治理和身份管理方面已有的投入与经验。

A2A 的一个关键原则是：智能体通常是不透明的，彼此不共享内部记忆、工具，也不直接访问对方的资源。这种不透明性天然契合标准的客户端-服务器安全范式，把远程智能体当作标准的、基于 HTTP 的企业应用来对待。

传输层安全（TLS）

保证传输中数据的机密性和完整性是任何企业应用的基础。

  • 强制 HTTPS：生产环境中，所有 A2A 通信都必须通过 HTTPS 进行。
  • 现代 TLS 标准：实现应使用现代 TLS 版本，推荐 TLS 1.2 或更高，并采用业界标准的强加密套件，防止窃听和篡改。
  • 服务器身份校验：A2A 客户端应在 TLS 握手期间，依据受信任的证书颁发机构校验 A2A 服务器的 TLS 证书，以防范中间人攻击。

认证

A2A 把认证委托给标准 Web 机制，主要依赖 HTTP 头和 OAuth2、OpenID Connect 等既有标准。认证要求由 A2A 服务器在 Agent Card 中声明。

  • 载荷中不携带身份：A2A 协议消息本身不直接携带用户或客户端的身份信息，身份在传输层/HTTP 层确立。
  • Agent Card 声明：A2A 服务器通过 Agent Card 的 securitySchemes 声明支持的认证方案，并通过 securityRequirements 声明要求；这些方案与 OpenAPI 规范中定义的认证方式保持一致。
  • 带外获取凭据：A2A 客户端通过 A2A 协议之外的流程（如 OAuth 流程或安全的密钥分发）获取所需的凭据，例如 OAuth 2.0 令牌或 API Key。
  • 通过 HTTP 头传输：凭据必须按所选认证方案的要求放在标准 HTTP 头中，例如 Authorization: Bearer <TOKEN> 或 API-Key: <KEY_VALUE>。
  • 服务端校验：A2A 服务器必须使用 HTTP 头中提供的凭据对每个传入请求进行认证。认证失败或缺少凭据时，服务器应返回标准 HTTP 状态码：
    • 401 Unauthorized：凭据缺失或无效，响应应包含 WWW-Authenticate 头，告知客户端支持的认证方式；
    • 403 Forbidden：凭据有效，但已认证的客户端无权执行所请求的操作。
  • 任务内认证（次要凭据）：如果智能体在任务过程中需要额外凭据来访问其他系统或服务（例如代表用户使用某个特定工具），A2A 服务器会向客户端表明需要更多信息（任务进入 TASK_STATE_AUTH_REQUIRED 状态）。客户端负责通过 A2A 协议之外的流程（如 OAuth 流程）获取这些次要凭据，并回传给 A2A 服务器以继续任务。

授权

客户端通过认证后，由 A2A 服务器负责对请求授权。授权逻辑取决于智能体的实现、所处理的数据以及适用的企业策略。

  • 细粒度控制：授权应基于已认证的身份，该身份可以代表终端用户、客户端应用或两者。
  • 基于技能的授权：可以按 Agent Card 中公布的技能分别控制访问。例如，特定的 OAuth scope 应允许已认证客户端调用某些技能，而不允许调用其他技能。
  • 数据与操作级授权：智能体如果与后端系统、数据库或工具交互，在执行敏感操作或通过这些底层资源访问敏感数据之前，必须实施相应的授权，智能体扮演守门人的角色。
  • 最小权限原则：智能体必须只授予客户端或用户通过 A2A 接口完成预期操作所必需的权限。

数据隐私与机密性

保护智能体之间交换的敏感数据至关重要，需要严格遵守隐私法规和最佳实践。

  • 敏感性意识：实现者必须充分意识到 A2A 交互中 Message 和 Artifact 的 Part 所承载数据的敏感程度。
  • 合规：根据所属领域和涉及的数据，确保符合 GDPR、CCPA、HIPAA 等相关数据隐私法规。
  • 数据最小化：避免在 A2A 交换中包含或索取不必要的敏感信息。
  • 安全处理：按企业数据安全策略和法规要求，保护传输中的数据（按要求使用 TLS）以及智能体持久化存储的数据。

追踪、可观测性与监控

A2A 基于 HTTP，可以方便地与标准的企业追踪、日志和监控工具集成，为智能体之间的工作流提供关键可见性。

  • 分布式追踪：A2A 客户端和服务器应参与分布式追踪系统。例如使用 OpenTelemetry，通过 W3C Trace Context 等标准 HTTP 头传播追踪上下文（包括 trace ID 和 span ID），实现端到端的调试与性能分析。
  • 全面日志：在客户端和服务端记录详细日志，包括 taskId、contextId、关联 ID 和追踪上下文，用于排障和审计。
  • 指标：A2A 服务器应暴露关键运行指标，如请求速率、错误率、任务处理延迟和资源利用率，支撑性能监控、告警和容量规划。
  • 审计：对重要事件（如任务创建、关键状态变化和智能体行为）进行审计，尤其是涉及敏感数据或高影响操作时。

API 管理与治理

对于对外暴露、跨组织边界、甚至大型企业内部的 A2A 服务器，强烈建议与 API 管理方案集成，以获得：

  • 集中的策略执行：一致地应用认证与授权、限流和配额等安全策略；
  • 流量管理：负载均衡、路由与协议转换；
  • 分析与报表：了解智能体的使用情况、性能和趋势；
  • 开发者门户：便于发现支持 A2A 的智能体，提供 Agent Card 等文档，简化客户端开发者的接入。

遵循这些企业级实践，A2A 实现就能在复杂的组织环境中安全、可靠、可管理地部署，建立信任，并支撑可扩展的智能体间协作。

进一步阅读

来源：A2A 官方文档 · Enterprise-Ready

A2A 智能体发现多租户与多智能体路由