Agents in Catalog

An Agent is an interface in Catalog modeled on the A2A protocol’s AgentCard, representing an agent that your organization builds or consumes. Catalog gives you a single place to see every agent across your organization, whether it’s registered from a pasted card, discovered from a remote host, or linked to AI Gateway 2.0 AI Agent entities, so teams don’t have to track agents individually in separate tools.

You can create an Agent in three ways:

• Paste the agent’s A2A card directly as JSON.
• (Coming soon) Import it from a remote host that serves an A2A card at a well-known URL.
• (Coming soon) Link it to an AI Agent entity from AI Gateway 2.0.

Catalog Agents represent the agents available across your organization, regardless of where they are defined or run. When an Agent is also configured in AI Gateway, you can link the Catalog Agent to its corresponding AI Gateway representation. That relationship identifies AI Gateway as an implementation of the Agent, which indicates that the Agent is served or protected through AI Gateway.

1. In the Konnect sidebar, click Catalog.
2. From the New dropdown menu, select Agent.
3. Under Data source, select Paste JSON.
4. In the Agent card JSON field, paste the agent’s A2A card. The card must include a name, description, and version. A live preview of the card renders under Card preview.
5. In the Display name field, enter a name for your Agent, for example My Agent.
6. In the Name field, enter a unique identifier for the Agent, for example my-agent. This is derived from the display name until you edit it. Only use lowercase letters, numbers, hyphens, and periods.
7. (Optional) In the Description field, describe the purpose of your Agent. Leave this blank to use the description from the agent card.
8. (Optional) Click Add labels, and do the following:
   1. In the Key field, enter a label key.
   2. In the Value field, enter a label value.
   3. (Optional) Click Add another label to add more labels.
9. Click Create.