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

创建Managed Agents

本指南带您完成：在AgentArts智能体平台创建一个智能体、获取调用信息、在本地与智能体对话。

核心概念

智能体（Agent）
定义功能与职责（“做什么”），涵盖模型、系统提示词、运行环境、工具与技能等配置项。关联运行环境以保障正常执行。同时支持版本管理。
环境（Environment）
定义智能体运行位置（“哪里运行”），涵盖入站网关、出网网络配置、会话存储等配置项。被智能体关联后禁止修改。
委托
智能体运行所需的云资源访问授权。
Skill
从技能库选择挂载到智能体的技能包。
会话
一次完整的交互上下文，引用智能体和环境配置。

前提条件

已开通AgentArts服务，并在“管理中心 > 授权管理”完成依赖云服务授权。

本地已安装Python 3.10或以上（调用智能体时使用）。

接入模型

这里以接入华为云MaaS的GLM-5.3模型为例，采用OpenAI兼容协议，区域选择“西南-贵阳一”。

查看及获取MaaS的GLM-5.3模型信息

进入“西南-贵阳一”MaaS页面，选择“模型推理 > 在线推理”，找到GLM-5.3模型，查看模型类型。
图1 获取模型信息1
单击“API调用 > 主推版本”，查看接口协议，获取API地址（Base_url）、model参数值（模型名称）、认证方式及位置。
图2 获取模型信息2
获取API Key。
在MaaS左侧导航，选择“模型与统计 > API Key 管理”，单击“创建 API Key”，如图3所示，单击“确定”，复制保存API Key信息。
图3 创建API Key
查看API Key鉴权请求格式。
在OpenAI兼容接口页面，查看鉴权请求。

图4 API Key请求格式

接入模型供应商

登录AgentArts智能体平台，在左侧导航选择“托管与运行 > 模型”。
单击“添加模型供应商”，配置模型供应商基本信息，如图5所示。
Base_url为模型API地址，获取方法请参考2。

图5 配置模型供应商基本信息
配置权限与访问控制，如图6所示。
图6 权限与访问控制
- 出站身份认证：访问MaaS模型的认证方式，获取请参考2。
  单击“创建出站身份”，填写信息，如图7所示，单击“创建”。
  
  API Key值：获取方式请参考3。
  图7 创建出站身份
- 位置：标头。获取请参考2。
- 参数名称 (可选)：Authorization，获取请参考4。
- 前缀 (可选)：Bearer，获取请参考4。
高级配置。
保持默认。

模型供应商信息配置完成后，即可接入模型服务。

接入模型服务

单击“添加模型服务”，配置模型信息，如图8所示，配置完成后，单击“确定”。
模型名称：查看GLM-5.3接口中的model字段值，具体请参考2。

API接口协议：查看GLM-5.3遵循的接口协议，具体请参考2。

模型类型：查看GLM-5.3的模型类型，具体请参考1。

图8 配置模型信息
单击“创建”。
模型供应商显示在模型列表中，接入的模型服务显示在模型供应商详情页面的模型服务列表中，即可被选择使用。

创建您的第一个智能体

创建智能体并获取调用信息。

创建智能体

登录AgentArts智能体平台，在左侧导航选择“Managed Agents”。
选择“智能体 > 创建智能体 > 快速创建”，填写参数信息。
- 名称：智能体的展示名称，供用户在列表中快速识别与检索该智能体。系统默认生成以agent开头的名称，可以自定义。创建后，不可编辑。由2~40个字符组成，包含小写字母、数字和中划线，且必须以小写字母开头、以小写字母或数字结尾。
- 模型：智能体使用的模型。
单击“确定”。
自动创建环境，入站身份认证为API Key，入网配置为defaultgw，未开启日志记录。

API Key由凭据管理服务（DEW）托管，托管按需计费，费用说明请参考DEW 计费说明。

创建后，智能体显示在智能体列表中。

获取调用信息

调用智能体的命令如下，需要参考表1获取相应的调用信息：

python managed_agents_client.py --url "ws://{endpoint}/runtimes/{runtime_name}/ws" --auth "Bearer {api_key}" --session-id "{会话ID}" --message "你好"

表1 获取调用信息
参数	操作
managed_agents_client.py	脚本文件名由脚本名称和文件类型后缀组成。例如，脚本名称为managed_agents_client，文件类型为Python脚本（.py），则完整文件名为managed_agents_client.py。
运行时名称（{runtime_name}）	在“Managed Agents > 智能体”页面，复制需要调用的智能体名称。在左侧导航选择“托管与运行 > 智能体运行时”，搜索已获取的智能体名称。在“智能体运行时”列表，显示的名称以managed-开头，即为运行时名称。
访问域名（{endpoint}）	单击运行时名称，进入运行时详情页面，在“访问域名”区域，即可复制访问域名。
API Key（{api_key}）	在运行时详情页面，单击URN。进入工作负载身份详情页面，即可复制API Key值。
会话ID（{会话ID}）	每个会话的唯一标识符，需自定义。用户可将会话ID设置为任意字符串，由英文字母、数字、“-”、“_”组成，不超过64个字符。例如“123e4567e89b12d3a456426614174000”。

调用智能体

安装依赖

打开命令提示符窗口，输入如下命令：

pip install websockets>=10.0 --break-system-packages

发送调用智能体命令

下载managed_agents_client.py至本地，该脚本用于通过WebSocket与Managed Agents后端交互，调测智能体与用户本地连通性。

在managed_agents_client.py脚本所在目录，使用Windows命令提示符（CMD）工具，执行如下命令，把四个占位符换成您在获取调用信息中获取的值：

python managed_agents_client.py --url "ws://{endpoint}/runtimes/{runtime_name}/ws" --auth "Bearer {api_key}" --session-id "{会话ID}" --message "你好"

显示结果

[2/5] 已连接 ws://{endpoint}/runtimes/{runtime_name}/ws
[3/5] 服务端就绪
[4/5] 已发送: 你好

[Frame] {"response_kind":"e2a.chunk","status":"in_progress","body":{"delta_kind":"text","delta":"你好","event_type":"chat.delta"}}
你好
[Frame] {"response_kind":"e2a.chunk","status":"in_progress","body":{"delta_kind":"text","delta":"！有什么可以帮你的吗？","event_type":"chat.delta"}}
！有什么可以帮你的吗？
[Frame] {"response_kind":"e2a.complete","status":"succeeded","is_final":true,"body":{"result":{"content":"你好！有什么可以帮你的吗？"}}}

========================================
回复: 你好！有什么可以帮你的吗？
========================================
[5/5] 已断开

Managed Agents执行流程

通过API发送消息后，Managed Agents执行流程：

沙箱配置：沙箱将按照您设置的环境配置完成构建。
智能体循环执行：在智能体循环执行过程中，Managed Agents根据您发送的消息，自主决策需要调用的工具。
工具执行：所有文件写入操作、bash命令执行以及其余工具调用，都将在沙箱环境中运行。
流式事件推送：当智能体执行任务时，您将收到实时状态更新。
转为空闲状态：当智能体没有需要执行的任务时，会触发该状态。

下一步

成功创建第一个Managed Agent后，可以进一步探索：

了解运行环境的完整配置：配置运行环境。
深入了解智能体各项配置参数：设置智能体、模型、提示词。
了解内置工具与Skill的使用：内置工具、Skill。

常见问题

Q1：报错AgentArts.03002006，如何处理？

A：创建智能体时，如果报错AgentArts.03002006，请按如下操作进行处理：

图9 报错信息

在AgentArts智能体平台左侧导航，选择“治理与安全 > 网络配置”。
在defaultgw详情页面，单击“编辑”，再单击“确定”即可，如图10和图11所示。
图10 编辑

 图11 确定
再在“Managed Agents”页面，执行创建智能体操作。