Step 1: Introduction¶

In this quickstart, you'll learn how to validate an A2A agent card using the CapiscIO CLI. By the end, you'll be able to check if any agent meets the A2A protocol requirements.

What You'll Build¶

flowchart LR
    A[agent-card.json] --> B[CapiscIO CLI]
    B --> C{Validation}
    C -->|Pass| D[✅ Compliant]
    C -->|Fail| E[❌ Issues Found]

You'll validate an agent card and receive a detailed report including:

• Compliance Score (0-100) — Does it follow the A2A spec?
• Trust Score (0-100) — Is it cryptographically signed?
• Availability Score (0-100) — Does the endpoint respond correctly?

Prerequisites¶

Before starting, ensure you have:

What is an Agent Card?¶

An Agent Card is a JSON document that describes an A2A agent. It's like a business card for your AI agent, containing:

• Identity: Name, description, version
• Capabilities: What the agent can do
• Endpoints: Where to reach the agent
• Skills: Specific tasks the agent performs

Here's a minimal example:

{
  "name": "My Agent",
  "url": "https://example.com/agent",
  "protocolVersion": "0.2.0"
}

CapiscIO validates that your agent card meets the A2A Protocol Specification.

What You'll Learn¶

By completing this quickstart, you'll understand:

1. How to install the CapiscIO CLI
2. How to run your first validation
3. How to interpret validation reports
4. How to fix common validation issues

Time Estimate¶

Ready?¶

Let's install the CLI and validate your first agent!