What is the A2A (Agent2Agent) protocol?

A2A is the open protocol that lets agents built on different frameworks call each other. Agents publish an Agent Card describing their skills, and other agents read that card to decide whether and how to invoke them.

How do I make my existing agent A2A compliant?

Run super a2a adapt --entrypoint : --framework . SuperOptiX reads your agent's structure, derives its skills, and writes an A2A Agent Card plus a conformant server. Your agent code is not modified.

Which agent frameworks does SuperOptiX support for A2A?

Eight: DSPy, CrewAI, the OpenAI Agents SDK, Pydantic AI, Google ADK, the Claude Agent SDK, DeepAgents and the Microsoft Agent Framework. Adaptation works on agents written directly against those libraries, whether or not SuperOptiX built them.

How conformant is the SuperOptiX A2A implementation?

It records zero failures against the official A2A Technology Compatibility Kit. Every requirement the TCK exercises against the conformance harness passes: 73 of 73 at MUST, 7 of 7 at SHOULD, 4 of 4 at MAY. The TCK also prints a headline percentage of 77.7% at MUST, which counts 25 requirements it cannot exercise here, covering authentication, TLS, Agent Card signing and gRPC.

How do I make my agent more discoverable to other agents?

Optimize the Agent Card text. SuperOptiX scores discovery rate, invocation rate and confusion rate over a query set, then uses GEPA to rewrite skill names, descriptions and tags against that score. Agent behaviour is unchanged.

Is SuperOptiX free and open source?

Yes, under the MIT License. The A2A implementation, the adapt command, the conformance suite, the routing optimizer, the SuperSpec compiler and all eight framework integrations are in the open source package. Install with uv tool install superoptix.

Is there a live A2A agent I can call?

Yes. A SuperOptiX agent runs at https://a2a.superoptix.ai on Google Cloud Run, with its Agent Card published at https://superoptix.ai/.well-known/agent-card.json.

Who builds SuperOptiX?

Superagentic AI, which builds agentic AI infrastructure and offers support and custom engineering engagements.

📊 Native Observability

📊

SuperOptiX Native

Local-First Observability - Comprehensive tracing, debugging, and analysis built directly into SuperOptiX. No external services required!

No Setup Required

Works Offline

Privacy-Friendly

Built-in Dashboard

🎯 What is SuperOptiX Native Observability?

A powerful built-in observability system that automatically traces agent execution, tool usage, LLM calls, and performance metrics.

Monitor

Real-time agent performance monitoring

Debug

Detailed trace analysis for debugging

Analyze

Pattern analysis and optimization

Track

Tool usage and LLM interactions

Export

Export trace data for external analysis

Offline

Works without internet connection

🚀 Quick Start

Set up observability in minutes

Initialize Project & Create Agent

# Initialize a new SuperOptiX project
super init my_project
cd my_project

# Pull a pre-built agent (Genies tier for full observability features)
super agent pull developer --tier genies

# Compile the agent to generate the pipeline
super agent compile developer

Run Agent to Generate Traces

# Run the agent - this automatically enables tracing
super agent run developer --goal "Write a Python function to calculate factorial"

Traces are automatically generated in .superoptix/traces/

Explore Observability Features

# List all agents with available traces
super observe list

# View traces for a specific agent
super observe traces developer_20250714_200501

# Launch the interactive dashboard
super observe dashboard --auto-open

# Analyze performance metrics
super observe analyze developer_20250714_200501 --days 7

📋 Available Commands

📋

super observe list

List all agents with available traces

🔍

super observe traces <agent_id>

View detailed execution traces for a specific agent

📊

super observe dashboard

Launch web-based dashboard for real-time monitoring

📈

super observe analyze <agent_id>

Analyze agent performance over time

super observe check

Check pipeline tracing configuration

🐛

super observe debug agent <agent_id>

Start interactive debugging session

📊 Dashboard Features

Real-time Trace Visualization

Watch agent execution in real-time

Performance Metrics & Charts

Analyze latency, success rates, and more

Tool Usage Analytics

Track which tools are used and when

Error Tracking

Debug issues with detailed error analysis

Memory & Context Analysis

Monitor memory usage and context

Export Capabilities

Export to JSON, CSV, or external tools

Launch Dashboard

# Launch dashboard with default settings
super observe dashboard

# Launch with custom port and auto-open browser
super observe dashboard --port 8502 --host localhost --auto-open

# Monitor a specific agent
super observe dashboard --agent-id developer_20250714_200501

📈 Performance Metrics

Key Metrics Tracked

Total EventsNumber of trace events
Success RatePercentage of successful events
Error RatePercentage of error events
Average DurationMean execution time
95th PercentilePerformance threshold
Tool UsageFrequency of tool calls
LLM CallsNumber of model interactions

Typical Performance Values

Metric	Typical Value
Setup Time	0.1-1.0ms
Tool Execution	0.1-10ms
LLM Processing	1-30 seconds
Total Execution	1-60 seconds

💡 Why Choose Native Observability?

Advantages

No external dependencies or setup
Works completely offline
Fast local queries
Privacy-friendly (data stays local)
Built-in dashboard included
Perfect for development & testing

When to use external backends:

MLFlow

ML experiments, model versioning, team collaboration

LangFuse

LLM-specific features, cost tracking, A/B testing

Weights & Biases

Research projects, hyperparameter tuning, team sharing

📚 Additional Resources

Observability Guide

Complete observability overview

Enhanced Observability

Multi-backend support guide

CLI Reference

Complete CLI commands

Demo Agent

Observability demo playbook

📊 Ready to Monitor Your Agents?

Start using SuperOptiX Native Observability today - no setup required!