跳到主要内容

RunResult

runIdstringrequired
createdAtstring<date-time>required
conversationIdstring
targetstringrequired
resolvedTargetstringrequired
entrypointIdstring

Workflow 实际运行的入口 ID；Conversation 与旧记录可省略。

entrypointTitlestring

运行创建时快照的入口标题；历史展示不随后续源码标题变化。

sourcestring

仅定时运行存在，表示该 run 由调度器创建。

Possible values: [schedule]

scheduleIdstring<uuid>
scheduleNamestring

run 创建时快照的计划名称。

fireIdstring<uuid>
scheduledForstring<date-time>
triggerKindstring

Possible values: [window-interval, cron]

argsstring[]required
external object

记录 run 的客户端或外部入口来源。Desktop、External Run API、Embed 和 Webhook 都会写入 source，方便执行日志、KV 关联和回放区分来源。 OpenAI Responses 调用还会完整保存标准化请求与终态 Response；完整认证 Key 不进入记录，apiKeyId 与 apiKeyName 仅标识 Key ID 和前缀。

sourcestring

Possible values: [external, embed, webhook, desktop, schedule, mcp]

principalKindstring
actorTypestring
actorUserIdstring
actorProfileIdstring
actorDisplayNamestring
actorProfile object
userIdstringrequired
displayNamestringrequired
emailstring

Optional email address for the profile summary.

avatarUrlstring

Optional avatar image URL or data URL for the uploader profile.

apiKeyIdstring
apiKeyNamestring
protocolstring
Constant value: openai.responses
userstring
conversationIdstring
inputs object
property name*any
files[]
responseModestring

Possible values: [blocking, streaming]

openai object
request objectrequired
modelstringrequired

Possible values: non-empty

input objectrequired
oneOf
string

Possible values: non-empty

instructionsstring

Possible values: non-empty

temperaturenumber

Possible values: >= 0 and <= 2

top_pnumber

Possible values: >= 0 and <= 1

max_output_tokensinteger

Possible values: >= 1

text object
format object
typestringrequired
Constant value: text
verbositystring

Possible values: [low, medium, high]

includestring[]

Possible values: [reasoning.encrypted_content]

storeboolean
Default value: true
streamboolean
Default value: false
backgroundboolean
Default value: false
previous_response_idstring

继续一个状态为 completed 或 incomplete 且仍保留的 Response。

Possible values: Value must match regular expression ^resp_

conversation object
oneOf
string

Possible values: Value must match regular expression ^conv_

metadata object
property name*string

Possible values: <= 512 characters

response objectrequired
idstringrequired

Possible values: Value must match regular expression ^resp_

objectstringrequired
Constant value: response
created_atintegerrequired
completed_atinteger | nullnullablerequired

仅当状态为 completed 时填写 Unix 秒时间戳；其它状态为 null。

statusstringrequired

Possible values: [queued, in_progress, completed, failed, cancelled, incomplete]

backgroundbooleanrequired
error objectrequired
oneOf
null
incomplete_details objectrequired
oneOf
null
instructionsstring | nullnullablerequired
max_output_tokensinteger | nullnullablerequired
max_tool_callsnullrequired
modelstringrequired
output object[]required
  • Array [
    • idstring

    Possible values: Value must match regular expression ^msg_

    typestringrequired
    Constant value: message
    rolestringrequired

    Possible values: [user, assistant, system, developer]

    content objectrequired
    oneOf
    string

    Possible values: non-empty

    statusstring

    Possible values: [in_progress, completed, incomplete]

  • ]
    • parallel_tool_callsbooleanrequired
    Constant value: false
    previous_response_idstring | nullnullablerequired
    conversation objectrequired
    oneOf
    null
    metadata objectrequired
    property name*string

    Possible values: <= 512 characters

    storebooleanrequired
    temperaturenumber | nullnullablerequired
    top_pnumber | nullnullablerequired
    toolsarrayrequired
    tool_choicestringrequired
    Constant value: auto
    reasoning objectrequired
    property name*any
    text objectrequired
    format objectrequired
    typestringrequired
    Constant value: text
    verbositystring

    Possible values: [low, medium, high]

    truncationstringrequired
    Constant value: disabled
    usernullrequired
    usage objectrequired
    oneOf
    null
    webhook object
    workflowNamestringrequired
    requestIdstringrequired
    targetstringrequired
    resolvedTargetstring
    headers object
    property name*string
    debugNodestring
    statusWorkflowRunStatusrequired

    Possible values: [waiting, running, waiting_for_input, success, failed, aborted, timed_out]

    durationMsnumberrequired
    stdoutstringrequired
    stderrstringrequired
    exitCodeintegerrequired
    pendingUserInput object
    requestIdstringrequired
    nodeNamestringrequired
    titlestringrequired
    descriptionstring
    paramsobject[]required

    与所选 Workflow entrypoint（Conversation 则为 executor）的 params 相同的 WorkflowParamDefinition 数组。

    defaultValues object
    property name*any
    metadata object
    property name*any
    createdAtstring<date-time>required
    resolvedUserInputs object[]
  • Array [
    • requestIdstringrequired
    nodeNamestringrequired
    values objectrequired
    property name*any
    submittedAtstring<date-time>required
  • ]
    • report objectrequired

    执行报告；定时运行包含计划和 fire 快照，output 节点使用 outputs[].output.items 和 result.data.output.items，等待用户输入时包含 pendingUserInput，业务计时卡片使用 timers。

    sourcestring

    Possible values: [schedule]

    scheduleIdstring
    scheduleNamestring
    fireIdstring
    scheduledForstring<date-time>
    triggerKindstring

    Possible values: [window-interval, cron]

    property name*any

    执行报告；定时运行包含计划和 fire 快照，output 节点使用 outputs[].output.items 和 result.data.output.items，等待用户输入时包含 pendingUserInput，业务计时卡片使用 timers。

    RunResult
    {
      "runId": "string",
      "createdAt": "2024-07-29T15:51:28.071Z",
      "conversationId": "string",
      "target": "string",
      "resolvedTarget": "string",
      "entrypointId": "string",
      "entrypointTitle": "string",
      "source": "schedule",
      "scheduleId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scheduleName": "string",
      "fireId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "scheduledFor": "2024-07-29T15:51:28.071Z",
      "triggerKind": "window-interval",
      "args": [
        "string"
      ],
      "external": {
        "source": "external",
        "principalKind": "string",
        "actorType": "string",
        "actorUserId": "string",
        "actorProfileId": "string",
        "actorDisplayName": "string",
        "actorProfile": {
          "userId": "string",
          "displayName": "string",
          "email": "string",
          "avatarUrl": "string"
        },
        "apiKeyId": "string",
        "apiKeyName": "string",
        "protocol": "openai.responses",
        "user": "string",
        "conversationId": "string",
        "inputs": {},
        "files": [
          null
        ],
        "responseMode": "blocking",
        "openai": {
          "request": {
            "model": "string",
            "input": "string",
            "instructions": "string",
            "temperature": 0,
            "top_p": 0,
            "max_output_tokens": 0,
            "text": {
              "format": {
                "type": "text"
              },
              "verbosity": "low"
            },
            "include": [
              "reasoning.encrypted_content"
            ],
            "store": true,
            "stream": false,
            "background": false,
            "previous_response_id": "string",
            "conversation": "string",
            "metadata": {}
          },
          "response": {
            "id": "string",
            "object": "response",
            "created_at": 0,
            "completed_at": 0,
            "status": "queued",
            "background": true,
            "error": "null",
            "incomplete_details": "null",
            "instructions": "string",
            "max_output_tokens": 0,
            "max_tool_calls": "null",
            "model": "string",
            "output": [
              {
                "id": "string",
                "type": "message",
                "role": "user",
                "content": "string",
                "status": "in_progress"
              }
            ],
            "parallel_tool_calls": true,
            "previous_response_id": "string",
            "conversation": "null",
            "metadata": {},
            "store": true,
            "temperature": 0,
            "top_p": 0,
            "tools": [
              null
            ],
            "tool_choice": "auto",
            "reasoning": {},
            "text": {
              "format": {
                "type": "text"
              },
              "verbosity": "low"
            },
            "truncation": "disabled",
            "user": "null",
            "usage": "null"
          }
        },
        "webhook": {
          "workflowName": "string",
          "requestId": "string",
          "target": "string",
          "resolvedTarget": "string",
          "headers": {}
        }
      },
      "debugNode": "string",
      "status": "waiting",
      "durationMs": 0,
      "stdout": "string",
      "stderr": "string",
      "exitCode": 0,
      "pendingUserInput": {
        "requestId": "string",
        "nodeName": "string",
        "title": "string",
        "description": "string",
        "params": [
          {}
        ],
        "defaultValues": {},
        "metadata": {},
        "createdAt": "2024-07-29T15:51:28.071Z"
      },
      "resolvedUserInputs": [
        {
          "requestId": "string",
          "nodeName": "string",
          "values": {},
          "submittedAt": "2024-07-29T15:51:28.071Z"
        }
      ],
      "report": {
        "source": "schedule",
        "scheduleId": "string",
        "scheduleName": "string",
        "fireId": "string",
        "scheduledFor": "2024-07-29T15:51:28.071Z",
        "triggerKind": "window-interval"
      }
    }