Projects
Projects are the top-level container for all your A2A testing work. Each project connects to one A2A agent and holds all conversations, logs, and configuration for that agent.
Creating a Project
- Go to Projects in the navigation
- Click New Project
- Choose between connecting to an existing external agent or creating a new Mock Agent
- For external agents: enter the agent's base URL
- Click Create Project
Project Types
Projects are visually differentiated in the projects list:
| Type | Icon | Description |
|---|---|---|
| External Agent | Globe icon | Connects to a real A2A agent |
| Mock Agent | Flask icon | Powered by a configurable mock agent |
Mock Agent projects display an amber Mock badge.
Project Structure
Each project contains:
| Tab | Description |
|---|---|
| Overview | AgentCard details, validation status, project info |
| Test | Chat interface for sending messages |
| Logs | Full request/response history |
| Settings | Project config, OAuth, team assignment |
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 |
Project Actions
- Refresh AgentCard — Re-fetch the AgentCard (useful after agent config changes)
- Delete Project — Permanently removes the project, all conversations, logs, and cached AgentCard
Ownership
Projects can be personal (owned by you) or team-owned (shared with team members). The owner is shown as a badge on each project card.
Managing Multiple Agents
Create separate projects for each agent you want to test. This keeps conversations and logs organised per agent.