VoltOps

VoltOps

VoltAgent Inc. · 程式設計

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

VoltOps 的介面預覽

關於 VoltOps

About

VoltOps 是什麼

VoltOps 是 VoltAgent 平台的觀測那一半。VoltAgent 本身是一套用 TypeScript 寫的 AI 代理框架。它解決一個很具體的除錯難題:一個會呼叫工具、保留記憶、又串起多個推理步驟的代理,本來就很難跟;純文字日誌更看不出哪裡壞了、為什麼壞。

主控台把這個黑盒子變成看得懂的畫面。每次執行都是一條可互動的追蹤,附時間軸,你可以打開任何一步,看到送給模型的完整提示詞、回傳的內容,還有工具的輸入與輸出。子代理會直接顯示在同一條線上,多代理之間的交接因此能塞進同一個畫面。

它分成兩種模式。開發階段直接連到你本機的代理(通常是 3141 埠),所有資料留在你電腦裡。到了正式環境,只要加上一組公開金鑰與私密金鑰,就會透過 OpenTelemetry(OTLP)開啟遠端匯出,不必改程式碼,追蹤就送到雲端。也因為這樣,你可以先在本地除錯、不讓任何資料離開筆電,之後改一個環境變數,就能盯著正式流量。

開始使用

  1. 用 npm install @voltagent/core 安裝 VoltAgent 框架,定義一個代理、它的模型、工具與記憶。
  2. 啟動應用程式。本機伺服器會起來,通常是 http://localhost:3141,並印出就緒訊息。
  3. 打開託管主控台 console.voltagent.dev。它會自動連上 localhost,也可以在設定裡填自己的網址。
  4. 要進正式環境,在主控台建立一組公開金鑰與私密金鑰,放進 .env,遠端匯出就會自己開啟。
  5. 執行你的代理,然後在主控台挑一條追蹤,檢查步驟、記憶與日誌。

產品資訊

快速了解 VoltOps 的定價、支援平台與效能。

免費方案是
付費方案$0 - custom/mo
平台Web (cloud console), self-hosted
開發者VoltAgent Inc.
類別程式設計
發布日期Jan 2025
最近更新Oct 2025
網站訪問量649.3M
網站全球排名50
API 提供狀態是

適合對象

這項工具最適合的使用者、任務與情境。

使用者

  • 用 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 把這些資料匯出到正式環境。