AgentServer

A sample ASP.NET Core application demonstrating the A2A (Agent-to-Agent) framework with different agent implementations.

Available Agents

The AgentServer supports four different agent types:

• echo: A simple echo agent that responds with the same message it receives
• echotasks: An echo agent with task management capabilities
• researcher: A research agent with advanced capabilities
• speccompliance: A specification compliance agent used to test compliance with the A2A specification

Running the Application

Visual Studio

1. Open the solution in Visual Studio
2. Set AgentServer as the startup project
3. In the Debug toolbar, click the dropdown next to the green play button
4. Select one of the available profiles:
   • echo-agent: Explicitly runs the echo agent on HTTP (port 5048)
   • echotasks-agent: Runs the echo agent with tasks on HTTP (port 5048)
   • researcher-agent: Runs the researcher agent on HTTP (port 5048)
   • speccompliance-agent: Runs the specification compliance agent on HTTP (port 5048)
5. Press F5 or click the green play button to start debugging

VS Code

Using the Debug Panel:

1. Open the workspace in VS Code
2. Open the Debug panel by pressing Ctrl+Shift+D or clicking the Run and Debug icon in the sidebar
3. Click the green play button or press F5 to start debugging
4. A dropdown will appear at the top of VS Code - click on "More C# options"
5. Select one of the available profiles:
   • echo-agent: Runs the echo agent on HTTP (port 5048)
   • echotasks-agent: Runs the echo agent with tasks on HTTP (port 5048)
   • researcher-agent: Runs the researcher agent on HTTP (port 5048)
   • speccompliance-agent: Runs the specification compliance agent on HTTP (port 5048)

Using the integrated terminal:

# Navigate to the AgentServer directory
cd samples/AgentServer

# Run with different profiles using dotnet run
dotnet run --launch-profile echo-agent
dotnet run --launch-profile echotasks-agent
dotnet run --launch-profile researcher-agent
dotnet run --launch-profile speccompliance-agent

Using command line arguments directly:

# Navigate to the AgentServer directory
cd samples/AgentServer

# Run with specific agent types
dotnet run --agent echo
dotnet run --agent echotasks
dotnet run --agent researcher
dotnet run --agent speccompliance

Endpoints

Each agent is mapped to its respective endpoint:

• Echo agent: http://localhost:5048/echo
• Echo with tasks agent: http://localhost:5048/echotasks
• Researcher agent: http://localhost:5048/researcher
• Specification compliance agent: http://localhost:5048/speccompliance

Testing

Prerequisite: Make sure the AgentServer application is running before executing any HTTP tests (see Running the Application section above).

The http-tests directory contains HTTP test files that can be executed directly in both Visual Studio and VS Code:

Visual Studio

• Open any .http file in Visual Studio
• Click the green "Send Request" button next to each HTTP request
• View the response in the output window

VS Code

• Install the REST Client extension
• Open any .http file
• Click "Send Request" above each HTTP request
• View the response in a new tab

Available test files:

• agent-card.http: Test agent card functionality
• message-send.http: Test message sending
• message-stream.http: Test message streaming
• push-notifications.http: Test push notifications
• researcher-agent.http: Test researcher agent specific features
• task-management.http: Test task management features

A2A Specification Compliance Verification

The speccompliance agent is specifically designed to validate compliance with the A2A specification. You can verify this compliance using the official A2A TCK.

Prerequisites

1. Start the speccompliance agent: Make sure the AgentServer is running with the speccompliance agent (see Running the Application above)
2. Install TCK prerequisites: Follow the A2A TCK requirements for your platform

Running the TCK

1. Clone the A2A TCK repository:

   git clone https://github.com/a2aproject/a2a-tck.git
   cd a2a-tck
   

2. Setup Python environment:

   # Create virtual environment
   uv venv
   
   # Activate virtual environment
   # On Windows:
   .venv\Scripts\activate
   # On macOS/Linux:
   source .venv/bin/activate
   
   # Install dependencies
   uv pip install -e .
   

3. Run the compliance tests against the speccompliance agent:

   python ./run_tck.py --sut-url http://localhost:5048/speccompliance --category all
   

The TCK will run a comprehensive suite of tests to verify that the agent correctly implements the A2A specification, including:

• Agent card discovery and metadata validation
• Message handling and response formatting
• Task management capabilities
• Error handling and status codes
• Protocol compliance for all supported endpoints

For detailed information about the A2A specification and compliance requirements, visit the A2A Project repository.