Skip to main content

​
A2A Protocol Integration

Oxygen supports the Agent-to-Agent (A2A) protocol, enabling standardized communication between Oxygen agents and external agents or applications.

​
Quick Start

​
1. Configure A2A Agents

Add agents to your config.yml: 
a2a:
  agents:
    - ref: agents/sales-assistant.agent.yml
      name: sales-assistant
    - ref: agents/data-analyst.agent.yml
      name: data-analyst

​
2. Start the A2A Server

oxy a2a --host 0.0.0.0 --port 8080

​
Authentication

Secure your A2A endpoints with API key authentication: 
headers = {
    "X-Api-Key": "your-api-key"
}

​
Documentation

​
Getting Started

  • Integration guide — step-by-step setup and usage guide
  • REST API reference — complete endpoint documentation

​
Advanced Topics

  • Artifact mapping — how Oxygen outputs map to A2A artifacts
  • A2A Protocol Specification — full protocol specification

​
Configuration

​
Basic Configuration

a2a:
  agents:
    - ref: agents/local.agent.yml
      name: local

​
Multiple Agents

a2a:
  agents:
    - ref: agents/sales-assistant.agent.yml
      name: sales-assistant
    - ref: agents/data-analyst.agent.yml
      name: data-analyst
    - ref: agents/support.agent.yml
      name: support

​
Configuration Options

  • ref - Path to Oxygen agent configuration file
  • name - URL-safe identifier for A2A endpoints

​
CLI Commands

​
Start A2A Server

# Default (localhost:3000)
oxy a2a

# Custom host and port
oxy a2a --host 0.0.0.0 --port 8080

​
Options

  • --host - Host to bind (default: 127.0.0.1)
  • --port - Port to bind (default: 3000)