
VoltOps
VoltAgent Inc. · 程式設計
VoltOps 是 VoltAgent 團隊推出的 LLM 可觀測性平台。它把每一次 AI 代理執行畫成即時追蹤,讓你看到每個工具呼叫與每個步驟,再把 OpenTelemetry 資料匯出到正式環境。

關於 VoltOps
About
VoltOps 是什麼
VoltOps 是 VoltAgent 平台的觀測那一半。VoltAgent 本身是一套用 TypeScript 寫的 AI 代理框架。它解決一個很具體的除錯難題:一個會呼叫工具、保留記憶、又串起多個推理步驟的代理,本來就很難跟;純文字日誌更看不出哪裡壞了、為什麼壞。
主控台把這個黑盒子變成看得懂的畫面。每次執行都是一條可互動的追蹤,附時間軸,你可以打開任何一步,看到送給模型的完整提示詞、回傳的內容,還有工具的輸入與輸出。子代理會直接顯示在同一條線上,多代理之間的交接因此能塞進同一個畫面。
它分成兩種模式。開發階段直接連到你本機的代理(通常是 3141 埠),所有資料留在你電腦裡。到了正式環境,只要加上一組公開金鑰與私密金鑰,就會透過 OpenTelemetry(OTLP)開啟遠端匯出,不必改程式碼,追蹤就送到雲端。也因為這樣,你可以先在本地除錯、不讓任何資料離開筆電,之後改一個環境變數,就能盯著正式流量。
開始使用
- 用
npm install @voltagent/core安裝 VoltAgent 框架,定義一個代理、它的模型、工具與記憶。 - 啟動應用程式。本機伺服器會起來,通常是
http://localhost:3141,並印出就緒訊息。 - 打開託管主控台
console.voltagent.dev。它會自動連上 localhost,也可以在設定裡填自己的網址。 - 要進正式環境,在主控台建立一組公開金鑰與私密金鑰,放進
.env,遠端匯出就會自己開啟。 - 執行你的代理,然後在主控台挑一條追蹤,檢查步驟、記憶與日誌。
產品資訊
快速了解 VoltOps 的定價、支援平台與效能。
適合對象
這項工具最適合的使用者、任務與情境。
使用者
- 用 TypeScript 寫代理、想知道某次執行為什麼失敗的後端與全端開發者:追蹤畫面省去瞎猜,設定只要一個環境變數。
- 團隊本來就在用 OpenTelemetry 的 AI 工程師:VoltOps 說的是 OTLP,追蹤能接進現有架構,而不是再多一個孤島。
- 自己做代理 MVP 的獨立開發者:免費的 Developer 方案每月給 250 條追蹤與 7 天保存,付費前拿來除錯已經夠用。
任務
- 除錯一個步驟很多、工具卻叫錯順序的代理執行:打開追蹤、順著時間軸走,找出計畫斷掉的那一步。
- 答案不對時回頭檢查提示詞與模型回應:訊息畫面顯示實際送出與收到的文字,你改的是指令,不是碰運氣。
- 盯整個流程的 token 成本與延遲:每步的耗時與輸入,會讓那個慢的、貴的呼叫現形。
- 不改程式就架好正式環境監控:補上金鑰,OpenTelemetry 匯出接手其餘的事。
情境
- 本地除錯時不想讓任何資料離開自己的電腦:主控台只跟 localhost 講話,遠端不會存任何東西。
- 團隊要把代理交給同事接手:一條安全通道網址就能分享正在跑的實例,直接看現場。
- 正式環境出事、需要某個請求的追蹤:遠端匯出會留住你事後需要的那段紀錄。
主要功能
互動式工作流程視覺化
VoltOps 把每次執行畫成帶時間軸的追蹤,不是一大面文字。你看得到步驟順序、每步觸發了哪個工具,還有它的輸入與輸出。一團多代理交接因此變成一眼能讀懂的東西。子代理的步驟就在同一條線上,各自標上代理 id。
即時執行與本地除錯
主控台直接連上你正在跑的代理,通常在 3141 埠,邊跑邊傳輸執行流程。因為連線只在你瀏覽器和 localhost 之間,這個模式不會把資料送到外部伺服器,也不會存過去。代理工作時,你可以即時檢查步驟、日誌與狀態。
以 OpenTelemetry 為底的正式環境匯出
正式環境的觀測跑在 OpenTelemetry 上,走標準的 OTLP HTTP。把公開金鑰與私密金鑰加進環境,遠端匯出會延遲初始化,並用智慧批次與背壓把負擔壓低。這個設計是刻意的:本地除錯保持即時,遠端這條路只在金鑰有效時才開啟。
記憶瀏覽器與步驟關聯
記憶瀏覽器有兩個分頁。Messages 顯示所選使用者的對話紀錄,Steps 顯示綁在當前追蹤上的結構化執行步驟。挑一條追蹤,Steps 分頁就跟著它,日誌、追蹤與記憶不必重新篩選就能對齊。這正是讓你接起「使用者說了什麼」與「代理做了什麼」的關鍵。
取樣與批次控管
預設值能應付多數情況,但你改得動。設定取樣策略(always、never、ratio,或沿用上層追蹤),並調整佇列大小、批次大小與匯出逾時。舉例來說,ratio 策略在量大的時候只送 25% 的追蹤。這些控制沿用 OpenTelemetry 慣例,追蹤與日誌都適用。
提示詞、評估與部署工具
VoltOps 不只是檢視器。同一個主控台能管理版本化的提示詞、對你的代理跑評估,還透過一鍵 GitHub 整合把專案部署到託管基礎設施上。RAG 用的知識庫,加上自動化動作與觸發器,把平台補齊,觀測因此就待在它所量測的工作流程旁邊。
優缺點
優點
- 資料不離開電腦的本地模式,讓敏感的代理執行不必先過隱私審查就能除錯。
- 任何框架都能用,不只 VoltAgent,只要你發出 OpenTelemetry 追蹤。
- 正式環境匯出不用改程式碼,兩個環境變數就好。
- 追蹤與時間軸畫面,讓多代理與工具流程比翻日誌快得多就能讀懂。
- 免費 Developer 方案每月 250 條追蹤,付費 Core 方案給到 50,000 條,小專案夠用。
缺點
- 最大的價值落在 TypeScript 開發者;用 Python 框架的團隊拿不到同樣現成的代理串接。
- 遠端匯出、評估與更大的追蹤量都放在付費方案後面,真的要盯正式環境得花錢。
- 主控台建立在你的應用願意開一個本機伺服器上,開不了 localhost 的環境就得改用通道或雲端那條路。
- 託管記憶只限美國與歐盟區域,資料若得留在別處就會在意這點。
常見問題
VoltOps 用來觀測與除錯 AI 代理和 LLM 應用。它把每次執行顯示成帶時間軸的追蹤,能檢查提示詞、模型回應、工具呼叫與記憶,並透過 OpenTelemetry 把這些資料匯出到正式環境。
相關內容
探索與 VoltOps 相關的工具、技能與文章。
VoltOps 替代方案
Base Code
Base44 (Wix) · 程式設計 · 生產力Base Code 是 Base44 推出的共享雲端開發環境。團隊在對話中描述對既有 GitHub 儲存庫的修改,看著預覽確認結果,再以 Pull Request 交回工程團隊。
Google EmbeddingGemma 2
Google DeepMind · 寫作 · 圖片 · 程式設計Google EmbeddingGemma 2 是 7.4 億參數的開源模型,能把文字、程式碼、圖片、音訊與影片畫面轉成同一個 768 維空間裡的向量,在手機與筆電上就能執行。
GitGlow
GitGlow · 程式設計 · 生產力GitGlow 是桌面版 Git 用戶端,把你自己的程式碼與 AI 代理程式的變更集中在同一份審查裡,讓你在交付前看清楚機器上究竟要送出什麼。
