惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

WordPress大学
WordPress大学
酷 壳 – CoolShell
酷 壳 – CoolShell
小众软件
小众软件
Vercel News
Vercel News
Last Week in AI
Last Week in AI
H
Help Net Security
The Cloudflare Blog
L
LangChain Blog
Microsoft Security Blog
Microsoft Security Blog
B
Blog RSS Feed
云风的 BLOG
云风的 BLOG
I
InfoQ
U
Unit 42
美团技术团队
人人都是产品经理
人人都是产品经理
雷峰网
雷峰网
OSCHINA 社区最新新闻
OSCHINA 社区最新新闻
博客园 - 叶小钗
Y
Y Combinator Blog
Hugging Face - Blog
Hugging Face - Blog
A
About on SuperTechFans
宝玉的分享
宝玉的分享
量子位
博客园_首页

Workflow SDK Documentation

Patterns for Defining Tools Human-in-the-Loop Building Durable AI Agents Queueing User Messages Resumable Streams Sleep, Suspense, and Scheduling Streaming Updates from Tools API Reference Workflow Globals Changelog Resilient run start Cookbook Building a World Deploying Astro Express Fastify Hono Getting Started NestJS Next.js Nitro Nuxt Python SvelteKit Vite corrupted-event-log fetch-in-workflow hook-conflict Errors
WorkflowController
2026-06-12 · via Workflow SDK Documentation

NestJS controller that serves the workflow runtime routes.

NestJS controller that handles the well-known workflow endpoints under .well-known/workflow/v1. It dynamically imports the generated workflow bundles and converts between Express/Fastify requests and the Web API Request/Response objects the workflow runtime expects. Both the Express and Fastify HTTP adapters are supported.

WorkflowModule.forRoot() registers this controller automatically — you only register it yourself if you are not using WorkflowModule.

When registering the controller manually, call configureWorkflowController first so it can locate the generated bundles; its route handlers throw otherwise.

import { join } from "node:path";
import { Module } from "@nestjs/common";
import {
  configureWorkflowController, 
  WorkflowController, 
} from "workflow/nest";

configureWorkflowController(join(process.cwd(), ".nestjs/workflow")); 

@Module({
  controllers: [WorkflowController], 
})
export class AppModule {}
RouteMethodDescription
/.well-known/workflow/v1/flowPOSTExecutes workflow and step work items via the combined handler in workflows.mjs (step registrations are imported from steps.mjs first).
/.well-known/workflow/v1/webhook/:tokenAnyForwards webhook requests to the handler in webhook.mjs.
/.well-known/workflow/v1/manifest.jsonGETServes the workflow manifest. Responds with 404 unless the WORKFLOW_PUBLIC_MANIFEST=1 environment variable is set.