CompozyOS Web UI完全使用指南：如何可视化监控和操控AI Agent工作-育师

CompozyOS Web UI完全使用指南：如何可视化监控和操控AI Agent工作

【免费下载链接】compozyAn operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each other, run automated on jobs and loops, and share one project memory. You steer everything from the browser.项目地址: https://gitcode.com/gh_mirrors/co/compozy

CompozyOS（GitHub 加速计划 co/compozy）是一个 AI Agent 操作系统，把你已有的 Agent CLI（Claude Code、Codex、Gemini CLI、Cursor 等）接入同一个守护进程后组成团队：分工协作、自动运行任务与循环，并共享一份项目记忆。而CompozyOS Web UI就是你在浏览器中可视化监控和操控这些 AI Agent 工作的控制台，无需盯终端。本指南带你从零打开界面，掌握会话、Agent、Loops、任务看板与审批流的完整用法。

什么是 CompozyOS Web UI：浏览器里的 Agent 控制台

CompozyOS 的核心是一个本地守护进程（daemon），它统一持有会话、任务、Loops 与记忆的运行时状态。Web UI、CLI、HTTP/SSE 接口读取的是同一份守护进程状态——浏览器里看到的就是真实运行时事实，而不是另一份副本。关闭浏览器只会断开观察者，不会取消已接受的任务。

三步打开 CompozyOS Web UI

启动守护进程：安装后执行compozy install，再执行compozy daemon start；
打开浏览器地址：CompozyOS 默认从守护进程的 HTTP 地址直接提供 UI，默认地址为http://localhost:2123；
确认状态一致：浏览器展示的会话目录与持久化记录，应与 CLI 中compozy session list的结果完全一致。

📌 如果你在~/.compozy/config.toml中修改了[http].host或[http].port，请改用对应地址。修改监听地址需要重启守护进程，建议在创建会话之前进行。官方 Web UI 基于 Chromium 引擎开发与验证（桌面应用内嵌同一引擎），其他浏览器尽力支持。详见 web-ui.mdx。

主界面速览：一屏掌握所有 AI Agent 工作

打开界面后，顶部是工作区与会话导航，底部是全局操作栏。典型的运行场景如下：左侧面板展示工作区内的 Loops（可重复执行的协调流程）及其运行次数，右侧面板是任务看板，按 BLOCKED、QUEUED、DONE 分列展示任务状态与优先级，Agent 的每一步进展都清晰可见。

会话（Sessions）：Agent 工作的持久化单元

会话是 CompozyOS 管理的基本对象，绑定一个 Agent 运行时、一个工作区边界、一个独立事件存储和一套权限策略。在 Web UI 中：

会话是持久化对象，不是聊天气泡——状态（active/stopping/stopped）随时可查；
已停止的会话仍可读取历史记录，符合条件的会话可被新提示词恢复，进入starting后自动重建运行时；
遇到进程退出的会话，可通过 fork 派生新子会话，保留原始转录与诊断信息。

会话生命周期细节可参考 lifecycle.mdx。

Agent 管理：一次定义，反复复用

在 Agents 页面，每个 Agent 都是可复用的定义（如 Deal Analyst、Research Monitor），标注其职责描述与实时状态（Running / Idle / Failed）。你可以：

点击右上角New agent创建新 Agent，它对应~/.compozy/agents/<name>/AGENT.md定义文件；
从状态一眼看出哪些 Agent 正在跑、哪些失败了、上次运行是什么时候；
工作区级定义会整体覆盖全局定义，方便按项目定制。

Loops 与自动化：让 AI Agent 团队自动运转

Loops 是"编写一次、重复运行"的协调流程。Web UI 提供 Runs 视图、行/卡片切换、搜索过滤与一键 Run 按钮。配合内置的定时任务（cron）、Webhook 与触发器，工作无需打开终端即可持续运行——多个 Agent 之间互相交接任务，就像这张协作网络示意图所表达的形态：

Loops 的编写与运行文档见 loops 指南，界面路由实现位于 web/src/routes/。

可视化监控：事件流、审批与可审计决策

CompozyOS 的每个动作都是一个事件：持久化、可回放、可验证。在 Web UI 中你可以：

回放事件流：按时间轴查看会话中发生的每一步，定位 Agent 的任意行为；
审批与权限：权限模式带有完整审计轨迹，边界感知的执行与每次决定的审批痕迹都留痕可查，敏感操作（如图中"Approval pending"任务）会等待人工放行；
三端一致：CLI、HTTP+SSE API 与 Web UI 共享同一守护进程状态，浏览器所见与终端命令compozy session events --follow所见是同一真相源。