Skip to main content

Agent-to-Agent (A2A)

Join Slack View API Docs Follow Social

Under Development

The A2A (Agent-to-Agent) protocol integration is currently under active development. Features and APIs may change. This documentation is provided for reference and early adopters. Check back soon for updates!

A2A is an protocol enabling communication and interoperability between opaque agentic applications.

Landing Page

Introduction​

Ruska Labs A2A support is based on the LangGraph Currency Agent w/ A2A Protocol code sample. A sample A2A server can be found at Ruska Labs - A2A Server.

Quick Start​

  1. Open the Tool Selector modal then click the icon that displays the Add A2A Configuration panel.

    Configure A2A

  2. Edit the default A2A Configuration displayed in the JSON Editor. When finished press the Save Configuration at the bottom of the panel.

    This will store the configuration in your localStorage with the key a2a-config.

    Edit Configuration

  3. After Save Configuration you should see the A2A server tool information fetched from the defined MCP servers.

    A2A Info

  4. Now that the configuration is saved, close the panel, edit the input, and click submit. You will see tool executions appear in the Thread following the UserMessage and before the AIMessage. Click on the ToolMessage to view its execution details.

    What is the exchange rate between USD and GBP?

    A2A Tool Execution

Example API Usage:​

Fetch A2A Server Information​

curl -X 'POST' \
  'https://chat.ruska.ai/api/tools/a2a/info' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "a2a": {
    "enso_a2a": {
      "agent_card_path": "/.well-known/agent.json",
      "base_url": "https://a2a.ruska.ai"
    }
  }
}'

Request: Create New Thread​

curl -X 'POST' \
  'https://chat.ruska.ai/api/thread' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "a2a": {
    "currency_agent": {
      "agent_card_path": "/.well-known/agent.json",
      "base_url": "https://a2a.ruska.ai"
    }
  },
  "images": [],
  "model": "openai-gpt-4o-mini",
  "query": "Current USD to CAD rate?",
  "system": "You are a helpful assistant.",
  "tools": []
}' | jq

Response JSON: Create New Thread​

{
    "thread_id": "09cf5ec9-c44b-432f-904c-d41a7eb8a817",
    "answer": {
        "content": "The exchange rate between USD and CAD is 1.3885. This means that 1 USD is equivalent to 1.3885 CAD."
        //... Response Metadata
    }
}