Built-in Mock Agent

Agent Explorer includes a simple built-in mock agent for quick testing without any setup.

Testing with the built-in mock agent

Setup

Create a project with this URL:

http://localhost:3000/api/mock-agent

The mock agent provides:

  • A valid AgentCard at /api/mock-agent/.well-known/agent-card.json
  • Support for the message/send method
  • Support for streaming via message/stream
  • Basic task state management

AgentCard Capabilities

The built-in mock agent advertises:

  • Streaming: Enabled
  • Push Notifications: Disabled
  • State Transition History: Enabled

Special Commands

Send these text commands to trigger specific behaviours:

CommandBehaviour
delay NAdd N seconds delay (max 10s). E.g., delay 3
status STATESet task state. E.g., status working
Any other textEcho the message back with a timestamp

Supported Status States

status working, status completed, status failed, status input-required, status canceled, status submitted

Endpoints

EndpointMethodDescription
/api/mock-agentPOSTSend a message
/api/mock-agent/.well-known/agent-card.jsonGETFetch AgentCard

Limitations

The built-in mock agent is for quick testing only:

  • No real AI processing
  • No persistent storage across restarts
  • Limited simulation scenarios
  • Single shared agent for all users

For more advanced scenarios, use Custom Mock Agents which support visual flow logic, skill routing, LLM responses, and per-user configuration.