AI agents overview

​

Agent types

​

How it works

1. Submit — POST to the agent endpoint with your query
2. Accept — API returns 202 Accepted with a job_id
3. Poll — GET /v1/agents/jobs/{job_id} until status is completed or failed, or pass callback_url + callback_secret on submit (Agent callbacks)
4. Result — The completed job includes the agent’s structured output
5. Trace — GET /v1/agents/jobs/{job_id}/trace for the full reasoning trace

# Submit
curl -X POST https://api-dev.rcintell.com/v1/agents/code-research \
  -H "X-API-Key: kp_test_..." \
  -H "Content-Type: application/json" \
  -d '{"query": "What CPT for total knee replacement?", "ccn": "170001"}'

# Returns: {"job_id": "abc-123", "status": "pending", ...}

# Poll
curl https://api-dev.rcintell.com/v1/agents/jobs/abc-123 \
  -H "X-API-Key: kp_test_..."

# Returns: {"job_id": "abc-123", "status": "completed", "result": {...}, ...}

​

Knowledge enrichment

• The facility’s location and GPCI values
• The applicable payment system and billing form
• Payer-specific rules and filing deadlines
• Expected payment for the procedure