mirror of
https://github.com/bytedance/deer-flow.git
synced 2026-04-25 11:18:22 +00:00
2d5f6f1b3d
Agent-Logs-Url: https://github.com/bytedance/deer-flow/sessions/a5f192e7-8034-4e46-af22-60b90ee27d40 Co-authored-by: foreleven <4785594+foreleven@users.noreply.github.com>
123 lines
3.3 KiB
Plaintext
123 lines
3.3 KiB
Plaintext
import { Callout } from "nextra/components";
|
||
|
||
# 配置参考
|
||
|
||
本页面提供 `config.yaml` 中所有顶层字段的完整参考。
|
||
|
||
<Callout type="info">
|
||
查看仓库根目录中的 <code>config.example.yaml</code> 获取带注释的完整配置示例。
|
||
</Callout>
|
||
|
||
## 顶层字段
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `config_version` | `int` | 配置 schema 版本（当前：6） |
|
||
| `log_level` | `str` | 日志级别：`debug`/`info`/`warning`/`error` |
|
||
| `models` | `list` | 可用的 LLM 模型配置 |
|
||
| `image_generate_model` | `str \| list` | 图像生成使用的模型名称 |
|
||
| `token_usage` | `object` | Token 使用追踪配置 |
|
||
| `tools` | `list` | 可用工具配置 |
|
||
| `tool_groups` | `list` | 工具的命名分组 |
|
||
| `tool_search` | `object` | 延迟工具加载配置 |
|
||
| `sandbox` | `object` | 沙箱提供者配置 |
|
||
| `skills` | `object` | 技能目录和容器路径 |
|
||
| `skill_evolution` | `object` | Agent 管理的技能创建 |
|
||
| `subagents` | `object` | 子 Agent 超时和最大轮次 |
|
||
| `acp_agents` | `dict` | 外部 ACP Agent 配置 |
|
||
| `memory` | `object` | 跨会话记忆存储 |
|
||
| `summarization` | `object` | 对话摘要压缩 |
|
||
| `title` | `object` | 自动线程标题生成 |
|
||
| `checkpointer` | `object` | 线程状态持久化 |
|
||
| `guardrails` | `object` | 工具调用授权 |
|
||
| `uploads` | `object` | 文件上传配置 |
|
||
| `channels` | `list` | IM 频道集成 |
|
||
|
||
## models
|
||
|
||
```yaml
|
||
models:
|
||
- name: gpt-4o # 模型标识符（在请求中引用）
|
||
use: langchain_openai:ChatOpenAI # Python 类路径
|
||
model: gpt-4o # 传给 LLM 的模型名称
|
||
api_key: $OPENAI_API_KEY # API 密钥（支持环境变量）
|
||
base_url: null # 可选：自定义端点
|
||
request_timeout: 600.0 # 请求超时（秒）
|
||
max_retries: 2 # 重试次数
|
||
supports_vision: true # 是否启用视觉功能
|
||
thinking_enabled: false # 是否启用扩展思考
|
||
# 任何其他字段都会传递给模型构造函数
|
||
```
|
||
|
||
## sandbox
|
||
|
||
```yaml
|
||
sandbox:
|
||
# 本地（默认，无容器隔离）
|
||
use: deerflow.sandbox.local:LocalSandboxProvider
|
||
allow_host_bash: false
|
||
bash_output_max_chars: 20000
|
||
read_file_output_max_chars: 50000
|
||
ls_output_max_chars: 20000
|
||
|
||
# 基于容器
|
||
# use: deerflow.community.aio_sandbox:AioSandboxProvider
|
||
# image: enterprise-public-cn-beijing.cr.volces.com/vefaas-public/all-in-one-sandbox:latest
|
||
# replicas: 3
|
||
# idle_timeout: 600
|
||
```
|
||
|
||
## memory
|
||
|
||
```yaml
|
||
memory:
|
||
enabled: true
|
||
storage_path: memory.json
|
||
debounce_seconds: 30
|
||
max_facts: 100
|
||
fact_confidence_threshold: 0.7
|
||
injection_enabled: true
|
||
max_injection_tokens: 2000
|
||
model_name: null
|
||
```
|
||
|
||
## summarization
|
||
|
||
```yaml
|
||
summarization:
|
||
enabled: true
|
||
model_name: null
|
||
trigger:
|
||
- type: tokens
|
||
value: 15564
|
||
keep:
|
||
type: messages
|
||
value: 10
|
||
trim_tokens_to_summarize: 15564
|
||
summary_prompt: null
|
||
```
|
||
|
||
## checkpointer
|
||
|
||
```yaml
|
||
checkpointer:
|
||
type: sqlite # sqlite | redis | postgres
|
||
connection_string: .deer-flow/checkpoints.db
|
||
```
|
||
|
||
## subagents
|
||
|
||
```yaml
|
||
subagents:
|
||
timeout_seconds: 900
|
||
agents:
|
||
general-purpose:
|
||
timeout_seconds: 1800
|
||
max_turns: 160
|
||
bash:
|
||
timeout_seconds: 300
|
||
max_turns: 80
|
||
```
|
||
|
||
参见各功能的文档页面了解所有字段的详细说明。
|