A2A Agent in Groovy using a2ajava

This project demonstrates the implementation of an Agent-to-Agent (A2A) protocol using Groovy and the a2ajava library. The A2A protocol enables communication and task delegation between software agents, making it easier to build distributed AI-powered applications.

What is the A2A Protocol?

The Agent-to-Agent (A2A) protocol is a standardized way for software agents to communicate and delegate tasks to each other. Key features include:

• Standardized Communication: Agents can communicate using a common protocol regardless of their implementation
• Task Delegation: Agents can delegate tasks to other agents based on their capabilities
• Asynchronous Operation: Support for both synchronous and asynchronous task execution
• Extensible Architecture: Easy to add new agents and capabilities to the system

Project Structure

This project includes:

• WeatherAgent: A sample agent that provides weather information
• Spring Boot integration for running the agent service
• Local and remote client support for agent communication

Implementation Details

You can start the server with A2AGroovyApp.groovy and then connect your client using the url localhost:8080. The agent card will be available at http://localhost:8080/.well-known/agent.json

Weather Agent Implementation

@Agent(groupName = "Weather Service", groupDescription = "Provides current weather info")
class WeatherAgent {
    @Action(description = "Get temperature for a given city")
    String getTemperature(String city) {
        "The current temperature in ${city} is 25°C"
    }
}

Client Usage Example

@SpringBootApplication
class A2AGroovyApp {
    static void main(String[] args) {
        SpringApplication.run(A2AGroovyApp, args)
        def client = new LocalA2ATaskClient()
        def response = client.sendTask("hows the weather in London")
        println "Response: ${response}"
    }
}

Client Types

The project supports two types of clients:

1. Local Client: Used for testing and development, runs agents in the same JVM

   def client = new LocalA2ATaskClient()
   

2. Remote Client: Connects to remote agent servers

   def client = new RemoteA2ATaskClient("http://server-url")
   

Getting Started

1. Clone the repository
2. Build using Gradle:

   ./gradlew build
   

3. Run the application:

   ./gradlew bootRun
   

Dependencies

• Spring Boot 3.2.5
• a2ajava 0.0.7.9
• Groovy 3.0.19
• JDK 23

License

This project is licensed under the MIT License.