產品資訊
更新時間:2026年05月19日
什麼是 Agentspan
Agentspan 是一個用於 AI 代理的持久執行運行時,以開源伺服器加上 SDK(Python 和 TypeScript)的形式提供,可幫助您以生產就緒的方式建置、運行和觀察代理。Agentspan 不會將執行狀態保留在您的應用程式進程中(在其中,崩潰、重啟和超時會導致進度丟失),而是將代理作為持久工作流程運行,其狀態存在於 Agentspan 伺服器上。它支援常見的代理模式,例如工具使用、結構化輸出、記憶體、串流事件和多代理協調,並且可以直接使用,或作為現有框架(例如 OpenAI Agents SDK、Google ADK 和 LangGraph)的即插即用執行層。
Agentspan 的主要功能
Agentspan 是一個開源、可自行託管的伺服器和 SDK,它將代理程式碼轉化為持久、可觀察的工作流程,其執行狀態存在於您的程序之外。它專為生產環境設計:代理程式可以崩潰並從確切的步驟恢復,無限期地暫停以待人工批准,自動重試工具呼叫,並運行多代理協調模式——同時透過本地伺服器/UI 提供完整的事件串流和執行歷史。它透過簡單的模型字串支援多個模型提供者,增加了防護措施和結構化輸出,並包含用於 CI 的確定性測試工具。
持久執行(預設崩潰 + 恢復): 工作流程保留在 Agentspan 伺服器上,因此代理程式可以在程序崩潰後倖存下來,並可以從任何機器重新連接,從上次完成的步驟恢復,無需自訂檢查點。
人工審批: 將工具標記為需要批准,以便運行乾淨地暫停(數分鐘或數天),並在透過程式碼或外部管道(例如 Slack/網路入口網站)批准/拒絕後恢復。
多代理管道和協調策略: 使用 `researcher >> writer >> editor` 等表達式組合代理程式,並使用多種協調模式(順序、並行、交接/路由器、群體等),並具有每步驟日誌記錄和持久性。
可觀察性 + 串流事件: 提供完整的執行歷史記錄和實時事件串流,用於工具呼叫/結果、LLM 請求、交接、時間、錯誤和完成——支援實時 UI 和調試。
結構化輸出 + 防護措施: 強制執行類型化輸出(例如 Pydantic 模型)和安全/驗證防護措施(正則表達式、自訂檢查或 LLM 檢查),並具有可配置的自動重試、修復、升級或暫停以待人工處理的行為。
框架整合和模型提供者靈活性: 透過最少的更改與現有代理框架(例如 OpenAI Agents SDK、Google ADK、LangGraph)協同工作,並透過切換單個提供者/模型字串支援許多模型提供者。
Agentspan 的使用案例
帶有批准的客戶支援自動化: 運行代理程式,起草回覆、豐富案例並觸發退款或帳戶變更等操作,同時要求對敏感步驟進行人工批准並維護可審計的執行軌跡。
財務/營運工作流程(可重試的工具自動化): 自動化對帳、發票處理或後台任務,其中工具呼叫可能會暫時失敗——Agentspan 的持久步驟和重試減少了手動重新啟動和工作損失。
研究和內容管道: 創建多代理鏈(研究 → 寫作 → 編輯),可以可靠地運行長時間作業,將進度串流到 UI,並在中斷後恢復而無需重新運行已完成的步驟。
IT/DevOps 運行手冊和事件響應: 協調診斷和修復步驟,為高風險操作設置人工閘門,並提供完整的可觀察性以供事件後審查和重播。
企業數據分析助手: 部署長時間運行的分析代理程式,這些代理程式可在會話之間保留狀態,強制執行結構化報告輸出,並為合規性和利益相關者審查提供可追溯性。
優點
持久性是內建的(崩潰安全、可恢復的工作流程),而不是需要自訂檢查點。
強大的生產工具:可觀察性、串流事件、重試和人工參與的暫停。
開源 (MIT) 且可自行託管;支援多個模型提供者並與流行的代理框架整合。
缺點
需要運行 Agentspan 伺服器/運行時(與簡單的進程內腳本相比,需要額外的基礎設施)。
對於小型或純交互式代理程式,某些高級功能(持久性、協調)可能會增加概念上的開銷。
如何使用 Agentspan
1) 安裝 Agentspan: 在您的 Python 環境中,安裝 SDK:`pip install agentspan`。
2) 啟動(或驗證)Agentspan 伺服器 + UI: 安裝 Agentspan CLI(例如,`npm install -g @agentspan-ai/agentspan`,或從原始碼建置)並運行本地伺服器,以便您可以在視覺化儀表板中檢查運行情況(通常在 `http://localhost:6767`)。使用 `agentspan doctor` 來驗證設定。
3) 定義代理要呼叫的工具(函數): 建立 Python 函數並使用 `@tool` 裝飾它們。使用類型提示和文件字串,以便 Agentspan 可以自動為工具呼叫生成模式。
範例:
Agentspan 常見問題
Agentspan 是一個開源 (MIT)、可自行託管的伺服器,加上 SDK/CLI,可將 AI 代理定義編譯成持久性工作流程。執行狀態存在於您的程序之外,因此代理可以在崩潰後倖存、重試工具呼叫,並支援長時間運行和人工批准的自動化。













