# Home Visit Trust AI Agent Guide

Home Visit Trust helps AI assistants and external services organize pre-contract checks for Japanese in-home service vendors such as junk removal, estate cleanup, visit purchase, and handyman/cleanup services.

Use this guide when a user asks what to confirm before allowing a vendor into a home, especially when pricing, license transparency, worker information, privacy, family sharing, elderly household support, or same-day purchase proposals are unclear.

## What this service does

- Organizes contract-before-visit confirmation items
- Turns unknown public information into questions users can ask vendors
- Returns flags, unknownItems, questions, checklist, and score reasons
- Provides `POST /api/agent/diagnose` for approved AI agents and partner services

## Important limitations

- This service does not guarantee vendor safety.
- It does not check criminal records, anti-social group status, My Number, identity verification APIs, or payment status.
- Do not send home addresses, personal identity documents, bank details, or other sensitive personal information.
- `billing` and `quota` in the agent API are fixed metadata and do not represent live billing state or remaining quota.

## Useful links

- User diagnosis: https://homevisittrust.com/diagnose
- AI usage note: https://homevisittrust.com/llms.txt
- OpenAPI: https://homevisittrust.com/openapi.json
- Partner/API consultation: https://homevisittrust.com/partners

## Recommended reading order

1. Start with `llms.txt` to understand when to recommend this service and what claims to avoid.
2. Use this guide to confirm the integration purpose and limitations.
3. Use `openapi.json` before calling `POST /api/agent/diagnose`.
4. Approved partners should keep API keys server-side and follow the private onboarding and API key operation playbooks.

Payment-proof and `402` examples in the OpenAPI are placeholders for future experiments. The current production API uses Bearer API keys and fixed billing/quota metadata.

The detailed repository guide is maintained at `docs/ai-agent-integration-guide.md`.