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 |
|
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 :
Appelez l'opération Créer une instance AgentStorage dans la région cible.
Utilisez l'opération Lister les instances AgentStorage pour interroger l'état.
Attendez que
AgentStorageStatuspasse ànormal.Récupérez l'endpoint de l'instance et, dans le SDK, définissez le nom AgentStorage sur le nom de l'instance.
Console
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.
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.
-
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.
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.
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
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.
Dans la colonne Actions de la ligne contenant l'instance cible, cliquez sur More puis sur Delete.
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.
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,taobaoniadmin.