workflow
Workflow SDK:使用 TypeScript 建立持久、可靠且可觀察的應用程式與 AI 代理
workflow 是什麼?
Workflow SDK:使用 TypeScript 建立持久、可靠且可觀察的應用程式與 AI 代理
workflow 概覽
這是什麼
Workflow SDK 是一個 TypeScript 與 JavaScript 函式庫,讓函式具備持久性。它會保留工作流程的進度、自動重試失敗的步驟,並提供內建的可觀測性。工作流程可以在等待時暫停而不消耗運算資源。此 SDK 專為建立持久、可靠且可觀測的應用程式與 AI 代理而設計。
主要功能
- 自動保留工作流程進度並重試失敗的步驟。
- 內建可觀測性,可透過
npx workflow web存取本機 UI。 - 工作流程可暫停而不消耗運算資源。
- 支援生命週期鉤子,用於應用層級的完成與失敗回報。
- 本機開發使用隨附的後端,無需設定;可部署至 Vercel 以獲得受管儲存、佇列、擴展與可觀測性,或使用 Postgres 或自訂 World 自行託管。
使用情境
- 建立持久的伺服器端工作流程,例如使用者入門流程。
- 建立需要步驟重試與進度保留的可靠 AI 代理。
- 任何需要長時間執行、可觀測且可暫停與恢復的程序。
快速開始
在現有專案中安裝 SDK: bash npm install workflow 為你的框架設定整合。以 Next.js 為例: ts // next.config.ts import { withWorkflow } from 'workflow/next'; export default withWorkflow({}); 從 API 路由、Server Action 或其他伺服器端程式碼啟動工作流程: ts import { start } from 'workflow/api'; import { onboardUser } from './workflows/onboard-user'; await start(onboardUser, ['[email protected]']); 執行應用程式並開啟本機可觀測性 UI: bash npm run dev bash npx workflow web 完整文件位於 node_modules/workflow/docs。
授權與價格
此 SDK 為開放原始碼,採用 Apache-2.0 授權。價格未說明;該套件標示為開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。