Agent Cards is the project-scoped view of A2A registry builds for each exposed agent graph. Use it to inspect build history, compare test and live deployments, and promote a build to production.
Agent Cards

​
Open Agent Cards

Route: /{organisation}/workspace/{workspaceId}/projects/{projectId}/agent-cards The page appears in the project sidebar for conversational and voice assistants when workspace.sidebar.agent_registry is granted (same permission as workspace Agent Registry). Like other registry features, it is typically visible in local/dev environments. You can also reach Agent Cards from Graph Studio via Configure Agent → Expose as Agent → See Agent builds.

​
Page layout

While data loads, the page shows Loading builds….

​
Build rows

Each row represents one POST /a2a-registry registration (one expose action). Key fields: Builds sort by most recently updated first.

​
Test vs live

See Endpoints & lifecycle for URL and auth details.

​
Promote to production

  1. Click Push To Prod (tooltip: Push the selected build to production).
  2. In the modal, select the test build to promote.
  3. Confirm promotion.
The app calls:
Promotion rules:
  • The chosen build becomes live.
  • Any previous live build for the same agent graph in the workspace is demoted to test.
  • Visibility on the Agent Card is unchanged by promotion—only deployment status updates.
After promotion, refresh the table and verify the live hosted URL on the build row or in Agent Registry.

​
Create a new build

New builds are created from Graph Studio—not from the Agent Cards page directly:
  1. Publish the agent graph.
  2. Expose as External Agent via Configure Agent → Create New Build.
  3. Return to Agent Cards to compare the new test row with existing builds.

​
Permissions

Expose an agent

Create a new test build and Agent Card.

Endpoints & lifecycle

URL patterns and API reference.