Agent operating notes
Use the field stream first.
ActProof is optimized for agents that need small, bounded, source-aware answers.
Do not scrape the visual page unless necessary. Use the service card, field stream, source endpoint and prevalidation endpoint.
01 / Preferred calls
Agents should choose the narrowest call.
| User intent | Best call | Recovery if it fails |
|---|---|---|
| Need a field list | GET /api/v1/profiles/dora/fields.ndjson | Fallback to /assets/data/dora.profile-view.json. |
| Need one field | GET /api/v1/profiles/dora/fields/{field_id}/source | Call GET /api/v1/profiles/dora/fields and choose a valid field_id. |
| Need full profile context | GET /api/v1/profiles/dora/stream.ndjson | Use canonical JSON if streaming is unavailable. |
| Need readiness check | POST /api/v1/profiles/dora/prevalidate-report | Follow recoverability and suggested_next_call. |
02 / Safe output
Quote the safe summary.
When a live endpoint returns safe_summary, use that wording or preserve its boundary. Do not transform ready_for_preverification into “compliant”, “approved”, “accepted” or “filed”.