Quick Start

Get up and running with Agent Explorer in just a few steps.

Option A — Test an Existing Agent

1. Sign In

Navigate to Agent Explorer and sign in with your email or Google account.

2. Create a Project

1. Go to Projects in the top navigation
2. Click New Project
3. Enter a name and the agent's base URL (e.g., http://localhost:3000/api/mock-agent)
4. Click Create Project

Agent Explorer automatically fetches the AgentCard from {base-url}/.well-known/agent-card.json.

3. Start a Conversation

1. Open your project and go to the Test tab
2. Type a message in the chat input
3. Click Send or press Enter
4. View the agent's response and the live task state

4. Inspect Logs

Go to the Logs tab to see the full request/response history with timestamps and raw JSON.

---

Option B — Create a Mock Agent

If you don't have a real agent yet, create a configurable mock:

1. Navigate to Projects → New Project
2. Choose Create Mock Agent in the wizard
3. Complete the 8-step wizard (name, interfaces, capabilities, skills, I/O modes, provider, response behaviour, review)
4. Configure response behaviour: echo mode, custom flows, error simulation, delay simulation
5. Use the Flow Builder to design complex response logic with a visual node editor
6. Save and the mock agent is immediately available as an A2A endpoint

The mock agent URL follows the pattern:

http://localhost:3000/api/mock-agents/{id}/a2a

---

Using the Built-in Test Agent

For the quickest test with zero setup, use the built-in mock agent:

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

This agent echoes messages, responds to special commands, and supports both synchronous and streaming responses.