Le SDK Agent Storage de Tablestore est conçu pour les scénarios de stockage des agents d'IA. Il offre une interface unifiée pour la mémoire, la mémoire de fichiers et la base de connaissances, et est disponible en Python et TypeScript. Il prend également en charge l'authentification par API Key afin de simplifier l'authentification aux API du service. Pour des exemples d'authentification et d'utilisation dans chaque langage, consultez les rubriques Python et TypeScript.
Différences avec le SDK Tablestore
Le SDK Agent Storage est un SDK autonome, distinct du SDK Tablestore, dédié aux scénarios de stockage des agents. Le tableau suivant résume les principales différences entre les deux SDK.
|
Dimension |
SDK Tablestore |
SDK Agent Storage |
|
Nom du package |
Python : |
Python : |
|
Classe client |
|
|
|
Fonctionnalités |
Toutes les interfaces Tablestore, y compris les interfaces de mémoire |
Interfaces du service de stockage des agents (mémoire, mémoire de fichiers et base de connaissances) |
|
Authentification |
AccessKey (AK/SK) |
API Key ou AccessKey (AK/SK) |
Installation et configuration
Prérequis
Activez Tablestore et créez une instance. Récupérez le point de terminaison HTTPS et le nom de l'instance.
Si vous utilisez l'authentification par API Key : créez une API Key sur l'instance cible et assurez-vous que le sous-compte RAM associé dispose de l'autorisation
ots:CallWithBearerToken. L'API Key hérite des autorisations d'interface définies dans la stratégie RAM du sous-compte.Si vous utilisez les fonctionnalités de base de connaissances : activez Alibaba Cloud Object Storage Service (OSS) et créez un bucket pour stocker les documents originaux. Lors du téléchargement des documents, le SDK nécessite des identifiants d'accès OSS (AccessKey). Lors de l'initialisation du client, transmettez les paramètres
oss_endpointetoss_bucket.
Méthodes d'authentification
Le SDK Agent Storage prend en charge deux méthodes d'authentification, comparées ci-dessous.
|
Méthode d'authentification |
Scénario applicable |
Interfaces prises en charge |
Exigence de transport |
|
AccessKey (AK/SK) |
Accès complet aux fonctionnalités, incluant la gestion des tables et les opérations sur les données |
Toutes les interfaces Tablestore |
HTTP / HTTPS |
|
API Key |
Accès léger pour les scénarios d'IA, sans gestion de l'ID AccessKey ni du secret |
Interfaces du service de stockage des agents |
HTTPS requis |
Pour plus d'informations sur la création et l'autorisation d'une API Key, consultez la rubrique Gestion des API Key.
Initialiser le client
Nous vous recommandons d'utiliser l'authentification par API Key. Si vous devez télécharger des documents dans la base de connaissances ou utiliser d'autres interfaces Tablestore, fournissez également une AccessKey ainsi que la configuration OSS. Pour le code d'initialisation et des exemples d'utilisation complets dans chaque langage, consultez les rubriques Python et TypeScript.