# 快速使用 本章节旨在帮助用户快速了解基本功能，建议在充分了解各项功能后再进行深度应用。 #### 前提条件 - 已开通AgentArts服务，并在"管理中心 \> 授权管理"完成依赖云服务授权。 - 本地已安装**Python 3.10或以上**（调用智能体时使用）。 #### 步骤一：接入模型 这里以接入华为云MaaS的GLM-5.3模型为例，采用OpenAI兼容协议，区域选择"西南-贵阳一"。 #### 查看及获取MaaS的GLM-5.3模型信息 1. 进入"西南-贵阳一"[MaaS页面](https://console.huaweicloud.com/modelarts/#/model-studio/homepage)，选择"模型推理 \> 在线推理"，找到GLM-5.3模型，查看模型类型。 图1获取模型信息1 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002745194624.png "点击放大") 2. 单击"API调用 \> 主推版本"，查看接口协议，获取API地址（Base_url）、model参数值（模型名称）、认证方式及位置。 图2获取模型信息2 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002774913819.png "点击放大") 3. 获取API Key。 在MaaS左侧导航，选择"模型与统计 \> API Key 管理"，单击"创建 API Key"，如[图3]所示，单击"确定"，复制保存API Key信息。 图3创建API Key ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002745354534.png "点击放大") 4. 查看API Key鉴权请求格式。 在[OpenAI兼容接口](https://support.huaweicloud.com/model-call-maas/model-call-021.html)页面，查看鉴权请求。 图4API Key请求格式 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002774793721.png "点击放大") #### 接入模型供应商 1. 登录[AgentArts控制台](https://console.huaweicloud.com/agentarts)，在左侧导航选择"托管与运行 \> 模型"。 2. 单击"添加模型供应商"，配置模型供应商基本信息，如[图5]所示。 Base_url为模型API地址，获取方法请参考[2]。 图5配置模型供应商基本信息 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002772766765.png "点击放大") 3. 配置权限与访问控制，如[图6]所示。 图6权限与访问控制 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002745194628.png) - 出站身份认证：访问MaaS模型的认证方式，获取请参考[2]。 单击"创建出站身份"，填写信息，如[图7]所示，单击"创建"。 API Key值：获取方式请参考[3]。 图7创建出站身份 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002774913821.png "点击放大") - 位置：标头，获取请参考[2]。 - 参数名称 (可选)：Authorization，获取请参考[4]。 - 前缀 (可选)：Bearer，获取请参考[4]。 4. 高级配置。 保持默认。 模型供应商信息配置完成后，即可[接入模型服务]。 #### 接入模型服务 1. 单击"添加模型服务"，配置模型信息，如[图8]所示，配置完成后，单击"确定"。 模型名称：查看GLM-5.3接口中的model字段值，具体请参考[2]。 API接口协议：查看GLM-5.3遵循的接口协议，具体请参考[2]。 模型类型：查看GLM-5.3的模型类型，具体请参考[1]。 图8配置模型信息 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002743247526.png "点击放大") 2. 单击"创建"。 模型供应商显示在模型列表中，接入的模型服务显示在模型供应商详情页面的模型服务列表中，即可被选择使用。 #### 步骤二：快速创建智能体 1. 在[Managed Agents](https://console.huaweicloud.com/agentarts/#/home/managed-agents/agent)页面，选择"智能体 \> 创建智能体 \> 快速创建"，配置智能体参数。 图9选择快速创建 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002753413789.png "点击放大") 图10创建智能体 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002745369318.png "点击放大") 表1参数说明 | 参数 | 说明 | |:---|:---| | 名称 | 智能体的展示名称，供用户在列表中快速识别与检索该智能体。系统默认生成以agent开头的名称，可以自定义。创建后，不可编辑。 由2\~40个字符组成，包含小写字母、数字和中划线，且必须以小写字母开头、以小写字母或数字结尾。 | | 模型 | 智能体使用的模型。 | 2. 单击"确定"。 自动创建环境，入站身份认证为API Key，入网配置为defaultgw，未开启日志记录。 ![](https://support.huaweicloud.com/managedagents-agentarts/public_sys-resources/note_3.0-zh-cn.png) API Key由凭据管理服务（DEW）托管，托管按需计费，费用说明请参考[DEW 计费说明](https://support.huaweicloud.com/price-dew/dew_03_0005.html)。 创建后，智能体显示在智能体列表中。 #### 步骤三：调用智能体 用于调测智能体与用户本地连通性。 #### 获取调用信息 调用智能体的命令格式如下，需要参考[表2]获取相应的调用信息： ``` python managed_agents_client.py --url "ws://{endpoint}/runtimes/{runtime_name}/ws" --auth "Bearer {api_key}" --session-id "{会话ID}" --message "你好" ``` 表2获取调用信息 | 参数 | 操作 | |:---|:---| | *managed_agents_client.py* | 脚本文件名由脚本名称和文件类型后缀组成。例如，脚本名称为managed_agents_client，文件类型为Python脚本（.py），则完整文件名为managed_agents_client.py。 | | 运行时名称（*{runtime_name}*） | 1. 在"Managed Agents \> 智能体"页面，复制需要调用的智能体名称。 2. 在左侧导航选择"托管与运行 \> 智能体运行时"，搜索已获取的智能体名称。 在"智能体运行时"列表，显示的名称以managed-开头，即为运行时名称。 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002727514754.png "点击放大") | | 访问域名（*{endpoint}*） | 单击运行时名称，进入运行时详情页面，在"访问域名"区域，即可复制访问域名。 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002757154451.png "点击放大") | | API Key（*{api_key}*） | 1. 在运行时详情页面，单击URN。 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002757074325.png "点击放大") 2. 进入工作负载身份详情页面，即可复制API Key值。 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002727674600.png "点击放大") | | 会话ID（*{会话ID}*） | 每个会话的唯一标识符。用户可将会话ID设置为任意字符串，由英文、数字、"-"、"_"组成，不超过64个字符。例如"123e4567e89b12d3a456426614174000"。 | #### 调用智能体 **安装依赖** 打开命令提示符窗口，输入如下命令： ``` pip install websockets>=10.0 --break-system-packages --break-system-packages ``` **发送调用智能体命令** 下载[managed_agents_client.py](https://res-static.hc-cdn.cn/cloudbu-site/china/zh-cn/agentarts/ManagedAgents/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"原始帧和流式回复文本。 #### Managed Agents执行流程 通过API发送消息后，Managed Agents执行流程： 1. 沙箱配置：沙箱将按照您设置的环境配置完成构建。 2. 智能体循环执行：在智能体循环执行过程中，Managed Agents根据您发送的消息，自主决策需要调用的工具。 3. 工具执行：所有文件写入操作、bash命令执行以及其余工具调用，都将在沙箱环境中运行。 4. 流式事件推送：当智能体执行任务时，您将收到实时状态更新。 5. 转为空闲状态：当智能体没有需要执行的任务时，会触发该状态。 #### 后续操作 - [配置专属智能体](https://support.huaweicloud.com/managedagents-agentarts/agentarts_13_0003.html) - [配置智能体运行环境](https://support.huaweicloud.com/managedagents-agentarts/agentarts_13_0012.html) - [将工作交给智能体](https://support.huaweicloud.com/managedagents-agentarts/agentarts_13_0015.html) #### 常见问题 Q1：报错AgentArts.03002006，如何处理？ A：创建智能体时，如果报错AgentArts.03002006，请按如下操作进行处理： 图11报错信息 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002767560507.png "点击放大") 1. 在[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)左侧导航，选择"治理与安全 \> 网络配置"。 2. 在defaultgw详情页面，单击"编辑"，再单击"确定"即可，如[图12]和[图13]所示。 图12编辑 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002738189634.png "点击放大") 图13确定 ![](https://support.huaweicloud.com/managedagents-agentarts/zh-cn_image_0000002767549137.png "点击放大") 3. 再在"Managed Agents"页面，执行创建智能体操作。