aigne observe 指令會啟動一個本地 Web 伺服器，用於監控和分析 Agent 執行資料。它提供了一個使用者友善的介面，讓您能檢視追蹤記錄、查看詳細的呼叫資訊，並理解您的 Agent 在執行期間的行為。這個工具對於除錯、效能調校以及深入了解您的 Agent 如何處理資訊並與各種工具和模型互動至關重要。
用法
若要啟動可觀測性伺服器，請在您的終端機中執行以下指令：
用法
aigne observe [options]啟動後，CLI 將會印出伺服器 URL 和本地可觀測性資料庫的路徑。
運作方式
observe 指令會啟動一個 Web 應用程式，它會從 AIGNE 儲存所有執行追蹤記錄的本地 SQLite 資料庫讀取資料。每當您執行一個 Agent（使用 aigne run 或 aigne serve-mcp）時，框架會自動記錄執行流程的詳細日誌。這些日誌隨後便可在可觀測性 UI 中進行檢視。
UI 讓您能瀏覽所有已記錄的追蹤列表，並深入探究特定的追蹤記錄，以查看 Agent 操作的逐步分解，包含輸入、輸出、工具呼叫和模型回應。
選項
- --host
string(default:localhost) — 指定伺服器的主機位址。使用0.0.0.0可將伺服器公開給您本地網路上的其他裝置。 - --port
number(default:7890) — 設定伺服器監聽的埠號。如果指定的埠無法使用，它將嘗試尋找下一個可用的埠。也可以透過PORT環境變數來設定。
範例
在預設埠上啟動伺服器
執行不帶任何選項的指令會使用預設設定啟動伺服器。
使用預設設定啟動
aigne observe預期輸出：
主控台輸出
Observability database path: /path/to/your/project/.aigne/observability.db
Observability server is running at http://localhost:7890然後您可以在網頁瀏覽器中開啟 http://localhost:7890 來存取 UI。
在特定埠上啟動伺服器
使用 --port 選項來指定不同的埠。
在自訂埠上啟動
aigne observe --port 8080這將在 http://localhost:8080 上啟動伺服器（如果 8080 埠已被使用，則會使用下一個可用的埠）。
將伺服器公開至您的本地網路
若要允許您網路上的其他裝置存取可觀測性 UI，請將主機設定為 0.0.0.0。
公開伺服器
aigne observe --host 0.0.0.0伺服器屆時將可透過 http://<your-local-ip>:7890 存取。