创建Managed Agents

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

核心概念

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

前提条件

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

智能体需要关联模型，请在创建智能体之前完成添加模型。

添加模型

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

如果已有可以使用的模型，则跳过此步骤。

获取MaaS的GLM-5.3模型信息

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

添加模型供应商

登录AgentArts控制台，在左侧导航选择“托管与运行 > 模型”。

单击“添加模型供应商”，配置模型供应商基本信息，如图4所示。

图4 配置模型供应商基本信息
点击放大

表1 参数说明
参数	示例	说明
名称	maas	模型供应商的名称，名称唯一。命名规则：以小写字母开头，以小写字母或数字结尾，可以包含小写字母、数字和中划线，长度为2-40个字符。系统会默认生成名称，可根据需求自定义修改。
描述（可选）	接入华为云MaaS的GLM-5.3模型	用于说明该模型供应商的内容与用途。
Base_url	https://api.modelarts-maas.com/openai/v1	模型API地址，以https://开头的完整URL，长度为1-2048个字符。

配置出站身份认证，如图5所示。

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

图5 出站身份认证

创建出站身份认证方式如下：

在“添加模型供应商”页面的“权限与访问控制”区域，单击“创建出站身份”，按页面提示填写身份名称、选择API Key类型、填写在MaaS界面获取的API Key。

图6 创建出站身份

表2 出站身份认证参数说明
参数	示例	说明
出站身份认证	API Key认证	用于配置模型的认证方式。
位置	标头	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前缀。

配置出网网络，如图7所示。

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

图7 出网网络配置

表3 出网网络配置参数说明
参数	示例	说明
出网网络配置	公网访问	用于指定访问MaaS模型时使用的网络路径。公网访问：能够连接到外部的互联网，访问外部的资源和服务。如无特殊网络要求，建议选择“公网访问”。私网访问：连接内部的私有网络，访问内部的资源和服务。如需通过VPC内网访问模型，选择“私网访问”。

高级配置。
保持默认。

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

添加模型服务

单击“添加模型服务”，配置模型信息，如图8所示，配置完成后，单击“确定”。

图8 配置模型信息

表4 参数说明
参数	示例	说明
模型服务名称	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。
模型类型	文本对话/图像理解	模型支持的能力类别，须按模型实际能力选择。文本对话/图像理解文本向量化多模态对话文本排序实时语音对话

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

创建您的第一个智能体

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

创建智能体

登录AgentArts智能体平台，在左侧导航选择“Managed Agents”。
选择“智能体 > 创建智能体 > 快速创建”，配置智能体名称及模型。
图9 选择快速创建

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

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

调用智能体产生的指标数据会上报到应用运维管理AOM，便于实时监控和分析应用的运行状态。指标管理费用按需收取，具体计费详情请参考AOM计费说明。指标信息可以通过指标预览页面进行查看。
图11 查看指标

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