通过SDK部署智能体运行时

本文以预置Agent模板为例，介绍如何在本地使用AgentArts SDK的Toolkit工具将本地代码部署到云上AgentArts智能体运行时。

背景介绍

AgentArts SDK包含一套命令行工具，用于简化Agent应用的全生命周期管理，包括初始化、配置、构建、部署和运维。当前Toolkit已预置以下Agent示例模板供您选择，您也可以使用自研代码：

basic：基础智能体模板，具有最小化的设置。适用于从一个非常简单的起点开始，然后根据需求逐步添加功能的开发者。它提供一个基本的框架，可以帮助开发者快速启动项目，而不需要从零开始构建所有内容。
langgraph：基于LangGraph的智能体，适用于需要处理复杂状态和逻辑的应用场景。
langchain：基于LangChain的智能体，适合需要将多个语言处理工具和服务集成到一个应用中的场景。
google-adk：Google ADK智能体模板，适用于利用Google提供的技术和工具来开发智能体应用的开发者。

前提条件

操作系统：Linux ARM64，服务器可访问公网。

需使用ARM64系统制作的Agent镜像，使用X86系统制作的镜像在调用智能体运行时时会调用失败。
安装Python：请确保Python 3.10及以上版本已安装。
大多数Linux发行版（如Ubuntu）都预装了Python，您可以先通过python3 --version检查。如未安装，可以使用如下命令安装：
```
sudo apt update
sudo apt install python3
```
安装Docker：请确保Docker 18.06及以上版本已安装。如未安装，可以使用如下命令安装：
```
# 查询 Docker 版本
docker --version

# 安装Docker
sudo apt update
sudo apt install docker.io
```
华为云SWR基础版不支持OCI镜像格式，如果您使用的是Docker 27及以上版本，并且需要处理OCI镜像，可以通过设置环境变量来关闭OCI支持。
```
export BUILDKIT_USE_OCI_MEDIA_TYPES=0
```
执行以下命令安装SDK（建议在Python虚拟环境中安装，以避免与系统包产生冲突）。
```
# 创建并激活虚拟环境 (linux) 
python3 -m venv venv
source venv/bin/activate

# 安装sdk
pip install agentarts-sdk
```
- 如果系统缺少python3-venv包，导致无法创建虚拟环境，请按照命令回显提示安装python3-venv包。
- 如安装SDK时速度较慢或下载超时，请参考执行pip install agentarts-sdk命令安装AgentArts SDK时速度较慢或下载超时解决。

执行以下命令配置华为云凭证，获取华为云凭证请参考认证鉴权。

export HUAWEICLOUD_SDK_AK="your-access-key"
export HUAWEICLOUD_SDK_SK="your-secret-key"

通过SDK部署智能体运行时

创建agent。

执行以下命令初始化一个LangGraph项目，支持基本的问答能力。

agentarts init -n my-agent -t langgraph

my_agent/
├── agent.py              # Agent implementation
├── requirements.txt      # Python dependencies
├── Dockerfile            
└── .agentarts_config.yaml # Project configuration

（可选）配置agent。使用交互式配置向导设置部署参数。
```
agentarts config
```
配置向导会引导完成以下配置，按Enter键标识使用默认配置：
1. Agent名称（显示已有Agent列表）
2. 入口函数（格式：module:function）
3. 华为云区域（默认cn-southwest-2）
4. 依赖文件（自动检测requirements.txt）
5. SWR组织名称
6. SWR仓库名称

修改.agentarts_config.yaml中环境变量配置。

environment_variables:
  - key: OPENAI_API_KEY
    value: 您申请的大模型apikey
  - key: OPENAI_MODEL_NAME
    value: 您申请的大模型名称
  - key: OPENAI_BASE_URL
    value: 您申请的大模型访问地址

部署agent。

执行以下命令，将应用在本地构建镜像并部署至AgentArts智能体运行时。
```
agentarts launch
```
首次部署耗时较长，大约需要3-5min，请耐心等待。

当回显部署完成时，则表示创建成功。

图1 部署完成

部署完成后登录AgentArts控制台，查看已部署的智能体运行时及详细信息。

图2 查看已部署的智能体运行时
查看智能体启动状态以及调试agent。

执行以下命令, 对agent进行调试。
```
agentarts invoke '{"message":"你好"}'
```
调用成功结果如下：