A2A Agent Card Policy

Policy Name

A2A Agent Card

Summary

Rewrites the Agent Card URL to match the public URL of the gateway

Category

A2A

First Flex Gateway version available

v1.9.3

Returned Status Codes

This policy supports Agent2Agent Protocol (A2A) version v0.3.0. To learn more about A2A versions, see A2A Releases.

Summary

The A2A Agent Card Policy rewrites the URL in the A2A Agent Card responses so that the exposed URL points to the public endpoint of the Flex Gateway A2A server instance rather than directly to backend services. This ensures that all client requests are routed through Flex Gateway, enabling it to enforce security and access controls, while preventing direct access to backend resources.

Configuring Policy Parameters

Flex Gateway Local Mode

The A2A Agent Card policy isn’t supported in Local Mode.

Managed Flex Gateway and Flex Gateway Connected Mode

When you apply the policy to your API instance from the UI, the following parameters are displayed:

Element	Description
Consumer URL	The consumer URL of the agent’s A2A service where JSON-RPC requests are sent. If the consumer URL isn’t set, the server instance’s public endpoint is used.
Card Path	The path where the agent presents the card.

Element

Description

Consumer URL

The consumer URL of the agent’s A2A service where JSON-RPC requests are sent.
If the consumer URL isn’t set, the server instance’s public endpoint is used.

Card Path

The path where the agent presents the card.