How-To Guides¶
Task-oriented guides for specific problems. Each guide is self-contained with copy-paste code.
Validation¶
| Guide | What You'll Do | Time |
|---|---|---|
| Validate from URL | Validate a remote agent card | 2 min |
| Bulk Validation | Validate multiple agents at once | 5 min |
| Schema-Only Mode | Quick syntax check without live testing | 2 min |
| Strict Mode | Enforce all best practices for production | 3 min |
| Custom Timeout | Handle slow endpoints | 2 min |
Security¶
| Guide | What You'll Do | Time |
|---|---|---|
| Sign Outbound Requests | Add JWS signatures to A2A calls | 5 min |
| Verify Inbound Requests | Validate incoming JWS signatures | 5 min |
| Trust Badges | Request and use trust badges | 10 min |
| Badge Keeper | Auto-renew badges before expiry | 5 min |
| Security Gateway | Deploy a trust-enforcing gateway | 15 min |
| Dev Mode | Security features in development | 3 min |
| Key Rotation | Rotate keys without downtime | 10 min |
| Trust Store | Configure which agents to trust | 5 min |
Integrations¶
| Guide | What You'll Do | Time |
|---|---|---|
| FastAPI | Add CapiscIO middleware to FastAPI | 5 min |
| Flask | Add CapiscIO to Flask apps | 5 min |
| Express.js | Add CapiscIO to Express | 5 min |
| LangChain | Secure a LangChain agent | 10 min |
CI/CD¶
| Guide | What You'll Do | Time |
|---|---|---|
| Pre-commit Hook | Validate before every commit | 3 min |
| GitLab CI | Validate agents in GitLab pipelines | 5 min |
| Jenkins | Validate agents in Jenkins | 5 min |
Guide Format¶
Every guide follows the same structure:
- Problem — What you're trying to do
- Solution — Copy-paste code that works
- How It Works — Brief explanation
- See Also — Related guides and references
Can't Find What You Need?¶
-
Request a Guide
Open an issue to suggest a new how-to guide.
-
Contribute
Share your solutions with the community.