Tablestore:AgentStorage instances

Console

1. Log on to the AgentStorage console and select the target region from the region drop-down list at the top of the page. China (Beijing), China (Hangzhou), China (Shanghai), China (Shenzhen), China (Hong Kong), and Singapore are currently supported. Resources are not displayed across regions.

2. In the left-side navigation pane, click AgentStorage Management. Then, in the upper-right corner of the page, click Create AgentStorage.

3. In the Create AgentStorage dialog box, configure the following parameters and click OK.

   Parameter	Description
   Name	Required. The name must be 3 to 16 characters in length and must start with a letter. It can contain only letters, digits, and hyphens, and cannot end with a hyphen. The name must be unique within the same region.
   Description	Optional. Describes the business scenario of the instance. It can be up to 128 characters in length.
   Resource Group	Optional. Used to manage resources and permissions in a centralized manner.

4. After the instance is created, it appears in the AgentStorage Management list. When the Status column changes to Available, the instance is ready.

5. Click the instance name or click Details in the Actions column to view and copy the endpoint of the instance, which is used to locate the instance in SDKs and data plane APIs. Click Enter AgentStorage in the Actions column to enter the instance and manage knowledge bases and memory stores.

SDK

Instance management belongs to the management plane OpenAPI (Tablestore/2020-12-09) and uses AccessKey signature authentication. The following example uses the Python management plane SDK alibabacloud_tablestore20201209 to create an instance and wait until it is ready.

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.")

Console

1. Log on to the AgentStorage console, select the region of the instance at the top of the page, and then click AgentStorage Management in the left-side navigation pane.

2. In the Actions column of the row that contains the target instance, click More and then click Delete.

3. In the Delete AgentStorage dialog box, verify the instance name and then click Confirm Delete. The deletion cannot be undone.

SDK

Deletion is also performed by calling DeleteAgentStorage through the management plane SDK 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")
)