Skip to content

Latest commit

 

History

History
67 lines (49 loc) · 3.21 KB

File metadata and controls

67 lines (49 loc) · 3.21 KB

Agent System Documentation

Core agent capabilities including governance, graduation, and orchestration.

Core Components

Governance & Maturity

Guidance & Orchestration

Multi-Agent Coordination ✨ NEW

Key Concepts

Agent Maturity Levels

Level Confidence Automated Triggers Capabilities
STUDENT <0.5 Blocked (read-only) Charts, markdown presentation
INTERN 0.5-0.7 Proposal required Streaming, form presentation
SUPERVISED 0.7-0.9 Supervised execution Form submissions, state changes
AUTONOMOUS >0.9 Full execution All capabilities

⚡ Capability Graduation Logic

Individual capabilities (skills, tools, actions) graduate independently based on usage:

Capability Level Promotion Requirement Added Permissions
STUDENT → INTERN 5 successful uses Basic tool access
INTERN → SUPERVISED 20 successful uses Advanced integrations
SUPERVISED → AUTONOMOUS 50 successful uses Full autonomy, critical actions

How It Works:

  1. Each capability use is tracked via CapabilityGraduationService.record_usage()
  2. Success counts accumulate in agent.properties["capability_stats"]
  3. Automatic promotion when thresholds are reached
  4. Can be reset to STUDENT if issues occur

See: Capability Graduation Details

Intent Classification

  • CHAT - Simple queries → LLMService
  • WORKFLOW - Structured tasks → Queen Agent (Queen Hive) → Workflow Automation
  • TASK - Unstructured complex long-horizon tasks → Fleet AdmiralDynamic Fleet Coordination

Key Distinction:

  • Queen Agent handles structured complex tasks with predefined steps (repeatable business processes)
  • Fleet Admiral handles unstructured complex long-horizon tasks requiring adaptive planning and dynamic agent recruitment

Quick Links


Last Updated: April 5, 2026