调用工作流应用示例

操作场景

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

适用场景：

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

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

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

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

前提条件

您需要规划Versatile所在的区域信息，并根据区域确定调用API的Endpoint，Versatile目前仅部署在“华北-北京四”区域，Endpoint为“aiae.appstage.myhuaweicloud.com”。

调用工作流

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

POST https://api.example.com/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：终端节点，Versatile目前仅部署在“华北-北京四”区域，Endpoint为“aiae.appstage.myhuaweicloud.com”。
• project_id：当前项目ID，获取方法请参考获取项目ID。
• workflow_id：工作流应用ID，获取方法如下：

  1. 进入Versatile智能体平台。

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

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

• conversation_id：会话ID，每个会话的唯一标识符，可将会话ID设置为任意值，使用标准UUID格式。
  1. 进入Versatile智能体平台。
  2. 在左侧导航选择“开发中心 > 应用管理 > 工作流应用”。
  3. 在待复制调用路径的工作流应用卡片上，单击“▪▪▪ > 调用路径”。
  4. 在弹出的“调用路径”页面，单击“复制路径”即可获取调用路径，如图1所示。
     其中，conversation_id参数为会话ID，唯一标识每个会话的标识符，可将会话ID设置为任意值，使用标准UUID格式。

     图1 获取应用调用路径