模型配置决定普通会话、知识库加工、批量任务、自动化和 Claw 等路径可用的模型。入口：设置 → 模型配置。
配置文件路径：~/.vetta/agent/models.json（开发隔离环境可能使用 VETTA_CONFIG_DIR 指向的目录）。
思考模式
页面顶部的 思考 为全局设置，对所有会话立即生效。可选：关闭、极低、低、中、高、极高。模型不支持时客户端会自动降级。
添加服务商
当前内置预设包括（以应用实际列表为准）：
- Claude
- OpenAI
- DeepSeek
- Z.ai (GLM)
- Kimi
- Grok
- Qwen
- Gemini
选择预设
在 预设服务商 区域选择目标服务商。
填写 API Key
按服务商要求填写密钥。占位提示支持 sk-... 等形式。
拉取或添加模型
使用 从接口拉取 勾选模型并添加，或手动 添加模型（模型 ID、显示名、输入能力、上下文窗口、最大输出、是否支持推理等）。
设为默认
在模型列表中将常用模型 设为默认模型。
远程目录中的模型（若账号已登录且组织提供）可在列表中刷新获取，与本地服务商并列展示。
验证配置
常见失败原因：Base URL 路径多写或少写、模型 ID 不存在、密钥无效、账户无权限、代理拦截、网络不可达。
把模型用于真实任务前
- 新建会话能够显式选择该模型，并完成一条短消息。
- 切换默认模型后，新会话显示预期选择。
- 模型能力标记与上游实际支持一致，没有依赖自动猜测。
- 知识库、自动化或 Claw 使用的模型已在对应入口单独验证。
- 配置文件和诊断信息中没有要提交到仓库的真实密钥。