---
title: 输入表单触发器
description: 具有结构化输入模式的手动触发器
---

import { Callout } from 'fumadocs-ui/components/callout'
import { Image } from '@/components/ui/image'

## 概述

当工作流需要从编辑器中以类型化字段开始时，请使用输入表单触发器。运行面板会准确显示您定义的字段，因此工作流始终接收干净的数据。

## 您需要定义的内容

在输入格式构建器中添加字段（文本、数字、布尔值、JSON 等）。对于每个字段：

- 该值会作为 `<blockName.field>` 出现在工作流中。
- 为方便起见，完整的有效负载会镜像在 `<blockName.input>`。

如果您将表单留空，触发器将没有输出。

## 手动运行

<div className='flex justify-center my-6'>
  <Image
    src='/static/triggers/input-form-panel-light.png'
    alt='输入表单运行面板'
    width={400}
    height={250}
    className='rounded-xl border border-border shadow-sm'
  />
</div>

当您在编辑器中按下运行按钮时，面板会渲染表单。提交的值会直接输入到触发器输出中，因此下游模块可以直接引用它们而无需额外解析。数字会被转换为数字，布尔值会变为 true/false，JSON 字段在工作流看到它们之前会被解析。

## 子工作流

<div className='flex justify-center my-6'>
  <Image
    src='/static/triggers/workflow-input-mapping-light.png'
    alt='工作流输入映射'
    width={400}
    height={250}
    className='rounded-xl border border-border shadow-sm'
  />
</div>

输入表单触发器还支持工作流模块。当您嵌入子工作流时，映射步骤会显示子表单字段，以便您可以将变量从父级连接到子级。您映射的内容将成为子工作流的输入表单提交。

<Callout>
需要一个没有字段的快速运行按钮？使用手动触发器。当您需要验证和可预测的结构时，请选择输入表单。
</Callout>
