Help & Documentation

Learn how to use the OpenAgents multi-agent orchestration system

What is OpenAgents?

OpenAgents is a multi-agent orchestration system that allows you to manage, configure, and simulate AI agents with different capabilities. The system is driven by a YAML configuration file that defines agent types, their behaviors, tools, and relationships.

Frontend (Next.js)

  • • React 18 with Server Components
  • • Tailwind CSS + shadcn/ui
  • • ReactFlow for graph visualization
  • • TypeScript for type safety

Backend (FastAPI)

  • • Python 3.11+ with FastAPI
  • • Pydantic models for validation
  • • API key authentication
  • • Integration with asdrp.agents

Main Features

1. Agent Simulation

Interact with agents in real-time through a Q&A interface.

  • • Select an agent from the dropdown
  • • View agent configuration (model, tools, connections)
  • • Send messages and receive responses
  • • View execution traces to understand agent behavior

2. Configuration Editor

Edit agent configuration with a YAML editor and visualize relationships.

  • • Edit YAML configuration with syntax highlighting
  • • Real-time YAML validation
  • • Save changes to update agents
  • • Visualize agent graph with ReactFlow
  • • Interactive nodes showing agent details

Multi-Agent Graph Concept

The multi-agent system uses a graph-based architecture where:

Agents (Nodes)

Each agent is a specialized component with specific capabilities, tools, and instructions. Examples: GeoAgent, FinanceAgent, MapAgent.

Edges (Connections)

Edges represent routing, delegation, or data flow between agents. They define how agents can communicate and orchestrate tasks.

Orchestration

The system can route requests through multiple agents, each contributing their specialized capabilities to solve complex tasks.

Technology Stack

Frontend

Next.js 14React 18TypeScriptTailwind CSSshadcn/uiReactFlowMonaco Editor

Backend

FastAPIPython 3.11+PydanticPyYAMLuvicorn

Additional Resources

Documentation and external links

Architecture Documentation

Detailed system architecture and design decisions

API Documentation

OpenAPI/Swagger documentation for backend API

README

Project overview and setup instructions