功能简介
Agentbase 提供 Web、Android、Apple、Flutter、React Native 以及多种 Server SDK。不同语言和版本的发布节奏可能不同,安装前请在对应 Registry 核对包版本。
当前支持范围
- 多语言 SDK(PARTIAL):Agentbase 提供 Web、移动端和多种服务端语言的 SDK 与类型契约;具体包是否已发布须按语言和版本单独确认。
适用场景
- 按 Web、移动端或服务端运行环境选择 SDK。
- 核对方法签名、Model 与错误类型。
- 在 REST 已实现但目标 SDK 尚未生成时采用明确的 HTTP 过渡方案。
前置条件
- 先从 Registry/制品仓确认目标包与版本实际存在。
- 确认 SDK 的 response format 与服务端版本兼容。
- 客户端 SDK 不保存 API Key;服务端 SDK 才使用 Key。
Console 操作路径
Console 的集成或 Quick Start 页面可提供初始化信息,但安装命令必须以实际 Registry 为准。不要从 Console SDK 的存在推断终端应用包已经发布。
SDK 示例
SDK · TypeScript
import { Client } from 'agentbase-web-sdk';
const client = new Client()
.setEndpoint('https://<APPBASE_HOST>/v1')
.setProject('<PROJECT_ID>');
import { Account, TablesDB, Storage, Functions, Realtime } from 'agentbase-web-sdk';
const account = new Account(client);
const tables = new TablesDB(client);
const storage = new Storage(client);
const functions = new Functions(client);
const realtime = new Realtime(client);
void [account, tables, storage, functions, realtime];REST 示例
REST · Bash
# SDK 最终发送的请求仍是版本化 REST;下面仅用于确认服务端版本。
curl 'https://<APPBASE_HOST>/v1/health/version'常见错误
| 现象 | 处理建议 |
|---|---|
| Registry 找不到包 | 该语言或版本可能尚未发布;请在对应 Registry 核对可用版本。 |
| 方法或 Model 缺失 | 核对 SDK 与服务端版本,必要时使用当前版本支持的 REST API。 |
| response format 不兼容 | 升级 SDK 或选择与服务端匹配的版本。 |
当前限制
- 不承诺所有语言、所有新能力同步生成与发布。
- Console SDK 属于控制面,不应作为普通终端应用 SDK。
- 开发者 CLI 没有独立 Package/测试证据,不进入公开主导航。
Appwrite 兼容说明
SDK 分类和 Client/Server 区分保持兼容;包名、版本与实际导出以对应 Registry 的已发布制品为准。
Agentbase 增强说明
Agentbase SDK 增加 TablesDB、LLM Gateway、Memory、Organization 等实现,但发布状态必须逐包核对。