AI 工作流程建構器 是做什麼的？
將 muapi.ai 的任何生成步驟組合到自動化管道中。AI 架構師會將您的純語言描述轉換為可執行的節點圖。
先決條件
在執行任何命令之前，務必確保 muapi CLI 是最新版本。請在每次工作階段開始時從原始碼重新安裝：
pip install --upgrade /path/to/muapi-cli
將 /path/to/muapi-cli 替換為工作區中 muapi-cli 目錄的實際路徑（包含 pyproject.toml 的目錄）。
核心操作
- 生成 (
generate-workflow.sh) — AI 架構師根據描述建立工作流程 - 發現 (
discover-workflow.sh) — 透過自然語言尋找相關的現有工作流程 - 編輯 (
generate-workflow.sh --workflow-id) — 使用提示修改現有工作流程 - 互動式執行 (
interactive-run.sh) — 提示輸入並執行工作流程 - 執行 (
run-workflow.sh) — 執行工作流程，逐節點輪詢，收集輸出 - CLI (
muapi workflow) — 直接在終端機中進行完整的 CRUD 操作 + 視覺化
代理引導的發現與選擇
作為 AI 代理，您可以讀取並理解可用工作流程的目的，以選擇最適合用戶任務（例如「創建一個 UGC 影片」）的工作流程。
- 發現：以 JSON 格式擷取可用工作流程及其描述的目錄。
muapi workflow discover --output-json - 匹配（內部推理）：使用您的 LLM 能力分析傳回工作流程的
name、category和description欄位。為用戶的意圖找到最佳匹配。 - 分析：如果找到有希望的候選對象，請檢查其結構以確保它具有必要的節點和參數。
關鍵規則：muapi workflow get <workflow_id>muapi workflow get的輸出將包含一個「API 輸入」表格。您必須閱讀此表格以了解需要哪些輸入。 - 選擇、確認並提示使用者：
- 如果一個工作流程是完美匹配，您必須要求使用者提供所需 API 輸入的確切值，然後再執行。切勿自行憑空發明或猜測輸入值（例如提示、URL 等）。
- 如果多個工作流程高度相關，請將選項及其描述呈現給使用者，並要求他們確認要使用哪一個，同時也要求提供所需的輸入。
- 如果沒有工作流程符合使用者的複雜請求，請提供使用
muapi workflow create架構一個新工作流程的選項。
代理推理範例
「使用者想要一個產品宣傳影片。我使用
discover擷取了目錄。我看到兩個潛在的工作流程：
wf_123：'帶背景音樂的產品宣傳'wf_456：'簡單影片生成' 我將使用get分析wf_123。它具有所需的節點。我將建議wf_123，如果匹配精確則直接執行。」
協議：建立工作流程
步驟 1 — 描述您的管道
muapi workflow create "取得文字提示，使用 flux-dev 生成圖像，然後將其放大至 4K"
架構師會傳回一個具有唯一 ID 和節點圖的工作流程。儲存此 ID。
步驟 2 — 檢查與視覺化
# 在終端機中顯示豐富的 ASCII 節點圖
muapi workflow get <workflow_id>
# 或原始 JSON
muapi workflow get <workflow_id> --output-json
步驟 3 — 執行
# 使用特定輸入執行
muapi workflow execute <workflow_id> \
--input "node1.prompt=午夜中閃爍的水晶洞穴"
# 使用 --download 將結果拉到本地
muapi workflow execute <workflow_id> \
--input "node1.prompt=夕陽" \
--download ./outputs
步驟 4 — 發現（可選）
如果您想重複使用現有工作流程而不是建立新的：
# 使用關鍵字搜尋
muapi workflow discover "ugc 影片"
步驟 5 — 互動式執行
執行工作流程並讓 CLI 提示您輸入每個必需的輸入：
muapi workflow run-interactive <workflow_id>
工作流程範例
圖像管道
# 文字 → 圖像 → 放大
muapi workflow create "取得文字提示，使用 flux-dev 生成，放大結果"
# 文字 → 圖像 → 去背 → 產品照片
muapi workflow create "使用 hidream 生成產品圖像，移除背景，創建專業產品照片"
影片管道
# 文字 → 影片
muapi workflow create "使用 kling-master 從文字提示生成 10 秒電影級影片"
# 圖像 → 影片 → 唇形同步
muapi workflow create "使用 seedance 對輸入圖像進行動畫處理，然後從音訊檔案套用唇形同步"
編輯現有工作流程
# 新增步驟
muapi workflow edit <id> --prompt "在圖像生成步驟之後新增一個換臉步驟"
# 切換模型
muapi workflow edit <id> --prompt "將影片模型從 kling 更改為 veo3"
CLI 參考
# 列出所有工作流程
muapi workflow list
# 瀏覽範本
muapi workflow templates
# 生成新的工作流程
muapi workflow create "文字 → flux 圖像 → 放大 → 換臉"
# 視覺化工作流程
muapi workflow get <id>
# 使用輸入執行
muapi workflow execute <id> --input "node1.prompt=夕陽"
# 監控執行
muapi workflow status <run_id>
# 取得輸出
muapi workflow outputs <run_id> --download ./results
# 使用 AI 編輯
muapi workflow edit <id> --prompt "在結尾新增唇形同步"
# 重新命名 / 刪除
muapi workflow rename <id> --name "產品管線 v2"
muapi workflow delete <id>
MCP 工具（適用於 AI 代理）
| 工具 | 描述 |
|---|---|
muapi_workflow_list | 列出使用者的工作流程 |
muapi_workflow_create | AI 架構師：提示 → 工作流程 |
muapi_workflow_get | 取得工作流程定義 + 節點圖 |
muapi_workflow_execute | 使用特定輸入執行 |
muapi_workflow_status | 逐節點執行狀態 |
muapi_workflow_outputs | 最終輸出 URL |
限制
- 工作流程可以包含 muapi.ai 節點的任何組合（圖像、影片、音訊、增強、編輯）
- 節點輸出會自動作為輸入連接到下游節點
--sync模式最多等待 120 秒進行生成；對於複雜工作流程，請使用--async並單獨輪詢- 執行逾時：每個工作流程執行最長 10 分鐘