# 调用智能体应用示例
#### 操作场景
该接口用于运行知识型智能体应用（单智能体应用、多智能体应用），支持在指定的项目、智能体和对话上下文中执行智能体逻辑。接口支持流式响应模式，可以根据需要返回增量执行结果，适用于实时交互场景。
适用场景：
- 在项目中运行预定义的知识型智能体应用。
  
- 支持调试模式和发布模式，适用于不同开发和生产环境。
  
- 支持流式响应，适用于需要实时反馈的场景（如聊天机器人、实时数据分析等）。
  
下面介绍如何调用[调用智能体应用 - runAgent](https://support.huaweicloud.com/api-agentarts0/runAgent.html)API使用智能体应用，API的调用方法请参见[如何调用API](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0003.html)。
#### 前提条件
您需要规划AgentArts所在的区域信息，并根据区域确定调用API的Endpoint，获取方法请参考[终端节点](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0001.html#agentarts_07_0001__title1015mcpsimp)。
#### 调用应用
如下示例是调用智能体应用的配置。
```
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：终端节点，获取方法请参考[终端节点](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0001.html#agentarts_07_0001__title1015mcpsimp)。
- project_id：当前项目ID，获取方法请参考[获取项目ID](https://support.huaweicloud.com/api-agentarts0/agentarts_07_0018.html)。
- agent_id：智能体应用ID，获取方法如下：
  1. 进入AgentArts智能体开发平台。
     
  
  2. 在左侧导航选择"开发中心 \> 智能体管理 \> 单智能体"或选择"开发中心 \> 智能体管理 \> 多智能体"。
     
  
  3. 鼠标移动至待复制ID的智能体应用卡片上，单击"复制ID"。
     
   
- conversation_id：会话ID，每个会话的唯一标识符。用户可将会话ID设置为任意字符串，例如"123e4567e89b12d3a456426614174000"，无需在其他地方获取。字符串长度为1\~64个字符，支持英文字母、数字、中划线、下划线。