运行含问答交互的工作流

操作场景

本章节指导用户通过调用API运行需要问答交互的工作流。

前提条件

• 已开通数据智能平台（DataArts Platform）并加入工作空间并具有相应的权限，并根据开通区域确定调用API的Endpoint，详细信息请参见地区与终端节点。
• 当您使用IAM认证方式完成认证鉴权时，需要获取用户AK/SK，然后使用AK/SK进行签名认证，具体操作请参考认证鉴权。

涉及接口

运行应用涉及以下接口：运行应用。

操作步骤

1. 开发一个含问答节点的工作流。
   1. 如图1所示，在应用开发中开发一个含问答节点的工作流，并完成生产部署。
      图1 工作流
      
   2. 问答节点配置如图2所示。
      • 文本输入框表单项：用于反馈姓名。
      • 单选按钮组：用于反馈性别。
      图2 问答节点配置
      
   3. 结束节点配置如图3所示。
      图3 结束节点的配置
      

2. 运行工作流。
   1. 接口相关信息。

      URI格式：POST /v1/{project_id}/applications/{application_id}/run

   2. 请求示例。

      POST https://{Endpoint}/v1/ddaac8e6a4334e6998b7e1e424c0ff82/applications/f9eed8ea-acb6-401a-b33a-19e6bee21659/run
      {
          "query": "你好"
      }

   3. 响应示例。

      {
          "debug": false,
          "run_id": "1e6ce02c-9644-46fe-b753-dd3b5aec3e48",
          "message_id": "1e6ce02c-9644-46fe-b753-dd3b5aec3e48",
          "session_id": "9f548569-a522-48ed-901c-878534605b77",
          "is_finished": false,
          "data": {
              "status": "interacting",
              "outputs": {
                  "content": [
                      {
                          "type": "inputForm",
                          "value": {
                              "title": "请反馈你的姓名和性别",
                              "form": [
                                  {
                                      "key": "name",
                                      "label": "姓名",
                                      "description": "用户姓名",
                                      "type": "input",
                                      "required": true,
                                      "value_type": "String",
                                      "max_length": 32,
                                      "default_value": "",
                                      "max": 0,
                                      "min": 0,
                                      "display_style": null,
                                      "option_type": null,
                                      "option_reference": null,
                                      "options": null
                                  },
                                  {
                                      "key": "gender",
                                      "label": "性别",
                                      "description": "用户性别",
                                      "type": "select",
                                      "required": true,
                                      "value_type": "String",
                                      "max_length": 0,
                                      "default_value": null,
                                      "max": 0,
                                      "min": 0,
                                      "display_style": "list",
                                      "option_type": "VALUE",
                                      "option_reference": null,
                                      "options": [
                                          {
                                              "label": "男",
                                              "value": "男"
                                          },
                                          {
                                              "label": "女",
                                              "value": "女"
                                          }
                                      ]
                                  }
                              ]
                          }
                      }
                  ]
              },
              "elapsed_time": 1.325,
              "total_steps": 2,
              "create_date": "2026-10-08T10:46:25Z",
              "finish_date": "2026-10-08T10:46:26Z"
          },
          "version": "2.0"
      }

      请求异常时，请参见错误码。

3. 问答交互。
   1. 接口相关信息。

      URI格式：POST /v1/{project_id}/applications/{application_id}/run

   2. 请求示例。

      POST https://{Endpoint}/v1/ddaac8e6a4334e6998b7e1e424c0ff82/applications/f9eed8ea-acb6-401a-b33a-19e6bee21659/run
      {
          "session_id": "9f548569-a522-48ed-901c-878534605b77",
          "run_id": "1e6ce02c-9644-46fe-b753-dd3b5aec3e48",
          "inputs": {
              "name": "张三",
              "gender": "男"
          }
      }

   3. 响应示例。

      {
          "debug": false,
          "run_id": "1e6ce02c-9644-46fe-b753-dd3b5aec3e48",
          "message_id": "996e3b9a-6279-4461-93bd-be9b11d4d45c",
          "session_id": "9f548569-a522-48ed-901c-878534605b77",
          "is_finished": true,
          "data": {
              "status": "succeeded",
              "outputs": {
                  "response": "你叫张三，你的性别是男"
              },
              "elapsed_time": 1.178,
              "total_steps": 4,
              "create_date": "2026-10-08T10:46:27Z",
              "finish_date": "2026-10-08T10:46:28Z"
          },
          "version": "2.0"
      }

      请求异常时，请参见错误码。