调用智能体应用示例

操作场景

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

适用场景：

• 在项目中运行预定义的知识型智能体应用。

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

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

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

前提条件

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

调用应用

如下示例是调用智能体应用的配置。

POST https://{endpoint}/v1/{project_id}/agents/{agent_id}/conversations/{conversation_id} 
 
Request Header:    
Content-Type: application/json    
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
stream: true     
 
Request Body: 
{  
  "query": "查询A12会议室在9:00到10:00的状态" 
}

• endpoint：终端节点，Versatile目前仅部署在“华北-北京四”区域，Endpoint为“aiae.appstage.myhuaweicloud.com”。
• project_id：当前项目ID，获取方法请参考获取项目ID。
• agent_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 获取应用调用路径