Skip to content

Commit 55d414f

Browse files
committed
upd docs.
1 parent c79d8ac commit 55d414f

File tree

3 files changed

+129
-0
lines changed

3 files changed

+129
-0
lines changed
Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
defaults:
2+
- benchmark: gaia-validation
3+
- override hydra/job_logging: none
4+
- _self_ # Allow defining variables at the top of this file
5+
6+
7+
main_agent:
8+
prompt_class: MainAgentPromptBoxedDeepSeek
9+
llm:
10+
provider_class: "DeepSeekOpenRouterClient"
11+
model_name: "deepseek/deepseek-chat-v3.1"
12+
async_client: true
13+
temperature: 0.3
14+
top_p: 0.95
15+
min_p: 0.0
16+
top_k: -1
17+
max_tokens: 32000
18+
openrouter_api_key: "${oc.env:OPENROUTER_API_KEY,???}"
19+
openrouter_base_url: "${oc.env:OPENROUTER_BASE_URL,https://openrouter.ai/api/v1}"
20+
openrouter_provider: null
21+
disable_cache_control: false
22+
keep_tool_result: -1
23+
oai_tool_thinking: false
24+
25+
tool_config:
26+
- tool-reasoning
27+
28+
max_turns: -1 # Maximum number of turns for main agent execution
29+
max_tool_calls_per_turn: 10 # Maximum number of tool calls per turn
30+
31+
input_process:
32+
hint_generation: true
33+
hint_llm_base_url: "${oc.env:HINT_LLM_BASE_URL,https://api.openai.com/v1}"
34+
output_process:
35+
final_answer_extraction: true
36+
final_answer_llm_base_url: "${oc.env:FINAL_ANSWER_LLM_BASE_URL,https://api.openai.com/v1}"
37+
38+
openai_api_key: "${oc.env:OPENAI_API_KEY,???}" # used for hint generation and final answer extraction
39+
add_message_id: true
40+
keep_tool_result: -1
41+
chinese_context: "${oc.env:CHINESE_CONTEXT,false}"
42+
43+
44+
sub_agents:
45+
agent-worker:
46+
prompt_class: SubAgentWorkerPromptDeepSeek
47+
llm:
48+
provider_class: "DeepSeekOpenRouterClient"
49+
model_name: "deepseek/deepseek-chat-v3.1"
50+
async_client: true
51+
temperature: 0.3
52+
top_p: 0.95
53+
min_p: 0.0
54+
top_k: -1
55+
max_tokens: 32000
56+
openrouter_api_key: "${oc.env:OPENROUTER_API_KEY,???}"
57+
openrouter_base_url: "${oc.env:OPENROUTER_BASE_URL,https://openrouter.ai/api/v1}"
58+
openrouter_provider: null
59+
disable_cache_control: false
60+
keep_tool_result: -1
61+
oai_tool_thinking: false
62+
63+
tool_config:
64+
- tool-searching
65+
- tool-image-video
66+
- tool-reading
67+
- tool-code
68+
- tool-audio
69+
70+
max_turns: -1 # Maximum number of turns for main agent execution
71+
max_tool_calls_per_turn: 10 # Maximum number of tool calls per turn
72+
73+
74+
# Can define some top-level or default parameters here
75+
output_dir: logs/
76+
data_dir: "${oc.env:DATA_DIR,data}" # Points to where data is stored
77+

docs/mkdocs/docs/deepseek.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# DeepSeek
2+
3+
DeepSeek's advanced language models with strong reasoning capabilities and tool use support, accessible via OpenRouter.
4+
5+
## Available Clients
6+
7+
### DeepSeekOpenRouterClient (OpenRouter API)
8+
9+
**Environment Setup:**
10+
11+
Set the `OPENROUTER_API_KEY` environment variable
12+
```bash title="Environment Variables"
13+
export OPENROUTER_API_KEY="your-key"
14+
```
15+
or add it to the `.env` file.
16+
17+
**Configuration:**
18+
19+
```yaml title="Agent Configuration"
20+
main_agent:
21+
llm:
22+
provider_class: "DeepSeekOpenRouterClient"
23+
model_name: "deepseek/deepseek-chat-v3.1" # Available DeepSeek models via OpenRouter
24+
async_client: true
25+
temperature: 0.3
26+
top_p: 0.95
27+
min_p: 0.0
28+
top_k: -1
29+
max_tokens: 32000
30+
openrouter_api_key: "${oc.env:OPENROUTER_API_KEY,???}"
31+
openrouter_base_url: "${oc.env:OPENROUTER_BASE_URL,https://openrouter.ai/api/v1}"
32+
openrouter_provider: null # You can specify the provider to use
33+
disable_cache_control: false
34+
keep_tool_result: -1
35+
oai_tool_thinking: false
36+
```
37+
38+
## Usage
39+
40+
```bash title="Example Command"
41+
# Run with DeepSeek v3.1 Chat (OpenRouter) on example dataset
42+
uv run main.py common-benchmark --config_file_name=agent_llm_deepseek_openrouter output_dir="logs/test"
43+
```
44+
45+
The `agent_llm_deepseek_openrouter.yaml` configuration file provides a ready-to-use setup with the example dataset benchmark, while `agent_gaia-validation_deepseek.yaml` is an setup for the GAIA-Validation benchmark with main agent and sub agent configured.
46+
47+
48+
---
49+
50+
!!! info "Documentation Info"
51+
**Last Updated:** October 2025 · **Doc Contributor:** Team @ MiroMind AI

docs/mkdocs/mkdocs.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,7 @@ nav:
107107
- Claude 3.7 Sonnet (OpenRouter): openrouter-claude-3.7-sonnet.md
108108
- GPT-5: openai-gpt5.md
109109
- GPT-4o: openai-gpt4o.md
110+
- DeepSeek: deepseek.md
110111

111112
- 📚 Resources:
112113
- All About Agents: all_about_agents.md

0 commit comments

Comments
 (0)