Documentation

AgentHub Documentation

Welcome to the AgentHub documentation! This comprehensive guide will help you understand, install, and use the Agent2Agent (A2A) protocol-compliant communication broker to build sophisticated multi-agent systems with Event-Driven Architecture scalability.

🚀 Quick Start

New to AgentHub?

Start with our Installation and Setup tutorial, then follow the Running the Demo guide to see AgentHub in action.

Want to understand the concepts?

Read about The Agent2Agent Principle to understand the philosophy behind AgentHub.

Ready to build agents?

Use our guides to Create a Publisher or Create a Subscriber.

Need technical details?

Check the API Reference and Configuration Reference.

📚 Documentation Types

Our documentation follows the Diátaxis framework with four distinct types:

Tutorials - Learning by doing

Step-by-step guides that teach you how to use AgentHub through practical exercises:

• Installation and Setup
• Running the Demo
• Building Multi-Agent Workflows
• Dashboard Tour
• Observability Demo

How-to Guides - Solving specific problems

Goal-oriented guides for accomplishing specific tasks:

• Create a Publisher
• Create a Subscriber
• Debugging Agent Issues
• Add Observability
• Use Dashboards

Reference - Technical specifications

Comprehensive technical documentation and API details:

• API Reference
• Configuration Reference
• Task Reference
• Unified Abstraction API
• Observability Metrics
• Health Endpoints
• Tracing API

Explanation - Understanding concepts

In-depth discussions that provide context and background:

• The Agent2Agent Principle
• A2A Protocol Migration - New: Understanding the A2A compliance migration
• Understanding Tasks
• Broker Architecture
• Performance and Scaling
• Unified Abstraction Library
• Distributed Tracing
• Go Build Tags

🎯 Learning Paths

For Beginners

1. Installation and Setup
2. The Agent2Agent Principle
3. Running the Demo
4. Understanding Tasks
5. Create a Subscriber

For Experienced Developers

1. Running the Demo
2. API Reference
3. Create a Publisher
4. Performance and Scaling

For System Architects

1. The Agent2Agent Principle
2. Broker Architecture
3. Performance and Scaling
4. Configuration Reference

🔧 System Overview

AgentHub enables autonomous agents to collaborate through A2A protocol-compliant task delegation with EDA scalability:

• A2A Protocol Compliance with standardized Message, Task, and Artifact formats
• Event-Driven Architecture for scalable asynchronous communication
• Flexible agent addressing (direct, broadcast, topic-based routing)
• Rich task semantics with A2A lifecycle states and priorities
• Built-in resilience with EDA patterns and graceful failure handling
• Comprehensive observability with distributed tracing and metrics

🛠️ Key Technologies

• Protocol: gRPC with Protocol Buffers
• Language: Go 1.24+
• Architecture: Event-driven with pub/sub patterns
• Observability: OpenTelemetry integration
• Message Format: Structured protobuf with flexible JSON parameters