通过SDK部署智能体运行时

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

背景介绍

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

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

前提条件

已安装Python，且版本不低于3.10。查看Python版本的命令示例：python --version。
安装Docker：请确保Docker 18.06及以上版本已安装。如未安装，可以使用如下命令安装：
```
# 查询 Docker 版本
docker --version

# 安装Docker
sudo apt update
sudo apt install docker.io
```
使用智能体运行时前需要先开通AgentArts服务。
部署AgentArts SDK。
执行以下命令安装SDK（建议在Python虚拟环境中安装，以避免与系统包产生冲突）。
```
# 创建并激活虚拟环境 (linux) 
python3 -m venv venv
source venv/bin/activate

# 安装sdk
pip install agentarts-sdk
```
如果系统缺少python3-venv包，导致无法创建虚拟环境，请按照命令回显提示安装python3-venv包。

通过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仓库名称
部署agent。

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

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

图1 部署完成

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

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

执行以下命令，查看智能体运行时运行状态，回显中Healthy表示智能体运行时已启动成功。
```
agentarts status
```
执行以下命令, 对agent进行调试。
```
agentarts invoke '{"message":"你好"}'
```
调用成功结果如下：