调用工作流应用示例

操作场景

该接口用于运行场景化应用，支持在指定的项目、工作流和对话上下文中执行工作流逻辑。接口支持流式响应模式，可以根据需要返回增量执行结果，适用于实时交互场景。

适用场景：

• 在项目中运行预定义的工作流。

• 支持调试模式和发布模式，适用于不同开发和生产环境。

• 支持流式响应，适用于需要实时反馈的场景（如聊天机器人、实时数据分析等）。

下面介绍如何调用工作流应用API使用智能体应用，API的调用方法请参见如何调用API。

前提条件

您需要规划Versatile所在的区域信息，并根据区域确定调用API的Endpoint，获取方法请参考终端节点。

调用工作流

如下示例是调用工作流应用的配置。

POST https://1.2.3.4/v1/12345/workflows/67890/conversations/67890 
 
Request Header:    
Content-Type: application/json    
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
stream: true 
 
Request Body: 
{  
  "inputs": { 
    "query": "你好" 
  }, 
  "plugin_configs": [ 
    { 
      "plugin_id": "xxxxxxxxx", 
      "config": { 
        "key": "value" 
      } 
    } 
  ] 
}

• endpoint：终端节点，获取方法请参考终端节点。
• project_id：当前项目ID，获取方法请参考获取项目ID。
• workflow_id：工作流应用ID，获取方法如下：

  1. 进入Versatile智能体平台。

  2. 在左侧导航选择“开发中心 > 应用管理 > 工作流应用”。

  3. 在待复制ID的工作流应用卡片上，单击“▪▪▪ > 复制ID”。

• conversation_id：会话ID，每个会话的唯一标识符。用户可将会话ID设置为任意字符串，例如“123e4567e89b12d3a456426614174000”，无需在其他地方获取。字符串长度为1~64个字符，支持英文字母、数字、中划线、下划线。