进阶 docs.openwebui.com 2026-10-22 19:22:27 · 26 阅读

第5章 Open Terminal 与 Terminals:构建完整智能体运行框架

Open Terminal 与 Terminals

将 Open WebUI 打造为完整的智能体运行框架:包括控制层、动作层,以及两者间的反馈循环。

Open Terminal 是补全 Open WebUI 框架的动作层。Open WebUI 已具备模型、对话、提示词、知识库、工具、MCP 连接、记忆、用户、权限、自动化及工作流控制等功能。Open Terminal 则提供计算机底层支持:文件、Shell、包管理器、运行中的进程、文档与数据处理、生成的工件及实时预览。

虽然名为“终端”,但其定位远超普通的 Shell 面板。它赋予模型一个有状态的工作区,使模型能够创建、运行、检查、修复代码,并最终交付可用的成果。

当对话仅靠文本回复不足以解决问题时,即可使用 Open Terminal:分析电子表格、编写脚本、构建小型应用、渲染报告、检查日志、运行测试、整理文件或启动服务器并预览结果。Open WebUI 仍作为界面保持职责不变;Open Terminal 则为智能体提供一个能够实际产出这些结果的工作区。

Terminals 是 Open Terminal 的企业级编排器。它将单个智能体工作区转化为受管理的集群:按用户和政策划分独立工作区,支持受控镜像、资源限制、存储配置、环境变量、安全上下文、闲置清理、刷新及定期重置。

想在浏览器中操作自己的电脑?Open Terminal 在 Open WebUI 框架内为 AI 提供计算机底层支持。而 Open WebUI Computer 则让你在浏览器中访问真实的本地机器,支持文件、编辑器、终端、Git 及可选的 AI 助手。查看《Computer、Open WebUI 还是 Open Terminal?》,了解简短对比。

常用概念

如果你听说过智能体运行框架(agent harness)、智能体工作流、工具使用、计算机使用、运行时、护栏或编排等术语,那么 Open Terminal 和 Terminals 正是落实这些概念的地方。

人们常用的术语 | 此处的含义 ---|--- 智能体运行框架 | Open WebUI 加上 Open Terminal:前者提供控制、上下文和工具,后者提供真实的行动与观察能力 智能体工作流 | 模型规划、执行动作、观察结果并持续迭代,而非仅返回静态答案 工具使用 / 函数调用 | Open WebUI 允许模型调用工具;Open Terminal 为这些工具提供真实的文件系统、Shell 和进程环境 计算机使用 | 智能体在类似计算机的工作区内操作:涉及文件、命令、包、预览及生成的工件 智能体运行时 | 围绕模型的循环和状态;Open Terminal 在其内部提供操作系统级的行动工作区 有状态会话 | 工作区在足够长的时间内保留文件、输出、进程和任务上下文,以支持多步骤工作 护栏 / 人工审查 | Open WebUI 控制用户、模型、工具和审批层;Terminals 通过策略控制工作区边界 编排 | Terminals 为团队开通、路由、隔离、刷新和清理 Open Terminal 工作区 可观测性 / 可审计性 | 管理员可以追溯产生结果的来源:用户、策略、工作区、镜像、限制及生命周期

从 Open Terminal 开始

我想要... | 前往 ---|--- 理解产品定位 | Open Terminal 概览 安装 Open Terminal | 安装指南 将其连接到 Open WebUI | 连接指南 浏览、上传、预览和编辑文件 | 文件浏览器 运行代码和调试脚本 | 代码执行 处理软件项目 | 软件开发 分析和处理文档与数据 | 文档与数据分析 构建和预览 Web 应用 | Web 开发 自动化文件夹和系统任务 | 系统自动化 查看更多完整工作流 | 高级工作流

通过 Terminals 扩展规模

当智能体工作区需要按策略进行开通、隔离、复用、刷新和重置,而非手动逐个配置环境时,请使用 Terminals。

我想要... | 前往 ---|--- 阅读 Terminals 概览 | Terminals 概览 理解开通流程 | 编排 配置镜像、资源、存储、环境变量和闲置超时 | 策略 理解环境变量转发和保留关键字 | 环境变量 构建和部署自定义工作区镜像 | 自定义镜像 在策略变更后刷新用户 | 应用变更 按计划重置持久化工作区 | 定期重置 在 OpenShift 上运行 | OpenShift 调整生成的系统提示词 | 系统提示词 暴露干净的根目录用于文件浏览器 | 文件浏览器根目录 调试 API 和支持问题 | API 与故障排查

如何理解其架构

Open WebUI 是运行框架的控制端:涵盖模型、对话、提示词、知识、用户、权限、自动化、工具、审批及共享工作流。Open Terminal 则提供缺失的、形似操作系统的动作层,位于对话界面背后。

这一补充改变了 Open WebUI 的用途边界。模型可以从“解释下一步”转变为“执行下一步”:创建文件、运行命令、检查错误、修复问题,并返回完成的工件。

智能体循环变得具体:

1. 检查工作区。 2. 选择动作。 3. 创建或编辑文件。 4. 运行代码、命令、工具或服务器。 5. 读取输出。 6. 修复失败项。 7. 返回工件。

这是“关于工作的答案”与“智能体执行工作”之间的区别。

对于团队而言,同一模型也可转化为基础设施:

层级 | 角色 ---|--- Open WebUI | 对话、用户、权限、模型选择、工具及可见的工作流 Terminals | 认证、路由、策略解析、开通、生命周期、刷新及清理 Open Terminal 工作区 | 文件、Shell、进程、包、代码执行、预览及工件 策略 | 镜像、工具、限制、存储、环境变量、安全上下文及闲置超时

用运行框架工程术语来说:Open WebUI 加上 Open Terminal 构成了完整框架,Open Terminal 是其中的计算机底层,而 Terminals 则是管理这些底层环境的集群管理器。

安全运维

根据智能体所需的访问权限,Open Terminal 可以通过 Docker 隔离运行,也可以直接在主机上运行。Terminals 为共享部署增加策略、生命周期及每用户隔离功能。在授予智能体广泛的文件系统、进程或网络访问权限之前,请先查阅安全与配置页面。

需求 | 前往 ---|--- 安全模型和部署边界 | 安全 配置选项 | 配置 多用户设置选项 | 多用户 Terminals 故障排查 | 故障排查

相关生态项目

* Open WebUI Computer:将你的真实计算机服务到任意浏览器,支持文件、终端、编辑器、Git,AI 助手为可选功能。

Terminals 生产环境使用需要 Open WebUI 企业版许可证。项目位于 github.com/open-webui/terminals。

*注:此内容仅供参考,不构成保证、担保或合同承诺。Open WebUI 按“原样”提供。请参阅许可证了解适用条款。*

评论 (0)