Agents
An Agent in Agent Explorer is a connection to a single A2A agent (real or mock) and holds all conversations, logs, and configuration for that agent. The terms "Agent" and "project" appear interchangeably in some older docs and in the API path /api/projects — internally an Agent is a Project record, but the UI and the rest of these docs call them Agents.
Creating an Agent
- Sign in and you'll land on the Explorer page.
- Click Add New (top right) → Agent.
- The creation dialog opens with three paths:
- Connect to an existing agent — paste a base URL; the AgentCard is fetched and validated automatically.
- Upload an AgentCard file — drop a JSON file; useful when the agent isn't network-reachable from the browser.
- Create a mock agent — name it and pick supported protocol versions; a configurable mock A2A server is provisioned.
- After the URL/file paths you can choose Connect to this agent (real) or Mock this agent (cloned mock you can edit).
Agent Types
Agents are visually differentiated in the Agents column of the Explorer:
| Type | Icon | Description |
|---|---|---|
| External Agent | Globe icon | Connects to a real A2A agent |
| Mock Agent | Flask icon | Powered by a configurable mock agent |
Mock Agents display an amber Mock badge.
Agent Detail Page
Selecting an agent opens its detail page with a vertical tab sidebar:
| Tab | Description |
|---|---|
| Agent Card | AgentCard details and validation status |
| Configuration | Name, URL, headers, ownership, and (for mocks) skills, response behaviour, API keys |
| Chat | Send A2A messages and watch task state in real time |
| Flows (mocks only) | Visual node-based response logic, per skill |
| Webhooks (mocks only) | Push-notification subscriptions and delivery log |
| Integrate | Code snippets for cURL, Python, TypeScript |
| Test Harness | Export a Postman collection |
| Logs (link at bottom of sidebar) | Full request/response history |
Agent URL Format
Enter the agent's base URL without the AgentCard path:
| Correct | Incorrect |
|---|---|
https://agent.example.com | https://agent.example.com/.well-known/agent-card.json |
http://localhost:3000/api/mock-agent | http://localhost:3000/api/mock-agent/message/send |
Agent Actions
- Refresh AgentCard — Re-fetch the AgentCard (useful after agent config changes)
- Delete Agent — Permanently removes the agent, all conversations, logs, and cached AgentCard
Ownership
Agents can be personal (owned by you) or team-owned (shared with team members). The owner is shown as a badge on each agent card.
Managing Multiple Agents
Create a separate agent for each A2A endpoint you want to test. Group related ones into a Workspace for organisation (optional).