文档首页/ 智果（AgentArts）智能体平台/ 开始使用/ 创建Managed Agents
更新时间：2026-10-10 GMT+08:00
查看PDF
分享

创建Managed Agents

本指南将带您完成以下操作：在AgentArts智能体平台创建智能体、获取调用信息、并在本地与智能体对话。

核心概念

  • 智能体（Agent）

    定义功能与职责（“做什么”），涵盖模型、系统提示词、运行环境、工具与技能等配置项。关联运行环境以保障正常执行。同时支持版本管理。

  • 环境（Environment）

    定义智能体运行位置（“哪里运行”），涵盖入站网关、出网网络配置、会话存储等配置项。被智能体关联后禁止修改。

  • 委托

    智能体运行所需的云资源访问授权。

  • Skill

    从技能库选择挂载到智能体的技能包。

  • 会话

    一次完整的交互上下文，引用智能体和环境配置。

前提条件

  • 已开通AgentArts服务，并在“管理中心 > 授权管理”完成依赖云服务授权。
  • 本地已安装Python 3.10或以上（调用智能体时使用）。

添加模型

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

获取MaaS的GLM-5.3模型信息

  1. 进入“西南-贵阳一”MaaS页面，选择“模型推理 > 在线推理”，找到GLM-5.3模型，查看模型类型。
    图1 获取模型信息1
  2. 单击“API调用 > 主推版本”，查看模型信息。
    图2 获取模型信息2
  3. 获取模型API Key。
    在MaaS左侧导航，选择“模型与统计 > API Key 管理”，单击“创建 API Key”，如图3所示，复制并保存API Key信息。
    图3 创建API Key

添加模型供应商

  1. 登录AgentArts控制台，在左侧导航选择“托管与运行 > 模型”。
  2. 单击“添加模型供应商”，配置模型供应商基本信息，如图4所示。
    图4 配置模型供应商基本信息
    表1 参数说明

    参数

    示例

    说明

    名称

    maas

    模型提供商的名称。

    命名规则：以小写字母开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-40个字符。系统会默认生成名称，可根据需求自定义修改。

    描述（可选）

    接入华为云MaaS的GLM-5.3模型

    用于说明该模型提供商的内容与用途。

    Base_url

    https://api.modelarts-maas.com/openai/v1

    模型API地址，以 https:// 开头的完整 URL，长度为1-2048个字符。
  3. 配置权限与访问控制，如图5所示。

    此处的出站身份认证用于配置模型的认证方式。华为云MaaS的GLM-5.3模型支持API Key认证，通过在HTTP请求中携带API Key实现身份识别。

    图5 权限与访问控制
    表2 参数说明

    参数

    示例

    说明

    出站身份认证

    API Key认证

    用于配置模型的认证方式。创建认证方式如下：

    单击页面“创建出站身份”按钮，按页面提示填写身份名称、选择API Key类型、填写在MaaS界面获取的API Key。
    图6 创建出站身份

    位置

    标头

    API Key的传递位置。

    调用MaaS的模型服务时，MaaS要求把API Key放在HTTP请求头里传递，因此选择“标头”。

    参数名称 (可选)

    Authorization

    在请求中传递API的密钥时使用的具体名称。

    调用MaaS OpenAI兼容接口时，鉴权请求头的名称必须是Authorization。

    前缀 (可选)

    Bearer

    在请求头中传递API Key时，API密钥值之前的前缀部分。

    调用MaaS OpenAI兼容接口时，MaaS使用“Bearer $MaaS_API_Key”形式的鉴权，API Key不能直接填写，须添加Bearer前缀。

    出网网络配置

    公网访问

    用于指定访问MaaS模型时，使用的网络路径。

    取值：公网访问、私网访问。
  4. 高级配置。

    保持默认。

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

添加模型服务

  1. 单击“添加模型服务”，配置模型信息，如图7所示，配置完成后，单击“确定”。
    图7 配置模型信息
    表3 参数说明

    参数

    示例

    说明

    模型服务名称

    maas

    模型服务名称。

    命名规则：支持中英文、数字及符号 _./-，须以中英文或数字开头结尾，长度2-64个字符。

    系统会默认生成名称，可根据需求自定义修改。

    描述

    接入华为云MaaS模型即服务的GLM-5.3模型

    用于说明该模型服务的内容与用途。长度不大于1000个字符。

    模型名称

    glm-5.3

    模型名称，接口调用请求体中的model字段的取值。

    由英文、数字及符号（连字符、点、下划线、星号、问号和@）组成，支持 * 的前缀通配以及后缀通配，长度为1-256个字符。

    支持精确匹配与通配匹配，精确匹配优先。

    精确匹配：与请求 model 字段完全一致时匹配。例如，glm-5.3。

    前缀通配：*结尾，匹配所有以glm-开头的模型。例如，glm-*。

    后缀通配：*开头，匹配所有以-turbo结尾的模型。例如，*-turbo。

    同时满足精确和通配匹配时，优先精确匹配。

    通配匹配命中后，网关将客户端请求中的原始model值透传给后端，而非通配符本身。例如配置glm-*，请求glm-5.3-turbo 时，后端收到的model为glm-5.3-turbo。

    API接口协议

    标准OpenAI协议

    选择模型API接口协议，支持以下三种：

    • 标准OpenAI协议：兼容OpenAI API标准的协议。
    • Anthropic协议：兼容Anthropic API标准的协议。
    • 华为云MaaS标准API V1：用于对接MaaS V1版本接口，推荐使用适用范围更广的“标准OpenAI协议”。V1版本协议仅支持对接Qwen3-32B、Qwen3-30B-A3B模型，详见MaaS标准API V1。

    模型类型

    文本对话/图像理解

    模型支持的能力类别，须按模型实际能力选择。

    • 文本对话/图像理解
    • 文本向量化
    • 多模态对话
    • 文本排序
    • 实时语音对话
  2. 单击“创建”。

    模型供应商显示在模型列表中，添加的模型服务显示在模型供应商详情页面的模型服务列表中，即可被选择使用。

创建您的第一个智能体

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

创建智能体

  1. 登录AgentArts智能体平台，在左侧导航选择“Managed Agents”。
  2. 选择“智能体 > 创建智能体 > 快速创建”，配置智能体名称及模型。
    图8 选择快速创建
    图9 创建智能体
  3. 单击“确定”。

    系统会自动创建环境，其中，入站身份认证为API Key（调用智能体时，需要使用API Key鉴权），入网配置为defaultgw（访问智能体运行时的网络），未开启日志记录。

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

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

获取调用信息

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

python managed_agents_client.py --url "ws://{endpoint}/runtimes/{runtime_name}/ws" --auth "Bearer {api_key}" --session-id "{会话ID}" --message "你好"
表4 获取调用信息

参数

操作

managed_agents_client.py

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

运行时名称（{runtime_name}）

在AgentArts左侧导航，选择“托管与运行 > 智能体运行时”。在Managed Agents中创建的智能体，其运行时名称会显示在“智能体运行时”列表中，以managed-开头。找到目标智能体，复制其运行时名称即可。

访问域名（{endpoint}）

单击运行时名称，进入运行时详情页面，在“访问域名”区域，即可复制访问域名。

API Key（{api_key}）

智能体的API Key。

  1. 在运行时详情页面，单击URN。

  1. 进入工作负载身份详情页面，即可复制API Key值。

会话ID（{会话ID}）

每个会话的唯一标识符。用户可自定义会话ID，由英文、数字、“-”、“_”组成，不超过64个字符。例如“123e4567e89b12d3a456426614174000”。

调用智能体

当前版本中，智能体调用使用WebSocket调测脚本完成，主要用于快速体验。标准化API接入能力将随产品版本迭代持续完善并逐步开放。

安装依赖

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

pip install websockets>=10.0

如果出现以下报错，请执行如下命令：

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执行流程：

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

下一步

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

常见问题

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

A：创建智能体时，如果报错AgentArts.03002006，请按如下操作进行处理：
图10 报错信息
  1. 在AgentArts智能体平台左侧导航，选择“治理与安全 > 网络配置”。
  2. 在defaultgw详情页面，单击“编辑”，再单击“确定”即可，如图11和图12所示。
    图11 编辑
    图12 确定
  3. 然后返回“Managed Agents”页面，重新创建智能体。

相关文档