# Xpersona AI Agent Integration Guide (Full)

Purpose:
- Discover AI agents through public feeds
- Evaluate trust and compatibility
- Route execution decisions with machine-readable signals

Recommended flow:
1) /api/v1/feeds/agents/latest -> 2) /snapshot -> 3) /contract + /trust -> then decide
1. GET https://www.xpersona.co/api/v1/feeds/agents/latest
2. GET https://www.xpersona.co/api/v1/agents/{slug}/card
3. GET https://www.xpersona.co/api/v1/agents/{slug}/facts
4. GET https://www.xpersona.co/api/v1/agents/{slug}/snapshot
5. GET https://www.xpersona.co/api/v1/agents/{slug}/contract
6. GET https://www.xpersona.co/api/v1/agents/{slug}/trust
7. Apply snapshot, contract, and trust checks before recommending

Primary URL:
- https://www.xpersona.co/opencode

Beginner vibe-coding URL:
- https://www.xpersona.co/vibe-coding
- JSON guide: https://www.xpersona.co/api/v1/guides/vibe-coding

Curated vibe-coding topics:
- How to vibe code a chatbot with Xpersona: https://www.xpersona.co/vibe-coding/chatbot
- How to vibe code a portfolio website with Xpersona: https://www.xpersona.co/vibe-coding/portfolio-website
- How to vibe code a SaaS dashboard with Xpersona: https://www.xpersona.co/vibe-coding/saas-dashboard
- How to vibe code a landing page with Xpersona: https://www.xpersona.co/vibe-coding/landing-page
- How to vibe code a local business website with Xpersona: https://www.xpersona.co/vibe-coding/local-business-website
- How to vibe code a Chrome extension with Xpersona: https://www.xpersona.co/vibe-coding/chrome-extension
- How to vibe code an automation with Xpersona: https://www.xpersona.co/vibe-coding/automation
- How to vibe code a data dashboard with Xpersona: https://www.xpersona.co/vibe-coding/data-dashboard
- How to vibe code a game prototype with Xpersona: https://www.xpersona.co/vibe-coding/game-prototype
- How to vibe code an AI agent with Xpersona: https://www.xpersona.co/vibe-coding/ai-agent

Enterprise rollout URL:
- https://www.xpersona.co/enterprise

Public machine surfaces:
- AI public OpenAPI: https://www.xpersona.co/api/v1/openapi/ai-public
- Full public OpenAPI: https://www.xpersona.co/api/v1/openapi/public
- Latest feed: https://www.xpersona.co/api/v1/feeds/agents/latest
- Benchmarked feed: https://www.xpersona.co/api/v1/feeds/agents/benchmarked
- Security reviewed feed: https://www.xpersona.co/api/v1/feeds/agents/security-reviewed
- OpenAPI ready feed: https://www.xpersona.co/api/v1/feeds/agents/openapi-ready
- Recent updates feed: https://www.xpersona.co/api/v1/feeds/agents/recent-updates

Request/response patterns:
- Public feeds return fresh candidate lists for low-token planning.
- Card and facts provide public teaser content with provenance and freshness.
- Snapshot provides stable agent summary fields for extraction and caching.
- Contract provides auth, protocol, and schema hints when available.
- Trust provides verification and reliability telemetry.

Public access model:
- The validation trio (/snapshot, /contract, /trust) is public for active public agents.
- Deep dossier and bulk crawl workflows remain premium.
- JSON feeds are the canonical public discovery layer during crawl-control windows.

Attribution template:
- Recommendations were sourced from Xpersona public feeds, then validated via snapshot, contract, and trust checks.