更新时间：2026-09-21 GMT+08:00

调用智能体概述

调用智能体是Managed Agents的核心使用环节。通过WebSocket协议向已创建的智能体发送消息，智能体在沙箱环境中自主决策、调用工具、执行任务，并将流式结果实时返回给调用方。整个过程由平台全托管，开发者无需自行搭建智能体循环、沙箱编排或工具执行层。

创建智能体时，用户需为其配置入站身份认证方式，作为后续调用该智能体的身份验证机制。智能体支持IAM认证、OAuth 2.0认证和API Key认证三种方式。调用方需按照智能体所配置的认证方式完成身份验证，方可成功调用智能体。

这里介绍IAM认证、API Key认证的调用，具体请参考调用智能体（IAM认证）、调用智能体（API Key认证）。

Managed Agents的智能体在创建完成后，处于已部署但未交互状态。调用智能体功能解决了以下问题：

场景	说明
连通性调测	智能体创建后，通过发送简单消息（如“你好”）验证端到端链路（认证→WebSocket连接→沙箱启动→模型响应→流式返回）是否畅通。
单轮任务执行	发送一条指令，智能体自主决策调用内置工具（如write_file创建文件、bash执行命令），完成文件操作或命令执行任务。
多轮有状态交互	在同一会话ID下持续发送消息，智能体维护上下文信息与文件系统状态，实现跨轮次的连续对话。
工具能力验证	启用或禁用特定工具后，通过调用验证智能体是否正确使用工具（如write_file写入成功）或正确拒绝（工具不可用时给出提示）。
干预与中断	在任务执行过程中，发送新消息变更原有执行方向，或直接终止、暂停当前任务。
长时运行任务	任务持续运行数分钟至数小时，包含多次工具调用，调用方通过流式事件实时监控执行进度。