Skip to main content
The Agent Registry catalogs agents exposed over A2A. Each entry links an Agent Build to an Agent Card, hosted URL, and TEST / LIVE status.

Open Agent Registry

In the workspace sidebar, open Agent Registry when your organisation grants workspace.sidebar.agent_registry. Route: /{organisation}/workspace/{workspaceId}/agent-registry
The same registry data powers Browse mode on agent nodes in Graph Studio. The workspace page is the full catalog with search, filters, and detail views.
Agent Registry catalog with search and filters

Agent Registry — search, filters, and agent cards

Page layout

Filter dimensions

Filters apply client-side on the loaded registry list in addition to API query parameters.

Organisation vs public listings

Public-oriented filtering emphasises status=live at the API. Visibility (public vs organization) is enforced at invoke time by the gateway; apply the Public visibility filter in the sidebar to narrow results.

Agent cards in the list

Each card typically shows:
  • Agent name and description (from Agent Card)
  • Deployment badge (Test or Live)
  • Visibility (Public or Organisation)
  • Skills summary and discoverability tags
  • Hosted A2A URL (LIVE builds omit registry ID in path — Endpoints & lifecycle)
Selecting a card opens a detail panel where you can copy the endpoint and review build metadata.

Browse the catalog

  1. Open Agent Registry from the workspace sidebar.
  2. Search or apply filters to narrow agents.
  3. Select an agent to view Agent Card details and hosted URL.
  4. Use TEST URLs for validation; LIVE URL after Push To Prod.

API reference (listing)

Optional query params: flowid, visibility, tag, input_mode, output_mode, page, limit.

Permissions

  • View registry: assistants.flows:read
  • Sidebar entry: workspace.sidebar.agent_registry

Expose an agent

Create a new registry entry from Graph Studio.

Registry agent nodes

Attach catalog agents on the canvas (Browse mode).