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.
-
Automate with CI/CD
Add validation to your GitHub workflows to catch issues early.
-
Deep Dive: Scoring
Understand the complete scoring system in detail.
-
API Reference
Complete Python SDK reference documentation.
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:
- CLI Help:
capiscio validate --help - GitHub Issues: github.com/capiscio/capiscio-core/issues
- Community: Join our Discord (coming soon)
Feedback¶
Was this quickstart helpful? We'd love to hear from you!
- Found an error? Open an issue
- Have suggestions? Start a discussion
Thank you for completing the Validation Quickstart!