Tablestore Agent Storage SDK 面向 AI Agent 存储场景，统一封装记忆库、文件记忆和知识库接口，提供 Python 与 TypeScript 版本，并支持通过 API Key 简化服务接口认证。各语言的认证与使用示例见 Python与 TypeScript。
与 Tablestore SDK 的区别
Agent Storage SDK 是 Tablestore SDK 之外的独立 SDK，专注于 Agent 存储场景。两者主要差异如下。
维度 | Tablestore SDK | Agent Storage SDK |
包名 | Python： | Python： |
客户端类 |
|
|
覆盖能力 | 表格存储全量接口，含记忆库接口 | Agent 存储服务接口（记忆库、文件记忆和知识库） |
认证方式 | AccessKey（AK/SK） | API Key 或 AccessKey（AK/SK） |
安装和配置
前提条件
已开通表格存储服务并创建实例，获取实例的 HTTPS Endpoint 与实例名。
若使用 API Key 认证：已在目标实例上创建 API Key，并为 API Key 绑定的 RAM 子账号授予
ots:CallWithBearerToken权限。API Key 的接口权限继承该子账号的 RAM 策略。若使用知识库能力：已开通阿里云对象存储 OSS 并创建 Bucket，用于存储原始文档。上传文档时 SDK 需要 OSS 访问凭证（AccessKey），初始化客户端时需额外传入
oss_endpoint和oss_bucket参数。
认证方式
Agent Storage SDK 支持两种认证方式，对比如下。
认证方式 | 适用场景 | 支持接口 | 传输要求 |
AccessKey（AK/SK） | 全功能访问，含表格管理与数据操作 | 表格存储全部接口 | HTTP / HTTPS |
API Key | AI 场景轻量接入，免管理 AccessKey ID/Secret | Agent 存储服务接口 | 强制 HTTPS |
API Key 的创建与授权流程详见 API Key 管理。
初始化客户端
推荐使用 API Key 认证；如需知识库上传或其他表格存储接口，需同时提供 AccessKey 与 OSS 配置。各语言的初始化代码与完整使用示例见 Python与 TypeScript。