Tous les produits
Search
Centre de documentation

Tablestore:AgentStorage instances

Dernière mise à jour :Sep 25, 2026

Une instance AgentStorage est un conteneur de ressources au niveau de l'instance destiné au stockage des connaissances et à la gestion de la mémoire. Avant de créer une base de connaissances ou un magasin de mémoire, vous devez d'abord créer une instance AgentStorage dans la région cible. Par la suite, les SDK et les API du plan de données utilisent le nom de l'instance et son endpoint HTTPS pour localiser les ressources.

Hiérarchie des ressources

Alibaba Cloud account
└── Region
    └── AgentStorage instance
        ├── Knowledge base
        │   ├── Documents
        │   └── Chunks and indexes
        └── Memory store
            ├── Long-term memory, short-term messages, and tasks
            ├── Files, file versions, and Dreams
            └── Agent Wiki (knowledge graph) and pages

Les noms des bases de connaissances et des magasins de mémoire sont gérés au sein de l'instance AgentStorage qui les possède. L'instance détermine la région, le point d'accès, la limite réseau et les politiques de contrôle d'accès au niveau de l'instance utilisées par ces ressources.

Plan de gestion et plan de données

Plan

Objets gérés

Point d'accès

Authentification

Plan de gestion

Instances AgentStorage, liaisons VPC et politiques de contrôle d'accès au niveau de l'instance

Tablestore/2020-12-09 OpenAPI

Signature AccessKey

Plan de données

Bases de connaissances, magasins de mémoire et leurs sous-ressources

Endpoint HTTPS AgentStorage

Clé API ou AccessKey

Les champs du plan de gestion utilisent la casse Pascal, par exemple AgentStorageName. Le plan de données pour les connaissances et la mémoire utilise principalement la casse camel, par exemple knowledgeBaseName et memoryStoreName.

Créer une instance

Lors de la création d'une instance, vous devez spécifier au minimum AgentStorageName. Vous pouvez également indiquer une description, un groupe de ressources, des tags, les types de réseaux autorisés et des politiques de contrôle d'accès.

Procédure recommandée :

  1. Appelez l'opération Créer une instance AgentStorage dans la région cible.

  2. Utilisez l'opération Lister les instances AgentStorage pour interroger l'état.

  3. Attendez que AgentStorageStatus passe à normal.

  4. Récupérez l'endpoint de l'instance et, dans le SDK, définissez le nom AgentStorage sur le nom de l'instance.

Console

  1. Connectez-vous à la console AgentStorage et sélectionnez la région cible dans la liste déroulante en haut de la page. Les régions Chine (Pékin), Chine (Hangzhou), Chine (Shanghai), Chine (Shenzhen), Chine (Hong Kong) et Singapour sont actuellement prises en charge. Les ressources ne s'affichent pas entre les différentes régions.

  2. Dans le volet de navigation de gauche, cliquez sur AgentStorage Management. Ensuite, dans le coin supérieur droit de la page, cliquez sur Create AgentStorage.

  3. Dans la boîte de dialogue Create AgentStorage, configurez les paramètres suivants et cliquez sur OK.

    Paramètre

    Description

    Nom

    Obligatoire. Le nom doit comporter entre 3 et 16 caractères et commencer par une lettre. Il ne peut contenir que des lettres, des chiffres et des traits d'union, et ne doit pas se terminer par un trait d'union. Le nom doit être unique au sein de la même région.

    Description

    Facultatif. Décrit le scénario métier de l'instance. La longueur maximale est de 128 caractères.

    Groupe de ressources

    Facultatif. Permet de gérer les ressources et les permissions de manière centralisée.

  4. Une fois l'instance créée, elle apparaît dans la liste AgentStorage Management. Lorsque la colonne Status indique Available, l'instance est prête.

  5. Cliquez sur le nom de l'instance ou sur Details dans la colonne Actions pour afficher et copier l'endpoint de l'instance, utilisé pour localiser l'instance dans les SDK et les API du plan de données. Cliquez sur Enter AgentStorage dans la colonne Actions pour accéder à l'instance et gérer les bases de connaissances et les magasins de mémoire.

SDK

La gestion des instances relève de l'OpenAPI du plan de gestion (Tablestore/2020-12-09) et utilise l'authentification par signature AccessKey. L'exemple suivant utilise le SDK Python du plan de gestion alibabacloud_tablestore20201209 pour créer une instance et attendre qu'elle soit prête.

import os
import time

from alibabacloud_tablestore20201209.client import Client
from alibabacloud_tablestore20201209 import models as tablestore_models
from alibabacloud_tea_openapi import models as open_api_models

# Initialize the client with a management plane AccessKey. The endpoint is automatically resolved from region_id (for example, tablestore.cn-hangzhou.aliyuncs.com).
config = open_api_models.Config(
    access_key_id=os.environ["ALIBABA_CLOUD_ACCESS_KEY_ID"],
    access_key_secret=os.environ["ALIBABA_CLOUD_ACCESS_KEY_SECRET"],
    region_id="cn-hangzhou",
)
client = Client(config)

# 1. Create an AgentStorage instance
client.create_agent_storage(
    tablestore_models.CreateAgentStorageRequest(
        agent_storage_name="agent-prod",
        agent_storage_description="Knowledge and memory storage for AI agents",
    )
)

# 2. Poll the instance status until AgentStorageStatus changes to normal
get_request = tablestore_models.GetAgentStorageRequest(agent_storage_name="agent-prod")
while client.get_agent_storage(get_request).body.agent_storage_status != "normal":
    time.sleep(2)

print("AgentStorage is ready. You can now create knowledge bases and memory stores.")

Supprimer une instance

Console

  1. Connectez-vous à la console AgentStorage, sélectionnez la région de l'instance en haut de la page, puis cliquez sur AgentStorage Management dans le volet de navigation de gauche.

  2. Dans la colonne Actions de la ligne contenant l'instance cible, cliquez sur More puis sur Delete.

  3. Dans la boîte de dialogue Delete AgentStorage, vérifiez le nom de l'instance, puis cliquez sur Confirm Delete. La suppression est irréversible.

SDK

Pour supprimer l'instance, appelez également DeleteAgentStorage via le SDK du plan de gestion alibabacloud_tablestore20201209.

import os

from alibabacloud_tablestore20201209.client import Client
from alibabacloud_tablestore20201209 import models as tablestore_models
from alibabacloud_tea_openapi import models as open_api_models

config = open_api_models.Config(
    access_key_id=os.environ["ALIBABA_CLOUD_ACCESS_KEY_ID"],
    access_key_secret=os.environ["ALIBABA_CLOUD_ACCESS_KEY_SECRET"],
    region_id="cn-hangzhou",
)
client = Client(config)

# Delete the AgentStorage instance. After deletion, the tables, table data, and related indexes in the instance cannot be recovered.
client.delete_agent_storage(
    tablestore_models.DeleteAgentStorageRequest(agent_storage_name="agent-test")
)
  • Arrêtez l'écriture de données dans les bases de connaissances et les magasins de mémoire de l'instance.

  • Assurez-vous que les applications dépendant de l'endpoint, de la clé API et de l'adresse VPC de l'instance ont été migrées.

  • Exportez ou sauvegardez toutes les données que vous souhaitez conserver.

  • Ne créez pas immédiatement une instance AgentStorage portant le même nom après la suppression, afin d'éviter les conflits avec le processus de libération en arrière-plan.

Important

La suppression est irréversible et rend les tables, les données des tables et les index associés de l'instance indisponibles.

Limites

  • Un seul compte Alibaba Cloud peut créer jusqu'à 10 instances AgentStorage.

  • Le nom d'une instance AgentStorage doit être unique dans sa région et comporter entre 3 et 16 caractères.

  • Le nom doit commencer par une lettre et ne peut contenir que des lettres, des chiffres et des traits d'union. Il ne doit pas se terminer par un trait d'union.

  • Le nom n'est pas sensible à la casse et ne doit pas contenir ali, ay, ots, taobao ni admin.