菜单

配置

相关源文件

目的与范围

本文档涵盖了 Open Interpreter 中的配置系统,解释了如何自定义解释器、语言模型和代码执行环境的行为。该配置系统允许您通过各种界面修改设置,从而根据不同的用例调整 Open Interpreter。

有关特定语言模型配置的信息,请参阅语言模型。有关代码执行设置的详细信息,请参阅代码执行

配置源

Open Interpreter 可以通过三种主要机制进行配置:

来源

命令行参数

使用终端界面时,您可以将配置选项作为命令行参数传递:

这允许对单个会话进行快速定制,而无需修改任何配置文件。

Python API

将 Open Interpreter 用作 Python 库时,可以通过设置属性来配置它:

配置文件

对于持久性配置,您可以创建 YAML、Python 或 JSON 格式的配置文件。这是为不同用例维护不同配置的最强大方式。

配置文件系统

配置文件系统是一个核心功能,允许您保存和应用针对特定用例的不同配置。

来源

配置文件位置和管理

  • 默认配置文件:随 Open Interpreter 一起提供,位于包的 defaults 目录中
  • 用户配置文件:存储在用户特定的目录中,可通过 interpreter --profiles 访问
  • 应用配置文件:使用 interpreter --profile <name> 应用特定配置文件
  • 重置配置文件:使用 interpreter --reset_profile 重置为默认配置

配置文件格式

Open Interpreter 支持多种配置文件格式,以适应不同的用户偏好和用例

YAML 配置文件提供了一种简单、声明式的方式来配置 Open Interpreter

Python 配置文件

Python 配置文件提供更大的灵活性,可进行动态配置

JSON 配置文件

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在系统消息中包含计算机 APItrue

来源

常见配置示例

默认配置

默认配置使用 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 将:

  1. 通知用户格式已过时
  2. 提供将配置文件迁移到当前格式的选项
  3. 更新参数名称和结构,同时保留设置

迁移过程由配置文件系统中的 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 会递归地遍历配置层级,并将每个设置应用到解释器对象中相应的属性。

来源