すべてのプロダクト
Search
ドキュメントセンター

Tablestore:AgentStorage インスタンス

最終更新日:Oct 22, 2026

AgentStorage インスタンスは、ナレッジストレージとメモリストレージのリソースコンテナです。ナレッジベースまたはメモリストアを作成する前に、ターゲットリージョンに AgentStorage インスタンスを作成する必要があります。SDK とデータプレーン API は、インスタンス名と HTTPS エンドポイントを使用してリソースを特定します。

リソース階層

Alibaba Cloud アカウント
└── リージョン
    └── AgentStorage インスタンス
        ├── ナレッジベース
        │   ├── ドキュメント
        │   └── チャンクとインデックス
        └── メモリストア
            ├── 長期記憶、短期メッセージ、タスク
            ├── ファイル、ファイルバージョン、Dream
            └── Agent Wiki (知識グラフ) とページ

ナレッジベースとメモリストアの名前は、それぞれの AgentStorage インスタンス内で管理されます。インスタンスは、これらのリソースに適用されるリージョン、アクセスエントリ、ネットワーク境界、およびインスタンスレベルのアクセス制御ポリシーを決定します。

管理プレーンとデータプレーン

次の表で、AgentStorage の管理プレーンとデータプレーンを比較します。

プレーン管理対象オブジェクトアクセスエントリ認証
管理プレーンAgentStorage インスタンス、VPC バインディング、インスタンスレベルのアクセス制御ポリシーTablestore/2020-12-09 OpenAPIAccessKey 署名
データプレーンナレッジベース、メモリストア、およびそのサブリソースAgentStorage HTTPS エンドポイントAPI キーまたは AccessKey

管理プレーンのフィールドは、AgentStorageName のようにパスカルケースを使用します。データプレーンのナレッジおよびメモリリソースのフィールドは、主に knowledgeBaseName や memoryStoreName のようにキャメルケースを使用します。

制限

AgentStorage インスタンスを作成する前に、次の制限にご注意ください。

  • インスタンスクォータ — Alibaba Cloud アカウントごとに最大 10 個の AgentStorage インスタンスを作成できます。

  • 命名規則 — インスタンス名はリージョン内で一意であり、3~16 文字である必要があります。名前は英字で始まり、英字、数字、ハイフンのみを含み、ハイフンで終わることはできません。名前は大文字と小文字を区別せず、ali、ay、ots、taobao、admin を含めることはできません。

  • サポート対象リージョン — AgentStorage は、中国 (北京)、中国 (杭州)、中国 (上海)、中国 (深圳)、中国 (香港)、およびシンガポールのリージョンで利用可能です。

インスタンスの作成

AgentStorage インスタンスを作成する際には、少なくともインスタンス名 (AgentStorageName) を指定する必要があります。説明、リソースグループ、タグ、許可されるネットワークタイプ、およびアクセス制御ポリシーも指定できます。このセクションのコンソール手順では、インスタンス名、説明、およびリソースグループについて説明します。

コンソールまたは SDK のどちらを使用する場合でも、ワークフローは同じです。

  1. ターゲットリージョンにインスタンスを作成します。

  2. インスタンスの準備が完了するまで待ちます。

  3. インスタンスのエンドポイントを取得します。

  4. SDK およびデータプレーン API でリソースを特定するには、AgentStorage 名をインスタンス名としてインスタンスのエンドポイントとともに使用します。

コンソール

  1. AgentStorage コンソールにログインし、ページ上部のリージョンドロップダウンリストからターゲットリージョンを選択します。コンソールには、選択したリージョンのリソースのみが表示されます。

  2. 左側メニューで [AgentStorage Management] をクリックし、ページの右上隅にある [Create AgentStorage] をクリックします。

  3. [Create AgentStorage] ダイアログボックスで、次のパラメーターを設定し、[OK] をクリックします。

    パラメーター説明
    名前必須。命名規則については、「制限」をご参照ください。
    説明任意。インスタンスのビジネスシナリオを 128 文字以内で記述します。
    リソースグループ任意。この設定を使用して、リソースと権限を一元的に管理します。
  4. インスタンスが作成されると、[AgentStorage Management] リストに表示されます。[ステータス] 列が [利用可能] になると、インスタンスは利用可能になります。管理プレーン API は、この状態を normal として返します。

  5. インスタンス名または [操作] 列の [詳細] をクリックしてインスタンスのエンドポイントを表示し、コピーします。SDK とデータプレーン API は、エンドポイントを使用してインスタンスを特定します。インスタンス内のナレッジベースとメモリストアを管理するには、[操作] 列の [Enter AgentStorage] をクリックします。

SDK

インスタンス管理は、管理プレーン OpenAPI (Tablestore/2020-12-09) に属し、AccessKey 署名を使用します。 次の例では、Python 管理プレーン SDK alibabacloud_tablestore20201209 を使用します。 SDK は CreateAgentStorage 操作を呼び出してターゲットリージョンにインスタンスを作成し、その後、AgentStorageStatus が normal になるまで GetAgentStorage 操作をポーリングします。 この例では、ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数から AccessKey ペアを読み取ります。 region_id の値を、ご使用のターゲットリージョンに置き換えてください。

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 を使用してクライアントを初期化します。エンドポイントは 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="Knowledge and memory storage for AI agents",
    )
)

# 2. AgentStorageStatus が正常になるまでインスタンスのステータスをポーリングします
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 の準備ができました。ナレッジベースとメモリストアを作成できます。")

インスタンスの削除

警告

AgentStorage インスタンスを削除すると元に戻すことはできず、インスタンス内のテーブル、テーブルデータ、および関連インデックスが利用できなくなります。

AgentStorage インスタンスを削除する前に、次の準備を完了してください。

  • インスタンス内のナレッジベースとメモリストアへのデータ書き込みを停止してください。

  • インスタンスのエンドポイント、API キー、VPC アドレスに依存するアプリケーションが移行されたことを確認してください。

  • 保持する必要のあるデータをエクスポートまたはバックアップしてください。

コンソール

  1. AgentStorage コンソールにログインし、ページ上部でインスタンスが配置されているリージョンを選択します。左側メニューで、[AgentStorage Management] をクリックします。

  2. 対象インスタンスの行の [操作] 列で [その他] をクリックし、次に 削除 をクリックします。

  3. [Delete AgentStorage] ダイアログボックスで、インスタンス名を確認し、[Confirm Delete] をクリックします。

SDK

管理プレーン SDK alibabacloud_tablestore20201209 の DeleteAgentStorage 操作を呼び出して、AgentStorage インスタンスを削除することもできます。

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

インスタンスを削除した後は、バックグラウンドの解放プロセスとの競合を避けるため、同じ名前の AgentStorage インスタンスをすぐに作成しないでください。