AgentStorage 实例

控制台

1. 登录 AgentStorage 控制台，在顶部地域下拉框中选择目标地域。当前支持华北 2（北京）、华东 1（杭州）、华东 2（上海）、华南 1（深圳）、中国香港和新加坡，资源不跨地域显示。

2. 在左侧导航栏单击 AgentStorage 管理，然后在页面右上角单击 创建 AgentStorage。

3. 在新建 AgentStorage 对话框中填写以下参数，然后单击确定。

   参数	说明
   名称	必填。长度为 3～16 个字符，以英文字母开头，只能包含英文字母、数字和短划线，末尾不能是短划线；同一地域内名称不能重复。
   描述	可选。说明该实例的业务场景，最多 128 个字符。
   资源组	可选。用于统一管理资源和权限。

4. 创建后实例显示在 AgentStorage 管理 列表中。等待状态列变为可用，即表示实例已就绪。

5. 单击实例名称或操作列的详情，查看并复制实例的访问地址（Endpoint），用于在 SDK 和数据面 API 中定位实例；单击操作列的进入 AgentStorage，可进入实例管理知识库和记忆库。

SDK

实例管理属于管控面 OpenAPI（Tablestore/2020-12-09），使用 AccessKey 签名。以下示例使用 Python 管控面 SDK alibabacloud_tablestore20201209 创建实例并等待其就绪。

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

# 使用管控面 AccessKey 初始化客户端，endpoint 由 region_id 自动解析（如 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. 创建 AgentStorage 实例
client.create_agent_storage(
    tablestore_models.CreateAgentStorageRequest(
        agent_storage_name="agent-prod",
        agent_storage_description="AI Agent 的知识与记忆存储",
    )
)

# 2. 轮询实例状态，直到 AgentStorageStatus 变为 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 已就绪，可创建知识库和记忆库")

控制台

1. 登录 AgentStorage 控制台，在顶部选择实例所在地域，然后在左侧导航栏单击 AgentStorage 管理。

2. 在目标实例所在行的操作列，单击更多，然后单击删除。

3. 在确认删除 AgentStorage 对话框中核对实例名称，确认无误后单击确认删除。删除操作不可恢复。

SDK

删除同样通过管控面 SDK alibabacloud_tablestore20201209 调用 DeleteAgentStorage。

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)

# 删除 AgentStorage 实例；删除后实例内的表、表数据和相关索引不可恢复
client.delete_agent_storage(
    tablestore_models.DeleteAgentStorageRequest(agent_storage_name="agent-test")
)