命令列與 Agent 工具

為工程師與 AI Agent 提供受管控的觀測雲命令層

OWL CLI 會同步獲授權觀測雲工作空間目前可用的工具目錄、顯示工具 Schema，並從終端、腳本或 AI Agent 工作流程執行支援的查詢或管理工具。

把以下指示貼到 AI 工具。先選擇站點 Endpoint，再替換臨時授權碼：

閱讀 https://static.guance.com/owl/skill.md，並依照文件在目前環境安裝及設定 OWL CLI 與 OWL Skill。

安裝參數如下：
OWL_REGISTRY_ENDPOINT="<OWL_REGISTRY_ENDPOINT>"
OWL_TEMP_CODE="<YOUR_TEMP_CODE>"

請從工作空間所屬站點的 Endpoint 表格選擇 OWL_REGISTRY_ENDPOINT；OWL_TEMP_CODE 則在觀測雲控制台的個人 API 密鑰頁面產生。

Linux / macOS 指令。先選擇站點 Endpoint，再替換臨時授權碼：

export OWL_INSTALL_BASE_URL="https://static.guance.com/owl"
export OWL_REGISTRY_ENDPOINT="<OWL_REGISTRY_ENDPOINT>"
export OWL_TEMP_CODE="<YOUR_TEMP_CODE>"
bash -c "$(curl -fsSL "${OWL_INSTALL_BASE_URL}/install.sh")" -- --yes

查看安裝指南了解 OWL CLI

OWL CLI 的作用

公開憑證獲准使用的工具，並在執行前讓輸入參數可供審查

OWL CLI 不會取代觀測雲控制台或 OpenAPI。它為工具目錄同步、Schema 檢視、查詢與支援操作提供工具導向入口。工具可見性與結果遵從 API Key 權限；寫入工具會更改工作空間資源，應保留明確審查或批准步驟。

在終端、腳本與支援的 AI Agent 工具中使用 OWL

不同 Client 的能力與安裝流程各有差異，請按 OWL 所在環境查閱最新設定指南。

Claude Code

Codex

Cursor

Trae

GitHub Copilot

Windsurf

面向真實可觀測性工作的工具目錄

工具目錄由觀測雲同步，並會隨平台能力更新。請使用 `owl list` 與 `owl show` 確認目前工作空間可用的工具、參數及權限。

查詢可觀測資料

探索並查詢支援的指標、日誌、RUM、APM、網絡、Profiling、計費及相關資料。

驗證 DQL 工作流程

搜尋 DQL 指南、驗證完整查詢，然後再針對指定資料範圍執行。

檢視事件與 Incident

讀取獲授權工具開放的事件、Incident、留言、操作記錄與值班上下文。

檢視資源與拓撲

查詢目錄實體、基礎設施記錄、實體詳情及可用關係。

處理監控器與 SLO

按權限列出或管理支援的監控器資源，並檢視可用 SLO 上下文。

處理儀表板

在憑證具備所需權限時，讀取或執行文件列明的儀表板操作。

可審查工作流程，而非不透明答案

從具體營運問題開始，讓工具呼叫與參數保持可見，並把返回證據與最終工程判斷分開。

正式環境 Endpoint 的 5xx 回應突然上升

值班：檢查 prod /checkout 過去 30 分鐘的錯誤

以獲授權的探索與查詢工具找出相關資料來源、驗證查詢，再按服務、Endpoint、環境與版本比較日誌或 Trace 證據。

範圍服務與時間

→

證據日誌與 Trace

→

審查受影響版本

需要跨工作空間調查一條 Trace

平台團隊：在同一組織的工作空間找出這個 Trace ID

在相關能力可用時，以工作空間探索及專用 Trace 查詢路徑取得資料，再審查返回的工作空間、服務與 Span 上下文。

探索工作空間

→

查詢Trace 證據

→

審查服務路徑

每日營運檢查需要一致輸入

SRE：每天早上檢查核心服務錯誤、慢請求與監控器狀態

腳本或 Agent 可定時呼叫唯讀工具並產生摘要草稿。保留查詢時間窗與工具結果，讓工程師在採取行動前驗證變化。

收集既定訊號

→

比較重要變化

→

審查摘要草稿

相關 AI 與平台能力

觀測雲 MCP Server

向支援 MCP 的 AI Client 開放獲授權觀測雲工具。

AI Agent 可觀測性

追蹤 Agent Session、工作流程、模型呼叫與工具呼叫。

可程式化能力

以 DQL、API 及 DataFlux Func 建立受管控工作流程。

OWL CLI 常見問題

甚麼是 OWL CLI？

OWL CLI 是觀測雲的命令列入口，用於同步工具目錄、檢視工具說明與 Schema，並從終端、腳本或 AI Agent 工作流程執行支援的觀測雲工具。

OWL CLI 可以存取哪些能力？

可用分類與工具由目前觀測雲服務返回，並取決於工作空間與 API Key 權限。請使用 `owl sync`、`owl list` 及 `owl show` 確認目前目錄，而非依賴固定功能清單。

OWL CLI 支援寫入操作嗎？

部分文件列明的工具可建立或更新資源。寫入工具會更改觀測雲工作空間，並需要相應權限。AI Agent 執行寫入操作前應使用人工確認或其他批准控制。

OWL CLI 與 OWL MCP Server 有甚麼關係？

兩者都開放觀測雲的工具導向能力。OWL CLI 面向本機命令列、腳本及 Agent 工作流程；OWL MCP Server 則透過 Model Context Protocol 向 Client 提供工具。

接入指南

觀測 LLM 呼叫、Token 用量與 Trace 上下文

把模型請求、延遲、錯誤、Token 用量及工作流程 Span 放進同一次調查。

為 AI Agent 建立可審查的運行記錄

為 AI Agent 建立可審查的運行記錄

記錄 Agent Session、Trace、工具呼叫與執行上下文，不把模型輸出本身當作證據。

在工程與 AI Agent 工作流程中使用 OWL CLI

在工程與 AI Agent 工作流程中使用 OWL CLI

同步可用工具目錄、檢視 Schema，並從終端執行獲授權的觀測雲工具。

讓 MCP Client 連接獲授權的觀測雲工具

讓 MCP Client 連接獲授權的觀測雲工具

設定 MCP 連線、驗證身分，並審查向 Client 開放的工具。