本文档涵盖了 Open Interpreter 中的配置系统,解释了如何自定义解释器、语言模型和代码执行环境的行为。该配置系统允许您通过各种界面修改设置,从而根据不同的用例调整 Open Interpreter。
有关特定语言模型配置的信息,请参阅语言模型。有关代码执行设置的详细信息,请参阅代码执行。
Open Interpreter 可以通过三种主要机制进行配置:
来源
使用终端界面时,您可以将配置选项作为命令行参数传递:
这允许对单个会话进行快速定制,而无需修改任何配置文件。
将 Open Interpreter 用作 Python 库时,可以通过设置属性来配置它:
对于持久性配置,您可以创建 YAML、Python 或 JSON 格式的配置文件。这是为不同用例维护不同配置的最强大方式。
配置文件系统是一个核心功能,允许您保存和应用针对特定用例的不同配置。
来源
defaults 目录中interpreter --profiles 访问interpreter --profile <name> 应用特定配置文件interpreter --reset_profile 重置为默认配置Open Interpreter 支持多种配置文件格式,以适应不同的用户偏好和用例
YAML 配置文件提供了一种简单、声明式的方式来配置 Open Interpreter
Python 配置文件提供更大的灵活性,可进行动态配置
JSON 配置文件提供了一种替代的声明式格式
Open Interpreter 中的配置参数按层级组织,主要组件是解释器本身、语言模型 (LLM) 和计算机系统。
来源
这些设置控制语言模型的行为
| 设置 | 描述 | 默认 | CLI 标志 |
|---|---|---|---|
model | 要使用的语言模型 | "gpt-4o" | --model |
temperature | 随机性水平(0-1) | 0 | --temperature |
context_window | 上下文窗口大小(以 token 计) | 取决于模型 | --context_window |
max_tokens | 最大生成 token 数量 | 取决于模型 | --max_tokens |
api_key | 用于身份验证的 API 密钥 | 无 | --api_key |
api_base | 自定义 API 基础 URL | 提供商默认 | --api_base |
支持视觉 | 模型支持视觉 | false | --llm_supports_vision |
支持函数 | 模型支持函数调用 | false | --llm_supports_functions |
来源
这些设置控制核心解释器的行为
| 设置 | 描述 | 默认 | CLI 标志 |
|---|---|---|---|
auto_run | 无需确认即可运行代码 | false | --auto_run |
offline | 禁用在线功能 | false | --offline |
loop | 在循环中强制完成任务 | false | --loop |
verbose | 启用调试信息 | false | --verbose |
safe_mode | 安全机制模式 | "off" | --safe_mode |
custom_instructions | 附加指令 | "" | --custom_instructions |
max_budget | 最大预算(美元) | 无 | --max_budget |
vision | 启用视觉模式 | false | --vision |
os | 启用操作系统模式 | false | --os |
来源
这些设置控制代码执行环境
| 设置 | 描述 | 默认 |
|---|---|---|
computer.offline | 禁用计算机的在线功能 | false |
computer.verbose | 为计算机启用详细日志记录 | false |
computer.emit_images | 控制图像输出 | false |
computer.import_computer_api | 在系统消息中包含计算机 API | true |
来源
默认配置使用 GPT-4o 和保守设置
来源:interpreter/terminal_interface/profiles/defaults/default.yaml
使用较小模型以获得更快响应
来源:interpreter/terminal_interface/profiles/defaults/fast.yaml
将 Open Interpreter 与图像功能结合使用
来源:interpreter/terminal_interface/profiles/defaults/vision.yaml
Open Interpreter 包含在版本之间迁移配置文件的机制,因为配置格式会不断演进。当前配置版本为 0.2.5。
当检测到旧版本配置文件时,Open Interpreter 将:
迁移过程由配置文件系统中的 migrate_profile 函数处理。
来源
配置系统包含几个用于管理设置的特殊命令
| 命令 | 描述 |
|---|---|
interpreter --profiles | 打开配置文件目录 |
interpreter --reset_profile | 将配置文件重置为默认 |
interpreter --local_models | 打开本地模型目录 |
interpreter --version | 显示已安装版本 |
interpreter --disable_telemetry | 选择退出遥测数据收集 |
interpreter --help | 显示所有可用的 CLI 选项 |
来源
Open Interpreter 包含匿名遥测功能,可以通过配置禁用
或通过 CLI
或在 Python 中
有关遥测的更多信息,请参阅遥测。
来源
Open Interpreter 配置系统主要通过 profiles.py 模块实现,该模块负责配置文件的加载、应用和迁移。该系统采用分层结构,根据其影响的组件逻辑地组织设置。
应用设置时,Open Interpreter 会递归地遍历配置层级,并将每个设置应用到解释器对象中相应的属性。
来源