README.md

metadata

title: API Triage Agent
emoji: 🤖
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false

API Triage Agent

Environment Description :

An AI agent that diagnoses and resolves API integration failures by inspecting logs, identifying error types, and taking corrective actions. Simulates real-world API debugging scenarios.

Motivation

API failures are common in production. This environment teaches an agent to handle authentication errors, missing fields, rate limits, wrong endpoints, and server errors – just like a real support engineer.

Action Space (8 actions)

Action	Description
inspect_logs	Examine error logs for clues
inspect_request	Check the failed API request
refresh_token	Fix authentication errors (401)
add_field	Add missing required fields (400)
wait_retry	Handle rate limits (429) and timeouts (408)
change_endpoint	Fix wrong API endpoint (404)
escalate	Report server errors (500) to human
resolve	End episode after successful fix

Observation Space

Field	Type	Description
step	int	Current step number
max_steps	int	Maximum steps allowed (10)
incident_summary	str	Short problem description
logs	list	Error messages from API
response_code	int	HTTP status code
fix_applied	bool	Whether fix has been applied
is_resolved	bool	Whether episode ended

Tasks (Easy → Medium → Hard)

Easy Task: Authentication Error

• Incident: auth_error
• Correct fix: refresh_token → resolve
• Score achieved: 1.0

Medium Task: Missing Field Error

• Incident: missing_fields
• Correct fix: add_field → resolve
• Score achieved: 1.0

Hard Task: Server Error

• Incident: server_error
• Correct fix: escalate → resolve
• Score achieved: 1.0

Reward System (5 factors)

Factor	Reward
Correct fix action	+5
Wrong action	-2
Diagnostic action	+0.5
Resolve with fix (success)	+15
Resolve without fix	-10
Max steps reached	-5

Setup Instructions

1. Create virtual environment

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows
 
# 2. must do (install dependencies) - pip install -r requirements.txt 
# also run these : python demo.py , pytest tests/test_env.py -v , python tests/test_graders.py , openenv validate