# 调用智能体概述
调用智能体是Managed Agents的核心使用环节。通过WebSocket协议向已创建的智能体发送消息，智能体在沙箱环境中自主决策、调用工具、执行任务，并将流式结果实时返回给调用方。整个过程由平台全托管，开发者无需自行搭建智能体循环、沙箱编排或工具执行层。
创建智能体时，用户需为其配置入站身份认证方式，作为后续调用该智能体的身份验证机制。智能体支持IAM认证、OAuth 2.0认证和API Key认证三种方式。调用方需按照智能体所配置的认证方式完成身份验证，方可成功调用智能体。
这里介绍IAM认证、API Key认证的调用，具体请参考[调用智能体（IAM认证）](https://support.huaweicloud.com/managedagents-agentarts/agentarts_13_0029.html)、[调用智能体（API Key认证）](https://support.huaweicloud.com/managedagents-agentarts/agentarts_13_0016.html)。
#### 为什么调用智能体
Managed Agents的智能体在创建完成后，处于已部署但未交互状态。调用智能体功能解决了以下问题：
- **连通性验证**：首次创建智能体后，需验证智能体与本地环境的网络连通性和认证链路是否正常。
- **任务执行入口**：智能体的所有能力（模型推理、工具调用、Skill执行、文件操作）均需通过调用功能触发，没有其他途径使智能体开始工作。
- **实时交互通道**：通过WebSocket实现全双工通信，支持流式事件推送，调用方可在任务执行过程中实时观察智能体的决策与执行状态。
- **多会话隔离**：每次调用通过会话ID隔离上下文，支持同一智能体被多用户并发调用且互不干扰。
 
#### 应用场景
| 场景         | 说明                                                                  |
|:---|:---|
| 连通性调测   | 智能体创建后，通过发送简单消息（如"你好"）验证端到端链路（认证→WebSocket连接→沙箱启动→模型响应→流式返回）是否畅通。 |
| 单轮任务执行    | 发送一条指令，智能体自主决策调用内置工具（如write_file创建文件、bash执行命令），完成文件操作或命令执行任务。      |
| 多轮有状态交互 | 在同一会话ID下持续发送消息，智能体维护上下文信息与文件系统状态，实现跨轮次的连续对话。                        |
| 工具能力验证 | 启用或禁用特定工具后，通过调用验证智能体是否正确使用工具（如write_file写入成功）或正确拒绝（工具不可用时给出提示）。  |
| 干预与中断   | 在任务执行过程中，发送新消息变更原有执行方向，或直接终止、暂停当前任务。                               |
| 长时运行任务    | 任务持续运行数分钟至数小时，包含多次工具调用，调用方通过流式事件实时监控执行进度。                            |