快速使用

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

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

   图3 创建API Key
   
4. 查看API Key鉴权请求格式。

   在OpenAI兼容接口页面，查看鉴权请求。

   图4 API Key请求格式
   

接入模型供应商

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

   Base_url为模型API地址，获取方法请参考2。

   图5 配置模型供应商基本信息
   
3. 配置权限与访问控制，如图6所示。
   图6 权限与访问控制
   
   • 出站身份认证：访问MaaS模型的认证方式，获取请参考2。

     单击“创建出站身份”，填写信息，如图7所示，单击“创建”。

     API Key值：获取方式请参考3。

     图7 创建出站身份

     

   • 位置：标头，获取请参考2。
   • 参数名称 (可选)：Authorization，获取请参考4。
   • 前缀 (可选)：Bearer，获取请参考4。
4. 高级配置。

   保持默认。

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

接入模型服务

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

   模型名称：查看GLM-5.3接口中的model字段值，具体请参考2。

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

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

   图8 配置模型信息
   
2. 单击“创建”。

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

获取调用信息

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

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 --break-system-packages --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”原始帧和流式回复文本。