AgentbaseDocs
文档目录

接入安装

本页面向 2.10.0 迭代,把 SDK 接入代码仓库的两条路径分开写——路径一:npm 远程 registry 安装(Web / Node / Console 三个 JS 包,钉 npm 当前发布面 2.10.0),路径二:非 npm 制品安装(Java / Python / Go 的 Server 与 Console ZIP 下载与校验,钉 release 终态 v2.10.0)。2.10.0 迭代线单次自 2.9.0 bump:npm 六个坐标(public agentbase-*-sdk 与内部 @alipay/agentbase-*-sdk)与 Java / Python / Go 的 ZIP 制品统一钉 release 终态 v2.10.0,npm 与 ZIP 钉值一致。所有版本一律写精确值,不使用浮动范围。

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.10.0 / ZIP v2.10.0,canonical)

项精确值
服务版本2.10.0(release-2.10.0 尖端 APP_VERSION_STABLE = 2.10.0,单次自 2.9.0 bump)
项目元数据库迁移V57(由服务版本决定,不能由 npm / Python 包版本推断)
Web SDK(npm)agentbase-web-sdk@2.10.0
Node Server SDK(npm)agentbase-node-sdk@2.10.0
Console SDK(npm,JS 管理面)agentbase-console-sdk@2.10.0
Java Server SDKio.agentbase:agentbase-java-sdk:2.10.0(ZIP 交付包,v2.10.0 release 终态)
Java Console SDKio.agentbase.console:agentbase-console-java-sdk:2.10.0(ZIP 交付包,同上)
Python Server SDKagentbase-python-sdk 2.10.0(wheel + sdist ZIP,离线安装)
Python Console SDKagentbase-console-python-sdk 2.10.0(wheel + sdist ZIP,离线安装)
Go Server SDKmodule agentbase-go-sdk(模块源码 ZIP,replace 消费)
Go Console SDKmodule 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.10.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.10.0 --save-exact       # 浏览器前端(用户 Session)
npm install agentbase-node-sdk@2.10.0 --save-exact      # Node.js 后端 / 管理脚本(API Key)
npm install agentbase-console-sdk@2.10.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.10.0 --save-exact --registry=https://registry.anpm.alibaba-inc.com
npm install @alipay/agentbase-node-sdk@2.10.0 --save-exact --registry=https://registry.anpm.alibaba-inc.com
npm install @alipay/agentbase-console-sdk@2.10.0 --save-exact --registry=https://registry.anpm.alibaba-inc.com

公开与内部六坐标均经 registry 回读,release-2.10.0 标签指向 2.10.0;发布清单及 digest 见仓库 automation/release-evidence/2.10.0.json。安装仍钉精确版本,不依赖可移动的标签解析。

路径二:非 npm 制品安装(Java / Python / Go ZIP 下载与校验)

v2.10.0 Release 提供六个 ZIP 制品加外层 SHA256SUMS:

制品内容
[agentbase-java-sdk-2.10.0.zip](https://code.alipay.com/obai/agentbase-sdks/releases/download/v2.10.0/agentbase-java-sdk-2.10.0.zip)Java Server:JAR + POM + 运行时依赖(lib/)+ 内层 SHA256SUMS
[agentbase-console-java-sdk-2.10.0.zip](https://code.alipay.com/obai/agentbase-sdks/releases/download/v2.10.0/agentbase-console-java-sdk-2.10.0.zip)Java Console:同上
[agentbase-python-sdk-2.10.0.zip](https://code.alipay.com/obai/agentbase-sdks/releases/download/v2.10.0/agentbase-python-sdk-2.10.0.zip)Python Server:sdist + wheel + 内层 SHA256SUMS
[agentbase-console-python-sdk-2.10.0.zip](https://code.alipay.com/obai/agentbase-sdks/releases/download/v2.10.0/agentbase-console-python-sdk-2.10.0.zip)Python Console:同上
[agentbase-go-sdk-2.10.0.zip](https://code.alipay.com/obai/agentbase-sdks/releases/download/v2.10.0/agentbase-go-sdk-2.10.0.zip)Go Server:模块源码树 + 内层 SHA256SUMS
[agentbase-console-go-sdk-2.10.0.zip](https://code.alipay.com/obai/agentbase-sdks/releases/download/v2.10.0/agentbase-console-go-sdk-2.10.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.10.0"

# 按需下载六个 ZIP(下例为 Java 两个)
curl -fsSL -o "$BUNDLE_DIR/agentbase-java-sdk-2.10.0.zip" "$BASE_URL/agentbase-java-sdk-2.10.0.zip"
curl -fsSL -o "$BUNDLE_DIR/agentbase-console-java-sdk-2.10.0.zip" "$BASE_URL/agentbase-console-java-sdk-2.10.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.10.0.zip" -d "$BUNDLE_DIR"
unzip "$BUNDLE_DIR/agentbase-console-java-sdk-2.10.0.zip" -d "$BUNDLE_DIR"
(cd "$BUNDLE_DIR/agentbase-java-sdk-2.10.0" && sha256sum -c SHA256SUMS)             # 内层校验
(cd "$BUNDLE_DIR/agentbase-console-java-sdk-2.10.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.10.0/agentbase-java-sdk-2.10.0.jar" \
  -DpomFile="$BUNDLE_DIR/agentbase-java-sdk-2.10.0/agentbase-java-sdk-2.10.0.pom"

mvn install:install-file \
  -Dfile="$BUNDLE_DIR/agentbase-console-java-sdk-2.10.0/agentbase-console-java-sdk-2.10.0.jar" \
  -DpomFile="$BUNDLE_DIR/agentbase-console-java-sdk-2.10.0/agentbase-console-java-sdk-2.10.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.10.0</version>
</dependency>

3. Java:直接使用 SDK JAR(受控脚本 / 离线环境)

mkdir -p /path/to/tool/lib
cp "$BUNDLE_DIR/agentbase-java-sdk-2.10.0/agentbase-java-sdk-2.10.0.jar" /path/to/tool/lib/
cp "$BUNDLE_DIR/agentbase-java-sdk-2.10.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。

安装后核对清单