调用智能体应用示例

操作场景

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

适用场景：

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

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

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

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

前提条件

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

调用应用

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

POST https://*.studio.agentarts.cn-north-4.huaweiapaas.com/v1/074cabeea7800f622f0ec010bffa6c59/agents/7c5be653-71b8-48e7-9058-7191ec0f44e8/conversations/eeb9884b-ef09-4dd5-a13a-803a09339960?workspace_id=default 
 
Request Header:    
Content-Type: application/json    
"X-Auth-Token" : "MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...",
stream: true     
 
Request Body: 
{  
    "inputs": { 
    "query": "查询A12会议室在9:00到10:00的状态" 
  }
}

• endpoint：终端节点，获取方法请参考终端节点。
• project_id：当前项目ID，获取方法请参考获取项目ID。
• agent_id：智能体应用ID，获取方法如下：

  1. 进入AgentArts智能体开发平台。

  2. 在左侧导航选择“开发中心 > 智能体管理 > 单智能体”或选择“开发中心 > 智能体管理 > 多智能体”。

  3. 鼠标移动至待复制ID的智能体应用卡片上，单击“复制ID”。

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