Optio 是什么？一文看懂自托管 AI Agent 编排平台的核心能力与适用场景
Optio 是什么？一文看懂自托管 AI Agent 编排平台的核心能力与适用场景
Optio 是一个自托管的 AI Agent 编排平台（Workflow orchestration for AI agent swarms），让你在一个地方运行、调度和跟踪所有 AI 编码代理的工作：给 Claude Code、OpenAI Codex、Gemini、Cursor 等 Agent 派发代码任务、定时作业、事件响应，或维护一支常驻的 Agent 团队。它部署在你自己的 Kubernetes 集群或自己的机器上，提供 Web 控制台和 iOS / Android 原生应用，适合想要“把 CI/CD 的构建步骤换成 AI Agent”的团队。
🧭 Optio 的定位：AI Agent 的“运行指挥中心”
可以把 Optio 理解为 “AI Agent 版的 CI/CD”：Agent 不再是只在你终端里跑的命令行工具，而是成为可以被触发、排队、观察、协作的生产级工作负载。
总览页会回答三个问题：什么正在运行、什么已经就绪、什么需要你处理（Needs You 队列）。所有工作——仓库任务、定时作业、本地会话、持久化 Agent——都汇入同一个 Work 信息流。
🧩 核心能力一览
1. 统一的 Work 工作台：用 5 个问题创建任何工作
Optio 把所有类型的 Agent 工作抽象为 Work，创建时只需回答 5 个问题：
| 属性 | 回答的问题 |
|---|---|
| When（何时） | 现在手动启动、定时（cron）、工单、GitHub / Slack / Linear / PagerDuty 等事件触发？ |
| Where（何地） | Kubernetes 集群里的 Pod，还是你自己电脑上配对的目录？ |
| Who（谁做） | 哪个 Agent 运行时（Claude Code / Codex / Copilot / Gemini / Cursor / OpenCode / OpenClaw），或一个纯终端命令？ |
| What（做什么） | 一段 prompt、可复用的模板（支持 {{params}} 变量），或一条 shell 命令 |
| Then（然后） | 做完就退出、停下等我回复、还是成为消息驱动的持久化 Agent？ |
表单会自动根据这组选择推导出工作类型，并用一句话复述给你确认。完整模型说明见 docs/tasks.md。
2. 14 种触发方式：从 cron 到告警事件
除了手动和定时触发，Optio 内置 manual、schedule、webhook、ticket、GitHub、GitLab、Slack、Linear、Jira、Pylon、PagerDuty、Sentry、Alertmanager、Datadog 共 14 种触发器。事件负载中的字段可以作为 {{param}} 注入 prompt——例如“把每个新开的 PR 总结成简报”“PagerDuty 告警到达时启动排查 Agent”。
3. 多 Agent 运行时 + 可扩展工具生态
- 一次选择即可切换 Claude Code、OpenAI Codex、GitHub Copilot、Google Gemini、Cursor、OpenCode、OpenClaw 或纯 shell 命令；
- Connections 机制把“加密凭证 + MCP 工具 + shell 环境变量 + 使用说明书”打包成具名连接（如 “Jon's AWS”“Acme Linear”），按仓库和运行时精细授权，详见 docs/connections.md；
- 支持 Notion、GitHub、Slack、Linear、PostgreSQL、Sentry、AWS、任意 HTTP API 与自定义 MCP Server。
4. 会话与终端：实时跟随 Agent 的每一步
会话页支持 Chat 与 Terminal 并排显示：左侧看 Agent 对话（可回复、可审批），右侧就是同一个目录里的真实终端。你可以把会话分屏、调整侧栏宽度，还能通过带有效期的共享链接把“查看 + 控制”权限交给团队成员。
5. 从 Issue 到 PR 的完整代码流水线
给 Agent 派一个仓库任务后，Optio 会自动完成整条链路：
- 为仓库启动隔离的 Kubernetes Pod（Pod-per-repo + git worktree，同仓多任务并行）；
- 运行所选 Agent，实时把结构化日志流回 Web UI；
- Agent 开 PR 后，PR Watcher 持续跟踪 CI、评审与合并状态；
- 可配置 CI 通过后自动触发评审 Agent、评审要求修改时自动恢复 Agent、合并后自动完结。
6. 持久化 Agent：一支可以互相协作的“Agent 团队”
Persistent Agent 是长期存活、具名、消息驱动的 Agent：每处理完一个 turn 就停下，等待用户消息、其他 Agent 的消息、webhook 或 cron 唤醒。同一个 workspace 里的 Agent 可以通过内部 HTTP API 互相发消息，从而组成“swarm”。Pod 生命周期可选 always-on / sticky / on-demand 三档，按需控制成本。仓库附带了 Forge 与 Mars Mission Control 两个示例团队，机制细节见 docs/persistent-agents.md。
7. Optio Local：在你自己的电脑上跑 Agent
不想上云？在笔记本上运行 optio local up 这个 CLI daemon，通过一条出站 WebSocket 把机器配对到 Optio。之后在 Web 上就能在你的目录里开终端、跑 Agent（使用你本机 CLI 的登录态，服务器不下发任何密钥），并且工单、webhook、定时任务都能自动唤醒你机器上的会话。详见 docs/optio-local.md。
🎯 适用场景速查
| 场景 | 怎么用 |
|---|---|
| Issue 自动转 PR | 工单 / GitHub 事件触发仓库任务，Agent 在 worktree 里开发并开 PR |
| 依赖升级、每日简报 | cron 定时跑保存好的指令，每次运行独立留档 |
| 故障与部署失败响应 | PagerDuty / Datadog / Sentry / 失败的 CI 事件直接转成排查 prompt |
| 值班工程师的副驾驶 | Slack / Pylon 消息唤醒持久化 Agent 调研并起草回复 |
| 团队专属 Agent 团队 | 给每个 Agent 独立指令与收件箱，通过内部消息 API 协作 |
| 例行 shell 检查 | 不接 LLM，直接跑命令并跟踪输出与退出码 |
🚀 快速上手：三步部署自托管
前提：安装 Docker Desktop 并启用 Kubernetes（生产环境则使用 Helm chart 与 EKS 生产部署指南）。
git clone https://gitcode.com/gh_mirrors/opt/optio
cd optio
./scripts/setup-local.sh
脚本会构建全部组件并通过 Helm 部署到本地 Kubernetes（见 scripts/setup-local.sh）。完成后打开 http://localhost:30310 完成初始化，API 监听在 http://localhost:30400。
提示：运行 示例数据种子脚本 可以一键填充一批带标注的演示工作，方便先“逛”一遍再动手。
📱 移动端：口袋里的 Agent 监控台
Optio 提供 SwiftUI 的 iOS 应用 与 Jetpack Compose 的 Android 应用：查看队列、创建 Work、阅读对话、操控终端、管理工作区。iOS 端还支持主屏 / 锁屏小组件、Live Activities、灵动岛，以及镜像到 Apple Watch 智能表盘的 Live Activity；Android 端提供主屏小组件与常驻通知——Agent 需要你做决定时，手机上直接“Allow / Reply”。
✅ Optio 适合谁？
- 有 K8s 基础设施工程团队：想要把 Agent 纳入生产环境、统一观测与权限管理；
- 重度使用 AI 编码工具的开发者：需要定时、事件驱动的自动化，而不是一键手动跑脚本；
- 注重数据与成本自控的团队：自托管意味着工作流、密钥（AES-256-GCM 静态加密）和用量数据都掌握在自己手里，多 workspace + admin/member/viewer 角色保证团队权限清晰。
需要进一步了解，推荐阅读：README.md（功能总览）、docs/tasks.md（Work 模型）、docs/config-as-code.md（把整个工作区配置用 YAML 放进代码仓库）、CLAUDE.md（架构与仓库约定）。
Optio 采用 MIT 许可，核心栈为 TypeScript + Next.js + Fastify + PostgreSQL + Redis/BullMQ + Kubernetes，配原生 Swift / Kotlin 客户端。你的 Agent 仍在与你配置的模型服务商通信，Optio 只负责编排、触发、执行与恢复这一层控制面。