agents.yaml.example - main - githubmirror/sgr-agent-core

agents.yaml.example
123 строки3 KB
Lysenko Artem
0.7.0 pre release (#185)
17 мар 2026, 19:28
17 мар 2026, 19:284cffec7
# Example Custom Agents Configuration
# =====================================
# This file demonstrates how to define custom agents for SGR Agent Core.

# Notes:
# ------
# 1. Agent names must be unique or will be overridden
# 2. All tools must be registered in the tool registry
# 3. LLM, Prompts, Execution, MCP settings are optional and inherit from global config
# 4. Agents override global settings by providing their own values

agents:
  # Example 1: Simple custom research agent with overrides
  custom_research_agent:
    base_class: "sgr_agent_core.agents.sgr_agent.SGRAgent"
    # Optional: Override LLM settings for this agent
    llm:
      model: "gpt-4o"
      temperature: 0.3
      max_tokens: 16000
      # api_key: "your-custom-api-key"  # Optional: use different API key
      # base_url: "https://api.openai.com/v1"  # Optional: use different endpoint
      # proxy: "http://127.0.0.1:8080"  # Optional: use proxy

    # Optional: Execution configuration
    execution:
      max_iterations: 15
      max_clarifications: 5
      mcp_context_limit: 20000
      logs_dir: "logs/custom_agent"
      reports_dir: "reports/custom_agent"

    # Optional: MCP configuration
    mcp:
      mcpServers:
        deepwiki:
          url: "https://mcp.deepwiki.com/mcp"

    # Tools: list of names, or per-tool overrides with optional kwargs
    tools:
      - web_search_tool:
          max_results: 15
          max_searches: 6
      - extract_page_content_tool:
          content_limit: 2000
      - "create_report_tool"
      - "clarification_tool"
      - "generate_plan_tool"
      - "adapt_plan_tool"
      - "final_answer_tool"

  # Example 2: Minimal agent with defaults
  simple_agent:
    base_class: "SGRToolCallingAgent"

    # Only override what's needed
    llm:
      model: "gpt-4o-mini"

    tools:
      - "web_search_tool"
      - "final_answer_tool"

  # Example 3: Fast research agent optimized for speed
  fast_research_agent:
    base_class: "SGRToolCallingAgent"

    llm:
      model: "gpt-4o-mini"
      temperature: 0.1
      max_tokens: 4000

    execution:
      max_iterations: 8
      max_clarifications: 2

    tools:
      - web_search_tool:
          max_searches: 3
      - "create_report_tool"
      - "final_answer_tool"
      - "reasoning_tool"

  # Example 4: Specialized technical analyst with custom prompts
  technical_analyst:
    base_class: "SGRAgent"

    llm:
      model: "gpt-4o"
      temperature: 0.2

    prompts:
      system_prompt_str: "You are a highly specialized technical analyst."

    execution:
      max_iterations: 20
      max_clarifications: 3

    tools:
      - web_search_tool:
          max_searches: 8
      - "extract_page_content_tool"
      - "create_report_tool"
      - "clarification_tool"
      - "final_answer_tool"

  # Example 5: Agent using inline prompts instead of files
  inline_prompt_agent:
    base_class: "SGRAgent"

    prompts:
      system_prompt_str: |
        You are a helpful research assistant.
        Your goal is to provide accurate and concise information.
      initial_user_request_str: |
        User request: {user_request}
        Please analyze and respond.
      clarification_response_str: |
        I need clarification on: {clarification_needed}

    tools:
      - "web_search_tool"
      - "final_answer_tool"