快速使用

获取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. 单击“创建”。

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

获取调用信息

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

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

调用智能体

安装依赖

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

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] 已断开

权限审批和用户提问均在后台自动处理，终端只显示“Frame”原始帧和流式回复文本。