API / SDK / developer guide
Workflow execution
| 目標讀者 TA | 工作流程工程師 |
|---|---|
| 官方文件能力 | 追蹤持久工作流程執行與狀態。 |
| 輸入 → 輸出 | 流程輸入 → 持久執行及最終結果。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 流程程式須維持確定性回放行為。 |
| 本站建議驗證 | 發布變更前回放已記錄歷史。 |
工作流程自動化 · SDK / API
Temporal
Temporal
透過官方 SDK 開發可持續執行的軟體工作流程。
TEMPORAL / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 專案 | Temporal 為跨越失敗與長時間等待的應用提供持久執行。 |
|---|---|
| 元件 | 服務保存執行歷史，應用 worker 執行流程與 activity 程式。 |
| 部署 | 團隊可評估自行代管或 Temporal Cloud；應用 worker 仍為系統一部分。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源。未呼叫供應商 API 或執行推論；結果為內部契約示意。
十項技術入口比較
依實作決策選出的十個技術文件入口，非十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · Workflow executionAPI / SDK / developer guide | 追蹤持久工作流程執行與狀態。工作流程工程師 |
| 02 · ActivitiesAPI / SDK / developer guide | 透過 activity 執行外部工作。整合工程師 |
| 03 · WorkersAPI / SDK / developer guide | 輪詢任務佇列並執行應用程式。執行維運人員 |
| 04 · Retry policiesAPI / SDK / developer guide | 定義重試與退避行為。可靠性工程師 |
| 05 · SchedulesAPI / SDK / developer guide | 啟動週期工作流程執行。維運自動化團隊 |
| 06 · Workflow messagesAPI / SDK / developer guide | 透過 query、signal、update 與執行流程互動。互動流程工程師 |
| 07 · Error handlingAPI / SDK / developer guide | 將應用失敗映射至流程行為。Python 工程師 |
| 08 · Workflow versioningAPI / SDK / developer guide | 保留既有執行並變更流程程式。版本工程師 |
| 09 · Testing suiteAPI / SDK / developer guide | 在測試環境驗證流程與 activities。QA 工程師 |
| 10 · ObservabilityAPI / SDK / developer guide | 以日誌與遙測檢視流程行為。維運團隊 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
Activities
| 目標讀者 TA | 整合工程師 |
|---|---|
| 官方文件能力 | 透過 activity 執行外部工作。 |
| 輸入 → 輸出 | Activity 參數 → 結果或失敗。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 重試可能重複外部副作用。 |
| 本站建議驗證 | 使用冪等鍵並驗證重複嘗試。 |
API / SDK / developer guide
Workers
| 目標讀者 TA | 執行維運人員 |
|---|---|
| 官方文件能力 | 輪詢任務佇列並執行應用程式。 |
| 輸入 → 輸出 | 佇列任務 → worker 執行。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 服務健康但缺少匹配 worker 時無法執行應用任務。 |
| 本站建議驗證 | 檢查佇列名称、註冊型別與 worker 可用性。 |
API / SDK / developer guide
Retry policies
| 目標讀者 TA | 可靠性工程師 |
|---|---|
| 官方文件能力 | 定義重試與退避行為。 |
| 輸入 → 輸出 | 失敗與政策 → 重試或終態失敗。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 無界重試可能使業務工作持續未完成。 |
| 本站建議驗證 | 測試可重試與不可重試失敗及期限。 |
API / SDK / developer guide
Schedules
| 目標讀者 TA | 維運自動化團隊 |
|---|---|
| 官方文件能力 | 啟動週期工作流程執行。 |
| 輸入 → 輸出 | 排程與重疊政策 → 流程啟動。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 時區、重疊與補執行政策影響啟動。 |
| 本站建議驗證 | 測試錯過時段與執行重疊。 |
API / SDK / developer guide
Workflow messages
| 目標讀者 TA | 互動流程工程師 |
|---|---|
| 官方文件能力 | 透過 query、signal、update 與執行流程互動。 |
| 輸入 → 輸出 | 訊息 → 狀態變更或查詢結果。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 唯讀 query 不同於變更狀態訊息。 |
| 本站建議驗證 | 驗證流程並行工作中的訊息處理。 |
API / SDK / developer guide
Error handling
| 目標讀者 TA | Python 工程師 |
|---|---|
| 官方文件能力 | 將應用失敗映射至流程行為。 |
| 輸入 → 輸出 | 例外或逾時 → 已處理失敗狀態。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 捕捉錯誤不可錯標業務成功。 |
| 本站建議驗證 | 檢查傳遞原因與最終業務狀態。 |
API / SDK / developer guide
Workflow versioning
| 目標讀者 TA | 版本工程師 |
|---|---|
| 官方文件能力 | 保留既有執行並變更流程程式。 |
| 輸入 → 輸出 | 版本程式與歷史 → 相容回放。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 舊歷史可能與改變的命令序列衝突。 |
| 本站建議驗證 | 上線前回放代表歷史。 |
API / SDK / developer guide
Testing suite
| 目標讀者 TA | QA 工程師 |
|---|---|
| 官方文件能力 | 在測試環境驗證流程與 activities。 |
| 輸入 → 輸出 | 樣本與受控時間 → 驗證狀態。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 模擬 activity 不證明外部整合成功。 |
| 本站建議驗證 | 區分流程測試與外部契約測試。 |
API / SDK / developer guide
Observability
| 目標讀者 TA | 維運團隊 |
|---|---|
| 官方文件能力 | 以日誌與遙測檢視流程行為。 |
| 輸入 → 輸出 | 執行活動 → 診斷訊號。 |
| 執行環境 | Temporal Service 或 Cloud 加相容應用 worker；使用 Python 範例 |
| 本站選型評估 | 避免日誌暴露敏感業務酬載。 |
| 本站建議驗證 | 以 workflow／run 識別對應診斷。 |
Official documentation
| TA | 工程師與技術產品負責人 |
|---|---|
| 本站驗證建議 | 實作前固定版本並依目標環境核對支援條件。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
建議訂單處理流程契約，非 Temporal SDK 原始回應。未執行流程、activity 或外部操作。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
流程完成
| 輸入 | 唯一訂單識別與有效訂單酬載。 |
|---|---|
| 預期結果 | 必要 activities 完成後才 ok；回傳 workflow／run 識別。 |
| 驗收條件 | 確認業務結果與冪等外部效果。 |
無需執行工作
| 輸入 | 相同業務鍵的有效訂單已處理。 |
|---|---|
| 預期結果 | 明確已處理／無操作結果。 |
| 驗收條件 | 不得重複外部扣款或出貨。 |
Worker 離線
| 輸入 | 流程已受理但匹配 worker 不可用。 |
|---|---|
| 預期結果 | pending／running；沒有完成業務結果。 |
| 驗收條件 | worker 復原後在設定業務期限內恢復。 |
Activity 重試耗盡
| 輸入 | 外部操作依有限重試政策持續失敗。 |
|---|---|
| 預期結果 | failed 與原因；若有設計則附補償狀態。 |
| 驗收條件 | 不可僅依持久執行承諾外部效果恰好一次。 |
將預期結果對應至你的應用
將實際執行環境回應對應至此建議應用契約。所有數值皆為示意，不含憑證或真實執行。
預期輸出 JSON — 示意，非實測 · Temporal-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "Temporal",
"status": "ok",
"input_id": "sample-001",
"data": {
"workflow_id": "example-order-001",
"run_id": "example-run",
"business_state": "completed",
"result": {
"order_id": "example-order-001",
"processed": true
}
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 狀態語意 | 有效空結果與錯誤不同；等待中的工作不可提前顯示成功。 |
|---|---|
| 證據 | 記錄服務與 SDK 版本、請求識別、設定及回應映射。此處未執行或量測效能。 |
| 建議驗收 | 以授權代表樣本測試前，先約定數值誤差與負載目標。 |
開發評估
可恢復的報價工作流程
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 一筆範例事件、經授權系統與一個明確流程轉換。
- 原型交付規劃
- 單一流程的可見工作狀態與操作紀錄。
- 驗收條件
- 重送事件不得重複建立工作；上游不可用時需保留等待或失敗狀態。
- 依賴條件
- 執行環境存取、流程權限與已核對的通知或寫入目的地。
開發順序
- 確認 Temporal 的存取、授權與支援版本。
- 準備上述樣本，針對「可恢復的報價工作流程」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。