feat(copilot): local agent generation with validation, fixing, MCP & sub-agent support

autogpt_platform/backend/backend/copilot/config.py

@@ -93,6 +93,14 @@ class ChatConfig(BaseSettings):
         "history compression. Falls back to compression when unavailable.",
     )
 
+    # Agent generation: local (Claude Agent SDK as brain) vs external service
+    agent_generator_use_local: bool = Field(
+        default=True,
+        description="Use local agent generation (Claude Agent SDK generates JSON, "
+        "validated/fixed locally). When False, falls back to the external "
+        "AgentGenerator service for decomposition and generation.",
+    )
+
     # Extended thinking configuration for Claude models
     thinking_enabled: bool = Field(
         default=True,
@@ -130,6 +138,15 @@ def get_base_url(cls, v):
                 v = "https://openrouter.ai/api/v1"
         return v
 
+    @field_validator("agent_generator_use_local", mode="before")
+    @classmethod
+    def get_agent_generator_use_local(cls, v):
+        """Get agent_generator_use_local from environment if not provided."""
+        env_val = os.getenv("CHAT_AGENT_GENERATOR_USE_LOCAL", "").lower()
+        if env_val:
+            return env_val in ("true", "1", "yes", "on")
+        return True if v is None else v
+
     @field_validator("use_claude_agent_sdk", mode="before")
     @classmethod
     def get_use_claude_agent_sdk(cls, v):

autogpt_platform/backend/backend/copilot/sdk/service.py

@@ -214,6 +214,86 @@ def _build_sdk_tool_supplement(cwd: str) -> str:
 ### Sub-agent tasks
 - When using the Task tool, NEVER set `run_in_background` to true.
   All tasks must run in the foreground.
+
+## Agent Generation Guide
+
+You can create, edit, and customize agents directly. You ARE the brain —
+generate the agent JSON yourself using the block schemas, then validate and save.
+
+### Agent JSON Structure
+
+```json
+{{
+  "id": "<UUID v4>",        // auto-generated if omitted
+  "version": 1,
+  "is_active": true,
+  "name": "Agent Name",
+  "description": "What the agent does",
+  "nodes": [
+    {{
+      "id": "<UUID v4>",
+      "block_id": "<block UUID from get_blocks_for_goal>",
+      "input_default": {{
+        "field_name": "design-time value"
+      }},
+      "metadata": {{
+        "position": {{"x": 0, "y": 0}},
+        "customized_name": "Optional display name"
+      }}
+    }}
+  ],
+  "links": [
+    {{
+      "id": "<UUID v4>",
+      "source_id": "<source node UUID>",
+      "source_name": "output_field_name",
+      "sink_id": "<sink node UUID>",
+      "sink_name": "input_field_name",
+      "is_static": false
+    }}
+  ]
+}}
+```
+
+### Workflow for Creating/Editing Agents
+
+1. **Discover blocks**: Call `get_blocks_for_goal` with the user's goal
+2. **Generate JSON**: Build the agent JSON using block schemas:
+   - Use block IDs from step 1 as `block_id` in nodes
+   - Wire outputs to inputs using links
+   - Set design-time config in `input_default`
+   - Use `AgentInputBlock` for values the user provides at runtime
+3. **Validate**: Call `validate_agent_graph` to check correctness
+4. **Fix if needed**: Call `fix_agent_graph` to auto-fix common issues,
+   or fix manually based on error descriptions
+5. **Save**: Call `create_agent` (new) or `edit_agent` (existing) with
+   `agent_json` parameter
+
+### Key Rules
+
+- **Design-time vs runtime**: `input_default` = values known at build time.
+  For user-provided values, create an `AgentInputBlock` node and link its
+  output to the consuming block's input.
+- **Never hardcode secrets**: Use `AgentInputBlock` for API keys, passwords, etc.
+- **Node spacing**: Position nodes with at least 800 X-units between them.
+- **Nested properties**: Use `parentField_#_childField` notation in link
+  sink_name/source_name to access nested object fields.
+- **is_static links**: Set `is_static: true` when the link carries a
+  design-time constant (matches a field in inputSchema with a default).
+- **ConditionBlock**: Needs a `StoreValueBlock` wired to its `value2` input.
+- **Prompt templates**: Use `{{{{variable}}}}` (double curly braces) for
+  literal braces in prompt strings — single `{{` and `}}` are for
+  template variables.
+- **AgentExecutorBlock**: When composing sub-agents, set `graph_id` and
+  `graph_version` in input_default, and wire inputs/outputs to match
+  the sub-agent's schema.
+
+### Example: Simple AI Text Processor
+
+A minimal agent that takes user input, processes it with AI, and outputs result:
+- Node 1: `AgentInputBlock` (block for user input, output: "result")
+- Node 2: `AITextGeneratorBlock` (input: "prompt" linked from Node 1)
+- Node 3: `AgentOutputBlock` (input: "value" linked from Node 2's output)
 """
 
 

autogpt_platform/backend/backend/copilot/tools/__init__.py

@@ -17,10 +17,13 @@
 from .find_agent import FindAgentTool
 from .find_block import FindBlockTool
 from .find_library_agent import FindLibraryAgentTool
+from .fix_agent import FixAgentGraphTool
+from .get_blocks import GetBlocksForGoalTool
 from .get_doc_page import GetDocPageTool
 from .run_agent import RunAgentTool
 from .run_block import RunBlockTool
 from .search_docs import SearchDocsTool
+from .validate_agent import ValidateAgentGraphTool
 from .web_fetch import WebFetchTool
 from .workspace_files import (
     DeleteWorkspaceFileTool,
@@ -56,6 +59,10 @@
     # Feature request tools
     "search_feature_requests": SearchFeatureRequestsTool(),
     "create_feature_request": CreateFeatureRequestTool(),
+    # Agent generation tools (local validation/fixing/block discovery)
+    "get_blocks_for_goal": GetBlocksForGoalTool(),
+    "validate_agent_graph": ValidateAgentGraphTool(),
+    "fix_agent_graph": FixAgentGraphTool(),
     # Workspace tools for CoPilot file operations
     "list_workspace_files": ListWorkspaceFilesTool(),
     "read_workspace_file": ReadWorkspaceFileTool(),

autogpt_platform/backend/backend/copilot/tools/agent_generator/__init__.py

@@ -29,9 +29,12 @@
 from .errors import get_user_message_for_error
 from .service import health_check as check_external_service_health
 from .service import is_external_service_configured
+from .validation import AgentFixer, AgentValidator
 
 __all__ = [
+    "AgentFixer",
     "AgentGeneratorNotConfiguredError",
+    "AgentValidator",
     "AgentJsonValidationError",
     "AgentSummary",
     "DecompositionResult",