SOP Doc
API Doc 展示每個端點。SOP Doc 展示整個序列 — 哪些步驟、什麼順序、誰參與其中。點選 Visual 查看流程圖。
SOP Doc 如何運作
以 YAML 定義流程。每個步驟是一個節點(api、agent、human、cli)。連接是邊。
依據 JSON Schema 檢查 .osop 檔案。在任何人看到之前先攔截錯誤。
開啟 osop.ai/sop-doc。Visual 分頁顯示流程圖。YAML 分頁顯示規格。
PM 看 Visual 分頁。工程師看 YAML。所有人看到同一個流程。
優化迴路
執行工作流程。Agent 節點呼叫 LLM。API 節點發送 HTTP 請求。
每個節點:時間戳記、持續時間、成本、使用的工具、AI 推理、人類決策。
將多個 .osoplog 餵給 AI。AI 寫出優化的 .osop。
比較新舊版本。查看變化:持續時間、成本、每步驟狀態。
接受、修改或拒絕 AI 建議。由人類決定。
Stripe 支付流程(API SOP)
建立 Stripe 客戶,包含電子郵件與中繼資料。
建立支付意圖。金額、幣別、客戶 ID。
以支付方式確認付款。
驗證付款是否成功。檢查狀態欄位。
AI 根據付款明細產生個人化收據電子郵件。
匯入現有工作流程
GitHub Actions、Airflow、n8n、CrewAI、Argo 或 LangGraph。
轉換為 OSOP 格式。將 jobs/operators/tasks 對應到 OSOP 節點與邊。
驗證轉換後的檔案是否為有效的 OSOP。
在視覺化編輯器中開啟。確認流程與原始版本一致。如需調整。
會話記錄:完整繁中國際化
使用者發現切換中文後仍有許多區域顯示英文。
探索 next-intl 設定、訊息檔案、路由設定及所有頁面元件。
在首頁、optimize、sop-doc、hub、OsopCodeBlock、DocsNav、部落格中發現硬編碼英文。
建立 6 步驟計畫:共用 UI 鍵值、元件、頁面、YAML 內容。
為 en 和 zh-TW 建立 optimize、sop-doc、hub 訊息檔案。
為首頁、optimize、sop-doc、hub、版面頁尾新增翻譯鍵值。
以 useTranslations 更新 OsopCodeBlock、DocsNav、部落格。
3 個頁面共 8 個 YAML 區塊現在顯示中文節點名稱。
建立 translate.ts、get-translated.ts 用於執行時 YAML 翻譯。
從 245 個工作流程提取所有可翻譯字串。
分成 4 個批次並派遣平行翻譯代理。
合併 245 個工作流程,修復亂碼,驗證所有頁面。
新增你自己的 SOP
為你的 API、團隊、公司撰寫 .osop 檔案。讓每個流程都能被看見、被分享。