From d3299db91520e9ea411e853a7af474b14f08b3e2 Mon Sep 17 00:00:00 2001
From: twwu <twwu@dify.ai>
Date: Wed, 7 Jan 2026 18:07:30 +0800
Subject: [PATCH] feat: add human input output structure and enhance filtering
 in human input form components

---
 .../base/chat/chat/answer/human-input-form-list.tsx   |  6 +++++-
 web/app/components/workflow/constants.ts              | 11 +++++++++++
 .../workflow/nodes/_base/components/variable/utils.ts |  3 ++-
 .../components/workflow/nodes/human-input/node.tsx    |  2 +-
 .../components/workflow/nodes/human-input/panel.tsx   | 10 ++++++++++
 .../workflow/panel/human-input-form-list.tsx          |  6 +++++-
 web/service/share.ts                                  |  4 ++--
 web/types/workflow.ts                                 |  3 ++-
 8 files changed, 38 insertions(+), 7 deletions(-)

diff --git a/web/app/components/base/chat/chat/answer/human-input-form-list.tsx b/web/app/components/base/chat/chat/answer/human-input-form-list.tsx
index 93e6975853..65b5f24c33 100644
--- a/web/app/components/base/chat/chat/answer/human-input-form-list.tsx
+++ b/web/app/components/base/chat/chat/answer/human-input-form-list.tsx
@@ -41,10 +41,14 @@ const HumanInputFormList = ({
     }, {} as Record<string, { showEmailTip: boolean, isEmailDebugMode: boolean, showDebugModeTip: boolean }>)
   }, [getHumanInputNodeData, humanInputFormDataList])
 
+  const filteredHumanInputFormDataList = useMemo(() => {
+    return humanInputFormDataList.filter(formData => formData.display_in_ui)
+  }, [humanInputFormDataList])
+
   return (
     <div className="mt-2 flex flex-col gap-y-2">
       {
-        humanInputFormDataList.map(formData => (
+        filteredHumanInputFormDataList.map(formData => (
           <ContentWrapper
             key={formData.node_id}
             nodeTitle={formData.node_title}
diff --git a/web/app/components/workflow/constants.ts b/web/app/components/workflow/constants.ts
index 76ad86b6b7..ed9a072824 100644
--- a/web/app/components/workflow/constants.ts
+++ b/web/app/components/workflow/constants.ts
@@ -212,6 +212,17 @@ export const TOOL_OUTPUT_STRUCT: Var[] = [
   },
 ]
 
+export const HUMAN_INPUT_OUTPUT_STRUCT: Var[] = [
+  {
+    variable: '__action_id',
+    type: VarType.string,
+  },
+  {
+    variable: '__rendered_content',
+    type: VarType.string,
+  },
+]
+
 export const PARAMETER_EXTRACTOR_COMMON_STRUCT: Var[] = [
   {
     variable: '__is_success',
diff --git a/web/app/components/workflow/nodes/_base/components/variable/utils.ts b/web/app/components/workflow/nodes/_base/components/variable/utils.ts
index 91c3f115d7..c5407abb0c 100644
--- a/web/app/components/workflow/nodes/_base/components/variable/utils.ts
+++ b/web/app/components/workflow/nodes/_base/components/variable/utils.ts
@@ -42,6 +42,7 @@ import {
   FILE_STRUCT,
   getGlobalVars,
   HTTP_REQUEST_OUTPUT_STRUCT,
+  HUMAN_INPUT_OUTPUT_STRUCT,
   KNOWLEDGE_RETRIEVAL_OUTPUT_STRUCT,
   LLM_OUTPUT_STRUCT,
   PARAMETER_EXTRACTOR_COMMON_STRUCT,
@@ -640,7 +641,7 @@ const formatItem = (
         [],
         { schemaTypeDefinitions },
       ) || []
-      res.vars = outputSchema
+      res.vars = [...outputSchema, ...HUMAN_INPUT_OUTPUT_STRUCT]
       break
     }
 
diff --git a/web/app/components/workflow/nodes/human-input/node.tsx b/web/app/components/workflow/nodes/human-input/node.tsx
index d081d6bd26..289c2efdc7 100644
--- a/web/app/components/workflow/nodes/human-input/node.tsx
+++ b/web/app/components/workflow/nodes/human-input/node.tsx
@@ -62,7 +62,7 @@ const Node: FC<NodeProps<HumanInputNodeType>> = (props) => {
           <div className="system-xs-semibold-uppercase truncate text-text-secondary">Timeout</div>
           <NodeSourceHandle
             {...props}
-            handleId="timeout"
+            handleId="__timeout"
             handleClassName="!top-1/2 !-right-[9px] !-translate-y-1/2"
           />
         </div>
diff --git a/web/app/components/workflow/nodes/human-input/panel.tsx b/web/app/components/workflow/nodes/human-input/panel.tsx
index b49845e457..7b02124094 100644
--- a/web/app/components/workflow/nodes/human-input/panel.tsx
+++ b/web/app/components/workflow/nodes/human-input/panel.tsx
@@ -205,6 +205,16 @@ const Panel: FC<NodePanelProps<HumanInputNodeType>> = ({
             />
           ))
         }
+        <VarItem
+          name="__action_id"
+          type="string"
+          description="Action ID user triggered"
+        />
+        <VarItem
+          name="__rendered_content"
+          type="string"
+          description="Rendered content"
+        />
       </OutputVars>
 
       {isPreview && (
diff --git a/web/app/components/workflow/panel/human-input-form-list.tsx b/web/app/components/workflow/panel/human-input-form-list.tsx
index d8557edc56..e032bfbb89 100644
--- a/web/app/components/workflow/panel/human-input-form-list.tsx
+++ b/web/app/components/workflow/panel/human-input-form-list.tsx
@@ -52,10 +52,14 @@ const HumanInputFormList = ({
     }, {} as Record<string, { showEmailTip: boolean, isEmailDebugMode: boolean, showDebugModeTip: boolean }>)
   }, [getHumanInputNodeData, humanInputFormDataList])
 
+  const filteredHumanInputFormDataList = useMemo(() => {
+    return humanInputFormDataList.filter(formData => formData.display_in_ui)
+  }, [humanInputFormDataList])
+
   return (
     <div className="flex flex-col gap-y-3">
       {
-        humanInputFormDataList.map(formData => (
+        filteredHumanInputFormDataList.map(formData => (
           <ContentWrapper
             key={formData.node_id}
             nodeTitle={formData.node_title}
diff --git a/web/service/share.ts b/web/service/share.ts
index fa72d2cf2e..2a27f4c5f4 100644
--- a/web/service/share.ts
+++ b/web/service/share.ts
@@ -334,12 +334,12 @@ export const getHumanInputForm = (token: string) => {
     inputs: FormInputItem[]
     user_actions: UserAction[]
     expiration_time: number
-  }>(`/api/form/human_input/${token}`)
+  }>(`/form/human_input/${token}`)
 }
 
 export const submitHumanInputForm = (token: string, data: {
   inputs: Record<string, any>
   action: string
 }) => {
-  return post(`/api/form/human_input/${token}`, { body: data })
+  return post(`/form/human_input/${token}`, { body: data })
 }
diff --git a/web/types/workflow.ts b/web/types/workflow.ts
index 0f68f84e24..bc34abafdc 100644
--- a/web/types/workflow.ts
+++ b/web/types/workflow.ts
@@ -321,7 +321,8 @@ export type HumanInputFormData = {
   inputs: FormInputItem[]
   actions: UserAction[]
   form_token: string
-  resolved_placeholder_values: Record<string, string> // For human input placeholder when its type is variable
+  resolved_placeholder_values: Record<string, string>
+  display_in_ui: boolean
 }
 
 export type HumanInputRequiredResponse = {