接入安装
本页使用已发布的 2.12.0 SDK。npm 六坐标从远程 registry 安装;Java / Python / Go 的 Server 与 Console 六个 ZIP 从同版本 Release 下载并校验。SDK 制品发布与服务部署分别确认,不能由包版本推断目标环境的全部能力。
2.7.0 起 JS 包改名:appbase-web-sdk / appbase-node-sdk / appbase-console-sdk → agentbase-web-sdk / agentbase-node-sdk / agentbase-console-sdk,版本体系统一到服务版本号(2.7.x)。旧包名在 registry 上停留在 2.6 线(appbase-web-sdk@22.8.0 等),新迭代不要混用两套包名。
版本事实(npm 2.12.0 / ZIP v2.12.0,canonical)
| 项 | 精确值 |
|---|---|
| 服务版本 | 2.12.0(release-2.12.0 尖端 APP_VERSION_STABLE = 2.12.0,单次自 2.9.0 bump) |
| 项目元数据库迁移 | V61(由服务版本决定,不能由 npm / Python 包版本推断) |
| Web SDK(npm) | agentbase-web-sdk@2.12.0 |
| Node Server SDK(npm) | agentbase-node-sdk@2.12.0 |
| Console SDK(npm,JS 管理面) | agentbase-console-sdk@2.12.0 |
| Java Server SDK | io.agentbase:agentbase-java-sdk:2.12.0(ZIP 交付包,v2.12.0 release 终态) |
| Java Console SDK | io.agentbase.console:agentbase-console-java-sdk:2.12.0(ZIP 交付包,同上) |
| Python Server SDK | agentbase-python-sdk 2.12.0(wheel + sdist ZIP,离线安装) |
| Python Console SDK | agentbase-console-python-sdk 2.12.0(wheel + sdist ZIP,离线安装) |
| Go Server SDK | module agentbase-go-sdk(模块源码 ZIP,replace 消费) |
| Go Console SDK | module agentbase-console-go-sdk(模块源码 ZIP,replace 消费) |
| Java SDK 兼容性 | Java 11 source/target(classfile major 55),OpenJDK 11 / 17 可运行 |
六个非 npm ZIP 制品(Java / Python / Go 各 Server + Console)托管在 release <https://code.alipay.com/obai/agentbase-sdks/releases/v2.12.0>(含外层 SHA256SUMS)。Java / Python / Go 的 Release 流程只构建和验证制品,不发布到 Maven registry、PyPI 或公共 Go module proxy;Python 运行要求 Python 3.9+(依赖 requests 与 pydantic>=2,<3),Go 要求 go 1.22.5+(SDK 零第三方依赖)。
路径一:npm 远程 registry 安装(Web / Node / Console)
三个 JS 包从远程 npm registry 安装,统一精确钉版本,不使用浮动范围(^、~)或替代包名:
npm install agentbase-web-sdk@2.12.0 --save-exact # 浏览器前端(用户 Session)
npm install agentbase-node-sdk@2.12.0 --save-exact # Node.js 后端 / 管理脚本(API Key)
npm install agentbase-console-sdk@2.12.0 --save-exact # Console 管理面自动化(Console Session / JWT)各包的初始化差异与功能面映射见 client-sdk/web.md、server-sdk/nodejs.md、console-sdk/nodejs.md 与各功能点文档的「SDK 类别差异」小节。
import { Client, Account } from 'agentbase-web-sdk';
const client = new Client()
.setEndpoint('https://<host>/v1')
.setProject('<PROJECT_ID>');
const account = new Account(client);各包的初始化差异与功能面映射见 server-sdk/nodejs.md、console-sdk/nodejs.md 与各功能点文档的「SDK 类别差异」小节;Java / Python / Go 的安装见下文与各语言页。
内部 npm 使用相同精确版本,发布目标为 https://registry.anpm.alibaba-inc.com(以发布脚本实际配置为准):
npm install @alipay/agentbase-web-sdk@2.12.0 --save-exact --registry=https://registry.anpm.alibaba-inc.com
npm install @alipay/agentbase-node-sdk@2.12.0 --save-exact --registry=https://registry.anpm.alibaba-inc.com
npm install @alipay/agentbase-console-sdk@2.12.0 --save-exact --registry=https://registry.anpm.alibaba-inc.com公开与内部六坐标均经 registry 回读,release-2.12.0 标签指向 2.12.0;发布清单及 digest 见仓库 automation/release-evidence/2.12.0.json。安装仍钉精确版本,不依赖可移动的标签解析。
路径二:非 npm 制品安装(Java / Python / Go ZIP 下载与校验)
v2.12.0 Release 提供六个 ZIP 制品加外层 SHA256SUMS:
| 制品 | 内容 |
|---|---|
agentbase-java-sdk-2.12.0.zip | Java Server:JAR + POM + 运行时依赖(lib/)+ 内层 SHA256SUMS |
agentbase-console-java-sdk-2.12.0.zip | Java Console:同上 |
agentbase-python-sdk-2.12.0.zip | Python Server:sdist + wheel + 内层 SHA256SUMS |
agentbase-console-python-sdk-2.12.0.zip | Python Console:同上 |
agentbase-go-sdk-2.12.0.zip | Go Server:模块源码树 + 内层 SHA256SUMS |
agentbase-console-go-sdk-2.12.0.zip | Go Console:同上 |
Java ZIP 是「JAR + POM + 运行时依赖(lib/)+ 双层 SHA-256 校验」的外层分发容器。Console SDK 源码和自身 JAR 是纯 Java;HTTP transport 使用 OkHttp 5,运行时依赖包含 Kotlin 标准库,直接使用 JAR 时必须连同 lib/ 依赖一起分发。
1. 下载与双层校验
BUNDLE_DIR="$(mktemp -d)"
BASE_URL="https://code.alipay.com/obai/agentbase-sdks/releases/download/v2.12.0"
# 按需下载六个 ZIP(下例为 Java 两个)
curl -fsSL -o "$BUNDLE_DIR/agentbase-java-sdk-2.12.0.zip" "$BASE_URL/agentbase-java-sdk-2.12.0.zip"
curl -fsSL -o "$BUNDLE_DIR/agentbase-console-java-sdk-2.12.0.zip" "$BASE_URL/agentbase-console-java-sdk-2.12.0.zip"
# 校验文件(外层)
curl -fsSL -o "$BUNDLE_DIR/SHA256SUMS" "$BASE_URL/SHA256SUMS"
(cd "$BUNDLE_DIR" && sha256sum -c --ignore-missing SHA256SUMS) # 外层校验
unzip "$BUNDLE_DIR/agentbase-java-sdk-2.12.0.zip" -d "$BUNDLE_DIR"
unzip "$BUNDLE_DIR/agentbase-console-java-sdk-2.12.0.zip" -d "$BUNDLE_DIR"
(cd "$BUNDLE_DIR/agentbase-java-sdk-2.12.0" && sha256sum -c SHA256SUMS) # 内层校验
(cd "$BUNDLE_DIR/agentbase-console-java-sdk-2.12.0" && sha256sum -c SHA256SUMS)Python / Go 的下载与校验同构(换成对应 ZIP 名),安装方式见 examples/python.md 与 examples/go.md。
2. Java:安装到本地 Maven 仓库(长期维护的项目优先)
mvn install:install-file \
-Dfile="$BUNDLE_DIR/agentbase-java-sdk-2.12.0/agentbase-java-sdk-2.12.0.jar" \
-DpomFile="$BUNDLE_DIR/agentbase-java-sdk-2.12.0/agentbase-java-sdk-2.12.0.pom"
mvn install:install-file \
-Dfile="$BUNDLE_DIR/agentbase-console-java-sdk-2.12.0/agentbase-console-java-sdk-2.12.0.jar" \
-DpomFile="$BUNDLE_DIR/agentbase-console-java-sdk-2.12.0/agentbase-console-java-sdk-2.12.0.pom"应用中声明依赖(两个 Client 同名但 namespace 独立:io.agentbase.Client 与 io.agentbase.console.Client,同一 Java 文件只 import 一个,另一个用全限定类名):
<dependency>
<groupId>io.agentbase</groupId>
<artifactId>agentbase-java-sdk</artifactId>
<version>2.12.0</version>
</dependency>3. Java:直接使用 SDK JAR(受控脚本 / 离线环境)
mkdir -p /path/to/tool/lib
cp "$BUNDLE_DIR/agentbase-java-sdk-2.12.0/agentbase-java-sdk-2.12.0.jar" /path/to/tool/lib/
cp "$BUNDLE_DIR/agentbase-java-sdk-2.12.0/lib/"*.jar /path/to/tool/lib/
javac --release 11 -cp "lib/*" -d out src/main/java/Tool.java
java -cp "out:lib/*" Tool # Windows classpath 分隔符用 ;以解压目录内 lib/ 的实际内容为准;升级制品后不要复用旧依赖清单。直接 JAR 不会管理传递依赖与冲突,长期运行的服务优先 Maven。
安装后核对清单
[ ] 各包坐标逐字符核对精确版本;包管理器锁文件中出现的是精确版本号与新包名(
agentbase-*)。[ ] 每个 ZIP 外层、内层各执行一次
sha256sum -c;任一层失败停止安装。[ ] endpoint 与项目 ID 指向同一环境(托管 SIT / 正式或自托管实例),见 environment.md。
[ ] 与
skills/ob-agentbase/references/各安装页核对:同一坐标、同一 URL、同一校验形态。