open-agents
用於建構雲端代理的開放原始碼範本。
open-agents 是什麼?
用於建構雲端代理的開放原始碼範本。中文(台灣)翻譯。品牌名稱、URL、技術術語和事實含義保持不變。
open-agents 概覽
這是什麼
Open Agents 是一個開源參考應用程式,用於在 Vercel 上建置與執行背景編碼代理。它包含網頁 UI、代理執行環境、沙箱編排以及 GitHub 整合。此儲存庫設計為可被複製(fork)並改寫。系統分為三層:網頁應用程式(處理驗證、工作階段、聊天與串流 UI)、在 Vercel 上以持久化工作流程執行的代理,以及沙箱執行環境(檔案系統、Shell、Git、開發伺服器與預覽連接埠)。一個關鍵的架構決策是代理不在沙箱 VM 內執行;它在沙箱外部執行,並透過檔案讀取、編輯、搜尋與 Shell 指令等工具與沙箱互動。
主要功能
- 聊天驅動的編碼代理,具備檔案、搜尋、Shell、任務、技能與網頁工具 - 使用 Workflow SDK 支援的持久化多步驟執行,包含串流與取消功能 - 基於快照可恢復的隔離 Vercel 沙箱 - 在沙箱內進行儲存庫複製與分支操作 - 可選的成功執行後自動提交、推送與建立 Pull Request - 透過唯讀連結分享工作階段 - 可選的 ElevenLabs 語音輸入轉錄功能
使用情境
- 執行背景編碼代理,無需本機電腦即可進行程式碼變更 - 建置與測試與沙箱化檔案系統及 Shell 互動的代理工作流程 - 實驗代理與沙箱分離的架構 - 自動化 GitHub 工作流程,例如複製儲存庫、進行變更與建立 Pull Request
快速開始
在 Vercel 上部署: 1. 複製(fork)此儲存庫。 2. 將儲存庫匯入 Vercel(若使用部署按鈕,Neon Postgres 會自動佈建)。 3. 產生密鑰:openssl rand -base64 32 作為 BETTER_AUTH_SECRET。 4. 在 Vercel 專案設定中新增 POSTGRES_URL 與 BETTER_AUTH_SECRET 環境變數。 5. 部署一次以取得穩定的正式環境網址。 6. 建立 Vercel OAuth 應用程式,並新增其用戶端 ID 與密鑰。 7. 可選:建立 GitHub App 以啟用完整的 GitHub 流程。 本機設定: bash corepack enable pnpm install cp apps/web/.env.example apps/web/.env # 填入必要值 pnpm web
授權與價格
授權為 MIT。此專案為開源。
內容整理自該專案公開的 README 與儲存庫資訊。