DocumentationNeuronAgent Documentation
Documentation Branch: You are viewing documentation for the main branch (3.0.0-devel). Select a branch to view its documentation:

Multi-Agent Collaboration

Overview

NeuronAgent supports multi-agent collaboration, enabling agents to work together on complex tasks through delegation, communication, and shared workspaces. This system allows for hierarchical agent structures and coordinated task execution.

Key Features

  • Agent Delegation: Delegate tasks to specialized agents with automatic routing
  • Inter-Agent Communication: Message passing between agents with structured protocols
  • Workspace Management: Shared workspaces for collaborative agents with isolation and permissions
  • Sub-Agents: Hierarchical agent structures for complex multi-level task decomposition
  • Task Coordination: Coordinate parallel and sequential task execution across agents
  • Agent Discovery: Discover and select appropriate agents for task delegation
  • Shared Context: Shared context and state management across collaborating agents

Agent Delegation

Agents can delegate tasks to other specialized agents based on capabilities, workload, and availability. The system automatically routes tasks to the most appropriate agent.

Delegation Strategies

  • Capability-Based: Delegate based on agent capabilities and expertise
  • Load Balancing: Distribute tasks based on agent workload
  • Availability: Route to available agents with appropriate capacity
  • Specialization: Delegate to agents specialized in specific domains

Delegation Protocol

Delegation uses a structured protocol that includes task description, requirements, context, and expected outcomes. Delegated agents can return results, request clarification, or further delegate subtasks.

Inter-Agent Communication

Agents communicate through structured message passing protocols, enabling coordination and information sharing across agent boundaries.

Message Types

  • Task Requests: Request another agent to perform a task
  • Task Results: Return results from delegated tasks
  • Status Updates: Share status and progress information
  • Coordination Messages: Coordinate multi-agent workflows

Communication Channels

Agents can communicate through direct messaging, shared workspaces, or event streams, providing flexibility in communication patterns.

Workspace Management

Shared workspaces provide isolated environments for collaborative agents, with fine-grained permissions and resource management.

Workspace Features

  • Isolation: Workspaces provide isolation between different agent groups
  • Permissions: Fine-grained permissions for workspace access and operations
  • Resource Sharing: Shared resources and context within workspaces
  • Collaboration Tools: Tools for coordination and collaboration

Workspace Types

  • Project Workspaces: Long-term workspaces for ongoing projects
  • Task Workspaces: Temporary workspaces for specific tasks
  • Shared Workspaces: Workspaces shared across multiple agent groups

Sub-Agents

Hierarchical agent structures enable complex multi-level task decomposition, where agents can create and manage sub-agents for specialized subtasks.

Hierarchical Structure

Agents can create sub-agents with specific capabilities and configurations, forming hierarchical structures that mirror task decomposition.

Sub-Agent Management

  • Creation: Create sub-agents with specific configurations
  • Lifecycle: Manage sub-agent lifecycle and termination
  • Monitoring: Monitor sub-agent status and progress
  • Coordination: Coordinate sub-agent activities

Task Coordination

Task coordination enables parallel and sequential task execution across multiple agents, with dependency management and result aggregation.

Coordination Patterns

  • Parallel Execution: Execute independent tasks in parallel
  • Sequential Execution: Execute tasks in sequence with dependencies
  • Pipeline Execution: Execute tasks in pipeline with data flow
  • Result Aggregation: Aggregate results from multiple agents

Dependency Management

The system automatically manages task dependencies, ensuring that prerequisite tasks complete before dependent tasks begin.

API Reference

Multi-agent collaboration is accessible through the NeuronAgent REST API for managing collaborations, workspaces, and delegations.

Collaboration Endpoints

  • POST /api/v1/collaborations - Create a collaboration
  • GET /api/v1/collaborations - List collaborations
  • POST /api/v1/collaborations/:id/delegate - Delegate a task
  • POST /api/v1/workspaces - Create a workspace
  • GET /api/v1/workspaces - List workspaces
  • POST /api/v1/agents/:id/sub-agents - Create a sub-agent