…aceroot-ai#85) Implements a structured workflow system for routing user queries to appropriate specialized subagents, as requested in issue traceroot-ai#85. ## Changes ### New Components 1. **AgentWorkflow class** (rest/agent/workflow.py): - Orchestrates routing of queries to specialized subagents - Uses ChatRouter + AgentRegistry for intelligent routing - Returns WorkflowResult with agent handler and routing metadata 2. **AgentRegistry class** (rest/agent/workflow.py): - Registry pattern for managing available agents - Stores agent metadata (name, description, supported operations, requirements) - Easy agent lookup and listing 3. **AgentType enum** (rest/agent/workflow.py): - Type-safe enum for agent types (SINGLE_RCA, CODE, GENERAL) - Replaces string literals for better type safety 4. **WorkflowContext dataclass** (rest/agent/workflow.py): - Encapsulates all context needed for routing decisions - Includes user message, chat mode, trace context, GitHub flags, etc. 5. **WorkflowResult dataclass** (rest/agent/workflow.py): - Contains routing decision with agent handler and metadata - Includes reasoning for transparency ### Documentation - **README_WORKFLOW.md**: Comprehensive guide to the workflow system - Component descriptions - Usage examples - Integration guide - How to add new agents - **examples/agent_workflow_example.py**: Working example demonstrating: - Registry setup and agent registration - Workflow routing for different query types - How GitHub PR queries route to Code Agent - How trace analysis routes to Single RCA Agent - How general queries route to General Agent ### Updated Exports - Updated rest/agent/__init__.py to export workflow components - Maintains backward compatibility with existing code ## Example Usage ```python # Create registry and register agents registry = AgentRegistry() registry.register( agent_type=AgentType.CODE, name="Code Agent", handler=code_agent, supported_operations=["create_issue", "create_pr"], requires_github_token=True, ) # Create workflow workflow = AgentWorkflow(registry, router) # Route a GitHub PR query context = WorkflowContext( user_message="Create a PR to fix this bug", is_github_pr=True, ... ) result = await workflow.route(context) # Get the appropriate agent and use it agent = result.agent_metadata.handler response = await agent.chat(...) ``` ## Benefits - **Explicit Workflow**: Makes agent routing logic clear and documented - **Type Safety**: Using enums and dataclasses for better type checking - **Extensibility**: Easy to add new agents via registry pattern - **Visibility**: Provides reasoning for each routing decision - **Backward Compatible**: Existing code continues to work unchanged - **Testability**: Components can be tested independently ## Related Issues - Closes traceroot-ai#85 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>

[Enhancement][Agent] A workflow to redirect to some agents #85

Description

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions