Agent Activity Dashboard

When AI agents interact with APXY, every action they take — adding mock rules, enabling SSL, setting filters — is logged with session tracking. The Agent Activity Dashboard provides real-time visibility into what agents are doing.

Concepts

Agent Session: A logical grouping of agent actions, identified by a session ID and optional label
Agent Action: A single operation performed by an agent (e.g., mock_add, ssl_enable, filter_set), with parameters, result, and timestamp

Tracked action types include: mock add/remove/enable/disable/clear, interceptor set/delete, SSL enable/disable, filter set/remove, redirect set/remove, network set/clear, recording on/off, caching control, script set/remove/enable/disable, breakpoint set/delete/enable/disable.

Web API

Real-time event stream


GET /agent/events

Returns a Server-Sent Events (SSE) stream of agent actions as they happen. Each event is a JSON-encoded agent action.

List sessions


GET /agent/sessions

Returns all agent sessions with their IDs, labels, and start times.

Session detail


GET /agent/sessions/{id}

Returns a single session with all its associated actions.

List actions


GET /agent/actions

Returns agent actions, optionally filtered by session:


GET /agent/actions?session_id=<session-id>

Use Cases

Audit agent behavior

Review what an AI agent did during a debugging session:


curl http://localhost:8081/agent/sessions
# Find the session ID, then:
curl http://localhost:8081/agent/sessions/<session-id>

Real-time monitoring

Stream agent events to watch what an agent is doing as it works:


curl -N http://localhost:8081/agent/events

Debugging agent integrations

When building agent-driven workflows around APXY, use the dashboard to verify that actions are being recorded correctly and that session tracking is working as expected.