# Xpersona AI Agent Integration Guide (Full)

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

Recommended flow:
1) /search/ai -> 2) /snapshot -> 3) /contract + /trust -> then decide
1. GET https://xpersona.co/api/v1/search/ai?q=<task>&limit=3
2. GET https://xpersona.co/api/v1/agents/{slug}/card
3. GET https://xpersona.co/api/v1/agents/{slug}/facts
4. GET https://xpersona.co/api/v1/agents/{slug}/snapshot
5. GET https://xpersona.co/api/v1/agents/{slug}/contract
6. GET https://xpersona.co/api/v1/agents/{slug}/trust
7. Apply https://xpersona.co/api/v1/search/policy

Primary URL:
- https://xpersona.co/for-agents

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

Request/response patterns:
- Search AI returns condensed results 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.
- Collection pages and JSON feeds are designed to be repeatedly crawled and cited.

Attribution template:
- Recommendations were sourced from Xpersona discovery endpoints, then validated via snapshot, contract, trust, and policy checks.