---
title: agentsdk
description: 昇腾社区是基于昇腾系列处理器和基础软件构建的全栈 AI计算基础设施、行业应用及服务，包括昇腾系列处理器、系列硬件、CANN异构计算架构、AI计算框架、应用使能、开发工具链、管理运维工具、行业应用及服务等全产业链。
keywords: 公开,Agent,SDK,快速参考,Aura,简介,支持的,Tags
url: https://www.hiascend.com/developer/ascendhub/detail/agentsdk
section: (其他)
---

# agentsdk

URL: https://www.hiascend.com/developer/ascendhub/detail/agentsdk
描述: 昇腾社区是基于昇腾系列处理器和基础软件构建的全栈 AI计算基础设施、行业应用及服务，包括昇腾系列处理器、系列硬件、CANN异构计算架构、AI计算框架、应用使能、开发工具链、管理运维工具、行业应用及服务等全产业链。
关键词: 公开,Agent,SDK,快速参考,Aura,简介,支持的,Tags

昇腾镜像仓库 [了解详情](https://www.hiascend.com/developer/ascendhub)

agentsdk

## agentsdk公开

最新版本：26.1.0-cann9.0.0-torch_npu2.9.0-a3-ubuntu22.04-py3.112026/07/30更新大小：22 GB发布者：Ascend46次下载

推理

镜像概述

镜像下载

镜像概述

镜像下载

...

# Agent SDK

## 1.快速参考

- 从哪里获取帮助

- issue 反馈 [了解详情](https://gitcode.com/Ascend/AgentSDK/issues)
- AgentSDK 代码 [了解详情](https://gitcode.com/Ascend/AgentSDK/tree/master/aura)
- Aura 快速启动文档 [了解详情](https://www.hiascend.com/../../docs/zh/aura/03_quick_start.md)
- 社区 [了解详情](https://www.hiascend.com/)

## 2.Aura简介

Aura(Agentic Ultra-fast Reinforcement Architecture) 是一个面向基础模型的训推调一体化框架，能够基于任务轨迹和奖励信号持续优化基础模型，通过强化学习等优化方法，使模型通过后训练，逐步具备规划、工具使用和长程决策等 Agent 化能力。

Aura 通过统一抽象接口兼容多种训练引擎、推理引擎与 Agent 框架，支持用户灵活接入自定义模型与工具链，帮助开发者快速构建、训练与部署自己的 Agent。

## 3.支持的 Tags 及 Dockerfile 链接

### 3.1 Tag 规范

Tag 遵循以下格式：

```
<AgentSDK版本>-<CANN版本>-<pytorch版本>-<芯片系列>-<操作系统>-<python版本>
```

| 字段 | 示例值 | 说明 |
| --- | --- | ---|
| AgentSDK版本 | 26.1.0 | Agent SDK 版本号 |
| CANN版本 | cann9.0.0 | CANN 版本 |
| pytorch版本 | torch_npu2.7.1,torch_npu2.9.0.post2 | PyTorch 版本 |
| 芯片系列 | 910,910b,a3,310p | 目标芯片系列 |
| 操作系统 | ubuntu22.04,openeuler24.03 | 操作系统 |
| python版本 | py3.11 | Python 版本 |

### 3.2 CANN 9.0.0 + 26.1.0 Agent SDK镜像

| Tag | Dockerfile | 镜像内容 |
| --- | --- | ---|
| 26.1.0-cann9.0.0-torch_npu2.9.0-910b-ubuntu22.04-py3.11 | Dockerfile | toolkit + Agent SDK |
| 26.1.0-cann9.0.0-torch_npu2.9.0-a3-ubuntu22.04-py3.11 | Dockerfile | toolkit + Agent SDK |
| 26.1.0-cann9.0.0-torch_npu2.9.0-910b-openeuler24.03-py3.11 | Dockerfile | toolkit + Agent SDK |
| 26.1.0-cann9.0.0-torch_npu2.9.0-a3-openeuler24.03-py3.11 | Dockerfile | toolkit + Agent SDK |

## 4.快速开始

### 4.1 前置要求

#### 4.1.1 安装驱动

- 主机上必须安装与容器内 CANN 版本兼容的NPU 驱动。请参阅CANN 兼容性矩阵 [了解详情](https://www.hiascend.com/document)了解驱动与 CANN 版本的对应关系。
- docker版本要求：docker版本建议不低于24.0.x。

### 4.2 运行 Aura 容器

#### 手动挂载设备

- 设备挂载 ：通过 --device 参数将宿主机的设备文件映射到容器中，确保容器能够访问指定的硬件资源。/dev/davinci为NPU加速卡（按需挂载），/dev/davinci_manager, /dev/devmm_svm， /dev/hisi_hdc为NPU管理设备（全部挂载）。
- 驱动与工具链挂载 ：将宿主机上的驱动文件和工具链目录（如 /usr/local/Ascend/driver 和 /usr/local/bin/npu-smi）以只读方式挂载到容器中，保证容器内的运行环境与宿主机一致。 以下样例代码中，/dev/davinci1 表示挂载 1 号设备。

```
docker run --name your_container_name \
    --hostname agent \
    --network host \
    -it -d --shm-size=500g \
    --device=/dev/davinci0 --device=/dev/davinci1 \
    --device=/dev/davinci2 --device=/dev/davinci3 \
    --device=/dev/davinci4 --device=/dev/davinci5 \
    --device=/dev/davinci6 --device=/dev/davinci7 \
    --device=/dev/davinci8 --device=/dev/davinci9 \
    --device=/dev/davinci10 --device=/dev/davinci11 \
    --device=/dev/davinci12 --device=/dev/davinci13 \
    --device=/dev/davinci14 --device=/dev/davinci15 \
    --device=/dev/davinci_manager \
    --device=/dev/hisi_hdc \
    --device=/dev/devmm_svm \
    -v /usr/local/Ascend/driver:/usr/local/Ascend/driver \
    -v /usr/local/dcmi:/usr/local/dcmi \
    -v /usr/local/bin/npu-smi:/usr/local/bin/npu-smi \
    -v /etc/ascend_install.info:/etc/ascend_install.info \
    -v /usr/share/zoneinfo/Asia/Shanghai:/etc/localtime \
    -v /usr/local/sbin:/usr/local/sbin \
    your_image_name:your_image_tag  \
    sleep infinity
```

[!NOTE] 说明

1. 根据 NPU 数量的不同，挂载不同数量的设备 ID。例如： Atlas A3 有 16 个 NPU，需挂载 16 个设备 ID，每个设备 ID 对应一个 NPU。
2. 镜像内默认工作目录为 /home/work，因此不建议挂载整个 /home 目录，以避免覆盖容器内默认工作空间或引发权限冲突。

### 4.3 快速启动用例

快速启动参考：Qwen3-4B 共卡模式快速拉起指南 [了解详情](https://www.hiascend.com/../../docs/zh/aura/models/qwen3-4b_quick_start/qwen3-4b-hybrid.md)

## 5. 支持的硬件

| 芯片系列 | 产品示例 | 架构 |
| --- | --- | ---|
| Atlas 910 | Atlas 800I A2 | ARM64 / x86_64 |
| Atlas A3 | Atlas 800I A3 | ARM64 / x86_64 |

## 6. 许可证

查看这些镜像中包含的 CANN 和 Mind 系列软件的许可证信息 [了解详情](https://github.com/Ascend/cann-container-image/blob/main/LICENSE)。

与所有容器镜像一样，预装软件包（Python、系统库等）可能受其自身许可证约束。

agentsdk 镜像版本

| 版本 | 文件大小 | 更新时间 | 架构 | 操作 |
| --- | --- | --- | --- | ---|
| 26.1.0-cann9.0.0-torch_npu2.9.0-a3-ubuntu22.04-py3.11 | 22 GB | 2026/07/30 | arm64x86_64 | 立即下载 |
| 26.1.0-cann9.0.0-torch_npu2.9.0-a3-openeuler24.03-py3.11 | 22 GB | 2026/07/30 | arm64x86_64 | 立即下载 |
| 26.1.0-cann9.0.0-torch_npu2.9.0-910b-openeuler24.03-py3.11 | 22 GB | 2026/07/30 | arm64x86_64 | 立即下载 |
| 26.1.0-cann9.0.0-torch_npu2.9.0-910b-ubuntu22.04-py3.11 | 22 GB | 2026/07/30 | arm64x86_64 | 立即下载 |