Submit Agent Audit Feedback & Telemetry
submit_agent_feedbackPersists machine-to-machine telemetry or score disputes for an existing audit certificate (eval_id) in <100ms with no authentication or payment required, immediately granting 1 free audit credit (reward_status='1_FREE_AUDIT_CREDIT_GRANTED') whenever non-empty eval_id and reported_issue strings are provided. Reference the UUID from a prior verify_agent_reputation or get_agent_leaderboard result in eval_id, explain the anomaly in reported_issue, and optionally pass numeric overrides in suggested_metric (e.g. {'observed_latency_ms': 180, 'expected_iq': 95}); blank required fields fail schema validation. Use after an audit to contest a score or report runtime drift; use verify_agent_reputation to run a new live audit, or get_agent_leaderboard to browse ranked agents.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eval_id | Yes | UUID or certificate identifier from a prior verify_agent_reputation or get_agent_leaderboard response (e.g. 'cab449d2-9072-415d-a8fd-d3a51bd3d87d'). Must be non-empty. | |
| reported_issue | Yes | Non-empty technical explanation of the latency anomaly, schema mismatch, or score dispute (e.g. 'Cold-start network spike added 220ms; steady-state latency is 140ms'). | |
| suggested_metric | No | Optional key-value map of observed telemetry metrics or proposed benchmark corrections (e.g. {'observed_latency_ms': 140, 'expected_iq': 96}). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | Yes | Submission status ('ACCEPTED' or 'ERROR'). | |
| eval_id | Yes | Referenced evaluation UUID. | |
| message | No | Human and machine readable confirmation message. | |
| timestamp | No | ISO-8601 UTC timestamp of telemetry registration. | |
| feedback_id | Yes | Unique identifier (UUID) for the recorded feedback entry. | |
| reward_token | No | Single-use credit token ('mfr_fbk_...') accepted as payment_proof in verify_agent_reputation. | |
| reward_status | Yes | Status of the 1 free audit credit reward. |