cuga-agent

cuga-agent 概覽

這是什麼

CUGA 是一個開放原始碼的通用型代理工具（agent harness），專為企業設計。它支援在網頁與 API 上執行複雜任務，整合 OpenAPI/MCP，具備可組合架構、推理模式以及政策感知功能。此專案以 IBM SiL 建構，採用 Apache 2.0 授權。

主要功能

• 主權控制：在你的環境中執行工具，連接私有託管的模型與工具，並為斷線部署預先載入支援模型成品。
• 執行政策：封鎖不允許的意圖、要求對特定工具進行核准、以劇本引導工作流程，並設定工具層級的防護。包含五種政策類型：意圖防護、劇本、工具核准、工具指南與輸出格式化器。
• 推理效率：選擇開放模型、調整推理模式、篩選相關工具、設定工具呼叫預算，並透過每次執行的收據檢查 token 用量。
• 更快交付：連接 MCP 伺服器、OpenAPI 服務與 Python 工具。在 UI 中設定並測試代理，然後發布版本。
• 定期自動化：使用獨立的事件服務，依排程、webhook 或應用程式事件執行代理，並在 Events Studio 中檢視執行歷史。
• 可重複使用的經驗：從 SKILL.md 檔案載入特定任務的技能，並使用已設定的 Evolve 整合來取得相關指引與使用者偏好。

使用情境

• 營收營運：比對聯絡人清單與 CRM、合併帳戶資料、計算營收百分位數，並草擬報告。使用工具核准來管控帳戶更新。
• 知識輔助：搜尋公司文件、附上引用回答問題，並將共享參考資料與對話中上傳的文件結合。
• 跨應用程式操作：使用 CugaSupervisor 協調多個專業代理，每個代理擁有自己的工具與指令，並準備結果供審閱。
• 瀏覽器與 API 自動化：結合結構化 API 呼叫與瀏覽器互動，處理跨服務與網頁介面的工作流程。
• 定期操作：透過事件服務排程工作日報表或回應新文件，然後將結果傳送至已設定的頻道。

快速開始

使用 Python 3.12 與 uv。 bash git clone https://github.com/cuga-project/cuga-agent.git cd cuga-agent uv sync --python 3.12 test -f .env || cp .env.example .env 在 .env 中設定你的提供者、模型與憑證。然後啟動附帶 CRM 工具的管理器： bash uv run cuga start manager --crm 開啟 CLI 顯示的本機 URL 中的 /manage 路徑。

授權與價格

採用 Apache 2.0 授權。此專案為開放原始碼且免費使用。

內容整理自該專案公開的 README 與儲存庫資訊。