通过sdk部署智能体运行时-j9九游会登录

本文以预置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系统制作的镜像在调用智能体运行时时会调用失败。

可以使用华为云ecs服务购买服务器，购买时需要选择鲲鹏架构（arm64）。
安装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
```
安装完成后，建议立即配置国内镜像加速器。在后续执行agentarts launch构建镜像时，docker需要拉取python:3.10-slim基础镜像，默认从docker.io官方仓库下载，可能超时失败。提前配置加速器可避免此问题。

执行以下命令创建docker配置目录：
```
sudo mkdir -p /etc/docker
```
执行以下命令配置国内镜像源（直接复制并回车执行）：
```
sudo tee /etc/docker/daemon.json <<-'eof'
{
  "registry-mirrors":[
    "https://docker.m.daocloud.net",
    "https://dockerproxy.net",
    "https://mirror.baidubce.com"
  ]
}
eof
```
依次执行以下命令重启docker服务，使配置生效：
```
sudo systemctl daemon-reload
sudo systemctl restart docker
```
华为云swr基础版不支持oci镜像格式，如果您使用的是docker 27及以上版本，并且需要处理oci镜像，可以通过设置环境变量来关闭oci支持。
```
export docker_buildkit=0
# 或者
export buildkit_use_oci_media_types=0
```
执行以下命令安装sdk（建议在python虚拟环境中安装，以避免与系统包产生冲突）。
```
# 安装依赖包
apt install python3.12-venv
# 创建并激活虚拟环境 (linux) 
python3 -m venv venv
source venv/bin/activate
# 安装sdk
pip install agentarts-sdk
```
- 执行pip install agentarts-sdk命令下载缓慢、超时可以更改为使用如下命令
```
pip install agentarts-sdk -i https://repo.huaweicloud.com/repository/pypi/simple --trusted-host repo.huaweicloud.com
```
- 如果系统缺少python3-venv包，导致无法创建虚拟环境，请按照命令回显提示安装python3-venv包。

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

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":"你好"}'
```
调用成功结果如下：