Skip to content

配置参考

KaaS 通过 TOML 文件进行配置(默认:工作目录下的 kaas.toml)。每个 section 控制一个特定子系统。

[server]

类型默认值说明
hoststring"0.0.0.0"监听地址
portint8080监听端口

[storage]

类型默认值说明
driverstring"sqlite"存储驱动:"sqlite""mysql"
sqlite_pathstring"./data/kaas.db"SQLite 数据库文件路径
kb_dirstring"./data"知识库数据目录

[worker]

类型默认值说明
extract_workersint4并行提取 worker 数量
pipeline_concurrencyint2并发 pipeline 任务数
poll_interval_msint1000队列轮询间隔(毫秒)
lease_timeout_secint300Worker 租约超时(秒)
cb_failure_thresholdint5熔断器失败阈值
cb_cooldown_secint30熔断器冷却时间(秒)

[ai]

类型默认值说明
mcp_urlstring""远程 MCP 上游地址(已废弃 — 请改用 [ai.mcp]

[ai.daemon]

类型默认值说明
commandstring"uv"守护进程命令
args[]string["run", "--directory", "py", "kb-ai", "daemon"]守护进程命令参数
concurrencyint8守护进程最大并发数
warmup_timeout_secint30启动超时(秒)
max_restartsint5最大重启次数

[ai.mcp]

类型默认值说明
enabledboolfalse启用原生 MCP streamable-http 端点(/mcp
tokenstring""Bearer token 认证(空值表示不验证)
timeout_secint120工具调用超时(秒)

[llm]

类型默认值说明
api_keystring""OpenAI 兼容 API 密钥
base_urlstring"https://api.openai.com/v1"API 端点 URL
modelstring"gpt-4o-mini"模型名称
summarize_modelstring(同 model摘要任务使用的模型

[log]

类型默认值说明
levelstring"info"日志级别:debug / info / warn / error
formatstring"json"日志格式:json / text

[upload]

类型默认值说明
max_body_bytesint31457280multipart body 最大尺寸(30 MiB)
max_file_sizeint1048576单文件最大尺寸(1 MiB)
max_zip_file_sizeint5242880zip 压缩包最大尺寸(5 MiB)
max_files_per_uploadint20单次上传最大文件数
max_zip_entriesint200zip 中最大条目数
max_zip_extracted_sizeint31457280解压后最大总尺寸(30 MiB)