WorkflowEmbedSiteInfo

workflowIdstringrequired

workflowNamestringrequired

titlestringrequired

descriptionstringrequired

targetstringrequired

resolvedTargetstringrequired

projectTypeWorkflowProjectTyperequired

Workflow/Conversation 由 executor.projectType 声明；Kanban 由 package.json.workflowCode.projectType 声明。宿主据此选择运行或静态预览界面。

Possible values: [workflow, conversation, kanban]

projectCard objectrequired

iconstringrequired

Possible values: [workflow, message-circle, bot, sparkles, code, git-branch, boxes, zap, database, file-text, cpu, brain]

iconUrlstring<uri>

Optional image URL used instead of the icon token. New Desktop uploads use the Server-generated /project-card-images/... WebP URL; existing external http(s) values remain readable for backward compatibility.

iconColorstring

Optional built-in icon foreground color. Defaults to white for older metadata.

Possible values: Value must match regular expression ^#[0-9a-fA-F]{6}$

iconBackgroundColorstringrequired

Possible values: Value must match regular expression ^#[0-9a-fA-F]{6}$

viewer object

userIdstring

displayNamestring

emailstring<email>

avatarUrlstring

tokenUsage object

property name*any

params object[]required

Array [

namestringrequired

flagstring

shortFlagstring

typestringrequired

Possible values: [string, number, boolean, positional, file]

requiredboolean

labelstring

descriptionstring

defaultValuestring

multipleboolean

controlstring

Shared form control hint. Date-related controls keep string values: date uses YYYY-MM-DD, time uses HH:mm:ss, datetime uses local YYYY-MM-DDTHH:mm:ss, and date-range uses inclusive YYYY-MM-DD/YYYY-MM-DD. Date controls do not support panel=quick.

Possible values: [text, textarea, radio, select, checkboxes, date, time, datetime, date-range]

panelstring

Possible values: [main, auxiliary, quick]

resolveOnInputboolean

Whether main composer input changes trigger the selected entrypoint resolver (or the Conversation executor resolver). Defaults to false.

options object[]

Array [

valuestringrequired

labelstring

descriptionstring

]

acceptstring[]

formatstring

Possible values: [json]

]

structure objectrequired

workflowIdstringrequired

workflowNamestringrequired

targetstringrequired

resolvedTargetstringrequired

structure objectrequired

projectTypeWorkflowProjectTyperequired

Workflow/Conversation 由 executor.projectType 声明；Kanban 由 package.json.workflowCode.projectType 声明。宿主据此选择运行或静态预览界面。

Possible values: [workflow, conversation, kanban]

workflow objectrequired

property name*any

definitions objectrequired

项目级节点、API 调用、变量和 registry 静态定义。

property name*any

项目级节点、API 调用、变量和 registry 静态定义。

diagnostics objectrequired

项目级 warnings 与 violations。

property name*any

项目级 warnings 与 violations。

defaultEntrypointstring

仅 Workflow 返回；必须命中 entrypoints 中的一项。

Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

entrypoints object[]

仅 Workflow 返回的扁平独立入口目录，顺序与源码声明一致。

Possible values: >= 1

Array [

idstringrequired

Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

titlestringrequired

Possible values: non-empty

descriptionstring

workflowNamestringrequired

execution objectrequired

kindstringrequired

Constant value: sequence

location object

property name*any

childrenobject[]required

params object[]

Array [

namestringrequired

flagstring

shortFlagstring

typestringrequired

Possible values: [string, number, boolean, positional, file]

requiredboolean

labelstring

descriptionstring

defaultValuestring

multipleboolean

controlstring

Shared form control hint. Date-related controls keep string values: date uses YYYY-MM-DD, time uses HH:mm:ss, datetime uses local YYYY-MM-DDTHH:mm:ss, and date-range uses inclusive YYYY-MM-DD/YYYY-MM-DD. Date controls do not support panel=quick.

Possible values: [text, textarea, radio, select, checkboxes, date, time, datetime, date-range]

panelstring

Possible values: [main, auxiliary, quick]

resolveOnInputboolean

Whether main composer input changes trigger the selected entrypoint resolver (or the Conversation executor resolver). Defaults to false.

options object[]

Array [

valuestringrequired

labelstring

descriptionstring

]

acceptstring[]

formatstring

Possible values: [json]

]

paramResolver object

enabledbooleanrequired

Constant value: true

toolsobject[]

tokenUsage object

property name*any

registryobject[]

]

schedulePresets object[]

仅 Workflow 可声明的建议计划；宿主展示后必须由用户确认创建，不会自动启用。

Possible values: <= 20

Array [

idstringrequired

Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

titlestringrequired

Possible values: non-empty and <= 100 characters

descriptionstring

Possible values: <= 500 characters

entrypointIdstringrequired

Possible values: Value must match regular expression ^[a-z][a-z0-9_-]{0,63}$

timezonestringrequired

trigger objectrequired

kind stringrequired

Possible values: [WorkflowScheduleWindowIntervalTrigger, WorkflowScheduleCronTrigger]

WorkflowScheduleWindowIntervalTrigger

weekdaysinteger[]required

周一至周日对应 1 至 7。

Possible values: >= 1

windows object[]required

不重叠的本地时间窗口，起止时刻都包含在触发范围内。

Possible values: >= 1, <= 12

Array [

startstringrequired

Possible values: Value must match regular expression ^(?:[01]\d|2[0-3]):[0-5]\d$

endstringrequired

Possible values: Value must match regular expression ^(?:[01]\d|2[0-3]):[0-5]\d$

]

intervalMinutesintegerrequired

Possible values: >= 1 and <= 1440

WorkflowScheduleCronTrigger

expressionstringrequired

五字段 Cron，按计划 timezone 解释。

Example: */5 9-15 * * 1-5

paramValues objectrequired

property name*any

]

execution object

Conversation 单入口执行结构；Workflow 不返回该顶层兼容字段。

kindstringrequired

Constant value: sequence

location object

property name*any

childrenobject[]required

params object[]

Conversation executor 参数；Workflow 参数位于各 entrypoint。

Array [

namestringrequired

flagstring

shortFlagstring

typestringrequired

Possible values: [string, number, boolean, positional, file]

requiredboolean

labelstring

descriptionstring

defaultValuestring

multipleboolean

controlstring

Shared form control hint. Date-related controls keep string values: date uses YYYY-MM-DD, time uses HH:mm:ss, datetime uses local YYYY-MM-DDTHH:mm:ss, and date-range uses inclusive YYYY-MM-DD/YYYY-MM-DD. Date controls do not support panel=quick.

Possible values: [text, textarea, radio, select, checkboxes, date, time, datetime, date-range]

panelstring

Possible values: [main, auxiliary, quick]

resolveOnInputboolean

Whether main composer input changes trigger the selected entrypoint resolver (or the Conversation executor resolver). Defaults to false.

options object[]

Array [

valuestringrequired

labelstring

descriptionstring

]

acceptstring[]

formatstring

Possible values: [json]

]

paramResolver object

property name*any

toolsobject[]

Conversation executor 工具；Workflow 工具位于各 entrypoint。

tokenUsage object

property name*any

registryobject[]

kanban object

Kanban 静态产物边界。

artifactDirstringrequired

相对项目根的静态产物目录；旧项目默认 .。

Example: dist

entrystringrequired

相对 artifactDir 的 HTML 入口；默认 index.html。

Example: index.html

manifest object

versionintegerrequired

Constant value: 1

params object[]required

Array [

namestringrequired

flagstring

shortFlagstring

typestringrequired

Possible values: [string, number, boolean, positional, file]

requiredboolean

labelstring

descriptionstring

defaultValuestring

multipleboolean

controlstring

Shared form control hint. Date-related controls keep string values: date uses YYYY-MM-DD, time uses HH:mm:ss, datetime uses local YYYY-MM-DDTHH:mm:ss, and date-range uses inclusive YYYY-MM-DD/YYYY-MM-DD. Date controls do not support panel=quick.

Possible values: [text, textarea, radio, select, checkboxes, date, time, datetime, date-range]

panelstring

Possible values: [main, auxiliary, quick]

resolveOnInputboolean

Whether main composer input changes trigger the selected entrypoint resolver (or the Conversation executor resolver). Defaults to false.

options object[]

Array [

valuestringrequired

labelstring

descriptionstring

]

acceptstring[]

formatstring

Possible values: [json]

]

property name*any

kanban object

仅 projectType: kanban 时返回的清单、用户隔离配置和静态预览信息。

artifactDirstringrequired

entrystringrequired

manifest object

versionintegerrequired

Constant value: 1

params object[]required

Array [

namestringrequired

flagstring

shortFlagstring

typestringrequired

Possible values: [string, number, boolean, positional, file]

requiredboolean

labelstring

descriptionstring

defaultValuestring

multipleboolean

controlstring

Shared form control hint. Date-related controls keep string values: date uses YYYY-MM-DD, time uses HH:mm:ss, datetime uses local YYYY-MM-DDTHH:mm:ss, and date-range uses inclusive YYYY-MM-DD/YYYY-MM-DD. Date controls do not support panel=quick.

Possible values: [text, textarea, radio, select, checkboxes, date, time, datetime, date-range]

panelstring

Possible values: [main, auxiliary, quick]

resolveOnInputboolean

Whether main composer input changes trigger the selected entrypoint resolver (or the Conversation executor resolver). Defaults to false.

options object[]

Array [

valuestringrequired

labelstring

descriptionstring

]

acceptstring[]

formatstring

Possible values: [json]

]

configurations object[]required

Array [

idstring<uuid>required

namestringrequired

values objectrequired

宿主持久化的表单字符串值；注入页面时按参数定义转换为 JSON 原生值。

property name*string

createdAtstring<date-time>required

updatedAtstring<date-time>required

]

activeConfigurationIdstring<uuid>

preview objectrequired

noncestringrequired

urlstringrequired

expiresAtstring<date-time>

Studio 或 Embed 短期静态预览 capability 的到期时间；宿主会在到期前自动换发。

WorkflowEmbedSiteInfo

{
  "workflowId": "string",
  "workflowName": "string",
  "title": "string",
  "description": "string",
  "target": "string",
  "resolvedTarget": "string",
  "projectType": "workflow",
  "projectCard": {
    "icon": "workflow",
    "iconUrl": "string",
    "iconColor": "string",
    "iconBackgroundColor": "string"
  },
  "viewer": {
    "userId": "string",
    "displayName": "string",
    "email": "user@example.com",
    "avatarUrl": "string"
  },
  "tokenUsage": {},
  "params": [
    {
      "name": "string",
      "flag": "string",
      "shortFlag": "string",
      "type": "string",
      "required": true,
      "label": "string",
      "description": "string",
      "defaultValue": "string",
      "multiple": true,
      "control": "text",
      "panel": "main",
      "resolveOnInput": true,
      "options": [
        {
          "value": "string",
          "label": "string",
          "description": "string"
        }
      ],
      "accept": [
        "string"
      ],
      "format": "json"
    }
  ],
  "structure": {
    "workflowId": "string",
    "workflowName": "string",
    "target": "string",
    "resolvedTarget": "string",
    "structure": {
      "projectType": "workflow",
      "workflow": {},
      "definitions": {},
      "diagnostics": {},
      "defaultEntrypoint": "string",
      "entrypoints": [
        {
          "id": "string",
          "title": "string",
          "description": "string",
          "workflowName": "string",
          "execution": {
            "kind": "sequence",
            "location": {},
            "children": [
              {}
            ]
          },
          "params": [
            {
              "name": "string",
              "flag": "string",
              "shortFlag": "string",
              "type": "string",
              "required": true,
              "label": "string",
              "description": "string",
              "defaultValue": "string",
              "multiple": true,
              "control": "text",
              "panel": "main",
              "resolveOnInput": true,
              "options": [
                {
                  "value": "string",
                  "label": "string",
                  "description": "string"
                }
              ],
              "accept": [
                "string"
              ],
              "format": "json"
            }
          ],
          "paramResolver": {
            "enabled": true
          },
          "tools": [
            {}
          ],
          "tokenUsage": {},
          "registry": [
            {}
          ]
        }
      ],
      "schedulePresets": [
        {
          "id": "string",
          "title": "string",
          "description": "string",
          "entrypointId": "string",
          "timezone": "string",
          "trigger": {
            "kind": "window-interval",
            "weekdays": [
              0
            ],
            "windows": [
              {
                "start": "string",
                "end": "string"
              }
            ],
            "intervalMinutes": 0
          },
          "paramValues": {}
        }
      ],
      "execution": {
        "kind": "sequence",
        "location": {},
        "children": [
          {}
        ]
      },
      "params": [
        {
          "name": "string",
          "flag": "string",
          "shortFlag": "string",
          "type": "string",
          "required": true,
          "label": "string",
          "description": "string",
          "defaultValue": "string",
          "multiple": true,
          "control": "text",
          "panel": "main",
          "resolveOnInput": true,
          "options": [
            {
              "value": "string",
              "label": "string",
              "description": "string"
            }
          ],
          "accept": [
            "string"
          ],
          "format": "json"
        }
      ],
      "paramResolver": {},
      "tools": [
        {}
      ],
      "tokenUsage": {},
      "registry": [
        {}
      ],
      "kanban": {
        "artifactDir": "dist",
        "entry": "index.html",
        "manifest": {
          "version": 1,
          "params": [
            {
              "name": "string",
              "flag": "string",
              "shortFlag": "string",
              "type": "string",
              "required": true,
              "label": "string",
              "description": "string",
              "defaultValue": "string",
              "multiple": true,
              "control": "text",
              "panel": "main",
              "resolveOnInput": true,
              "options": [
                {
                  "value": "string",
                  "label": "string",
                  "description": "string"
                }
              ],
              "accept": [
                "string"
              ],
              "format": "json"
            }
          ]
        }
      }
    }
  },
  "kanban": {
    "artifactDir": "string",
    "entry": "string",
    "manifest": {
      "version": 1,
      "params": [
        {
          "name": "string",
          "flag": "string",
          "shortFlag": "string",
          "type": "string",
          "required": true,
          "label": "string",
          "description": "string",
          "defaultValue": "string",
          "multiple": true,
          "control": "text",
          "panel": "main",
          "resolveOnInput": true,
          "options": [
            {
              "value": "string",
              "label": "string",
              "description": "string"
            }
          ],
          "accept": [
            "string"
          ],
          "format": "json"
        }
      ]
    },
    "configurations": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "string",
        "values": {},
        "createdAt": "2024-07-29T15:51:28.071Z",
        "updatedAt": "2024-07-29T15:51:28.071Z"
      }
    ],
    "activeConfigurationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "preview": {
      "nonce": "string",
      "url": "string",
      "expiresAt": "2024-07-29T15:51:28.071Z"
    }
  }
}