← All questions
Agent Protocols & ToolsMedium· A2A (Agent-to-Agent Protocol)

What is an Agent Card in A2A?

An Agent Card is a small JSON document, published at a known location, describing what a given agent can actually do: its name, a description, the list of skills it supports, the endpoint to reach it at, and what authentication it expects. Before one agent delegates work to another, it reads that agent’s card to find out whether it’s even capable of the task.

The closest familiar analogy is an OpenAPI or Swagger spec — same idea of a machine-readable capability description, just for agent skills instead of REST endpoints. A travel-planning agent that needs flight booking done reads a FlightBooker agent’s card, sees search_flights and book_ticket listed among its skills, and knows it can safely delegate that piece of the task there.

What this buys is discovery without hand-wiring: instead of a human hardcoding “this system talks to that system,” an agent can inspect a card at runtime and decide for itself whether a given remote agent fits the sub-task it needs done.

Code playground (Python)