sgr-agent-core/agents.yaml.example at main · vamplabAI/sgr-agent-core · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
# 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"