Skip to content

Step 5: Next Steps

Congratulations! 🎉 You've completed the Validation Quickstart. You can now validate any A2A agent card using the CapiscIO CLI.


What You Learned

In this quickstart, you learned how to:

  • Install the CapiscIO CLI (npm, pip, or Go)
  • Validate a local agent-card.json file
  • Use different validation modes (progressive, strict)
  • Interpret the three-dimensional scoring system
  • Read and understand validation reports
  • Get JSON output for automation

Quick Reference

Here's a cheat sheet for common validation tasks:

# Basic validation
capiscio validate agent-card.json

# Strict mode for production
capiscio validate agent-card.json --strict

# Validate from URL (any URL works)
capiscio validate https://my-agent.example.com/agent-card.json

# Test live endpoint
capiscio validate agent-card.json --test-live

# JSON output for scripts
capiscio validate agent-card.json --json

# Schema only (skip network)
capiscio validate agent-card.json --schema-only

# Skip signature verification (dev only)
capiscio validate agent-card.json --skip-signature

Continue Your Journey

  • Add Security


    Learn how to sign agent cards and verify requests with SimpleGuard.

    Security Quickstart

  • Automate with CI/CD


    Add validation to your GitHub workflows to catch issues early.

    CI/CD Quickstart

  • Deep Dive: Scoring


    Understand the complete scoring system in detail.

    Scoring System

  • API Reference


    Complete Python SDK reference documentation.

    Python SDK Reference


Common Use Cases

Now that you know the basics, here are practical scenarios:

Validate Before Deploying

Add validation to your deployment script:

#!/bin/bash
# deploy.sh

echo "Validating agent card..."
if ! capiscio validate agent-card.json --strict; then
    echo "Validation failed! Aborting deployment."
    exit 1
fi

echo "Validation passed! Deploying..."
# your deployment commands here

Validate Multiple Agents

Create a script to validate all agents in a directory:

#!/bin/bash
# validate-all.sh

for card in agents/*/agent-card.json; do
    echo "Validating $card..."
    capiscio validate "$card" --strict
done

Monitor External Agents

Validate agents you depend on:

#!/bin/bash
# monitor.sh

agents=(
    "https://weather-agent.example.com/agent-card.json"
    "https://api.acme.io/agents/calendar/agent-card.json"
)

for url in "${agents[@]}"; do
    echo "Checking $url..."
    capiscio validate "$url" --test-live --json | jq '.success'
done

Get Help

If you run into issues:


Feedback

Was this quickstart helpful? We'd love to hear from you!


Thank you for completing the Validation Quickstart! 🚀