cli

Prefect CLI 技能是唯讀 MCP 伺服器的核心輔助工具，為您的 Prefect Cloud 或 OSS 工作空間提供執行變更與生命週期管理任務的介面。此技能專為 AI 代理工作流程設計，能對部署、流程執行與自動化策略進行程式化控制。適用於 DevOps 工程師、資料平台團隊以及需要執行寫入操作或修復任務的自動化代理程式，特別是在觀察與分析不足以解決問題時使用。

• 透過 flow-name/deployment-name 模式或特定 UUID 觸發部署。

• 使用非互動式旗標（non-interactive flags）管理流程執行的生命週期，包含取消與刪除。

• 使用結構化 JSON 配置來建立與更新自動化策略。

• 與 Prefect API 介接以進行進階過濾、資源檢查與狀態管理。

• 透過標準 Shell 命令執行支援批次作業與自動化錯誤處理。

• 執行所有 CLI 指令時務必使用 --no-prompt 旗標，以確保與非互動式代理的相容性，防止操作被阻斷。

• 應先使用唯讀 MCP 伺服器中的 get_flow_runs 或 get_deployments 工具取得完整 UUID，因為這些識別碼對於變更操作是必須的。

• 優先使用 prefect api 指令配合 --data 輸入，以獲得精確控制與原始 JSON 輸出，確保結果可供後續機器讀取與處理。

• 避免依賴 Rich table 輸出，因終端格式化可能截斷關鍵 ID；建議儘可能透過 jq 進行管線處理。

• 執行指令前，請確保您的環境已透過 ~/.prefect/profiles.toml 或相關環境變數（如 PREFECT_API_URL 與 PREFECT_API_KEY）完成驗證。

• 此技能作為唯讀診斷工具的寫入側夥伴，能實現從觀察失敗執行到自動取消或重新觸發的完整反饋迴圈。