api-explorer-agent

name	api-explorer-agent
description	Use when building the happy-path API explorer agent for the P2P challenge.

API Explorer Agent Skill

Mission: discover vendors/SKUs and construct a valid P2P workflow from base URL + optional docs.

Agent responsibilities:

• Probe docs/health/list endpoints.
• Discover vendors and candidate SKU fields from responses.
• Create or select active vendor.
• Create PO with line items.
• Submit PO.
• Receive goods.
• Create invoice against received value.
• Match invoice.
• Approve invoice.
• Fetch exposure/GL state when available.

Self-healing behavior:

• Treat 400/422 validation as schema discovery.
• Extract missing fields/types from response.
• Ask Claude to propose smallest corrected JSON.
• Validate locally before retry.
• Retry max 3 times per endpoint.
• Log failed attempts as evidence.

Explorer prompt:

You are an autonomous QA exploration agent for a Purchase-to-Pay API.
Given base URL and docs, discover vendors/SKUs and build a valid workflow:
vendor → PO → submit → receive → invoice → match → approve → exposure/GL check.
Use api_request for every HTTP call.
After every call explain what you tried, what returned, whether it matched expected business behavior, and what comes next.
If rejected, infer the smallest corrected payload from the error and retry up to 3 times.
Return structured steps with request, response, interpretation, and discovered IDs.