AgentStorage インスタンスは、ナレッジストレージとメモリストレージのリソースコンテナです。ナレッジベースまたはメモリストアを作成する前に、ターゲットリージョンに AgentStorage インスタンスを作成する必要があります。SDK とデータプレーン API は、インスタンス名と HTTPS エンドポイントを使用してリソースを特定します。
リソース階層
Alibaba Cloud アカウント
└── リージョン
└── AgentStorage インスタンス
├── ナレッジベース
│ ├── ドキュメント
│ └── チャンクとインデックス
└── メモリストア
├── 長期記憶、短期メッセージ、タスク
├── ファイル、ファイルバージョン、Dream
└── Agent Wiki (知識グラフ) とページナレッジベースとメモリストアの名前は、それぞれの AgentStorage インスタンス内で管理されます。インスタンスは、これらのリソースに適用されるリージョン、アクセスエントリ、ネットワーク境界、およびインスタンスレベルのアクセス制御ポリシーを決定します。
管理プレーンとデータプレーン
次の表で、AgentStorage の管理プレーンとデータプレーンを比較します。
| プレーン | 管理対象オブジェクト | アクセスエントリ | 認証 |
| 管理プレーン | AgentStorage インスタンス、VPC バインディング、インスタンスレベルのアクセス制御ポリシー | Tablestore/2020-12-09 OpenAPI | AccessKey 署名 |
| データプレーン | ナレッジベース、メモリストア、およびそのサブリソース | AgentStorage HTTPS エンドポイント | API キーまたは AccessKey |
管理プレーンのフィールドは、AgentStorageName のようにパスカルケースを使用します。データプレーンのナレッジおよびメモリリソースのフィールドは、主に knowledgeBaseName や memoryStoreName のようにキャメルケースを使用します。
制限
AgentStorage インスタンスを作成する前に、次の制限にご注意ください。
インスタンスクォータ — Alibaba Cloud アカウントごとに最大 10 個の AgentStorage インスタンスを作成できます。
命名規則 — インスタンス名はリージョン内で一意であり、3~16 文字である必要があります。名前は英字で始まり、英字、数字、ハイフンのみを含み、ハイフンで終わることはできません。名前は大文字と小文字を区別せず、
ali、ay、ots、taobao、adminを含めることはできません。サポート対象リージョン — AgentStorage は、中国 (北京)、中国 (杭州)、中国 (上海)、中国 (深圳)、中国 (香港)、およびシンガポールのリージョンで利用可能です。
インスタンスの作成
AgentStorage インスタンスを作成する際には、少なくともインスタンス名 (AgentStorageName) を指定する必要があります。説明、リソースグループ、タグ、許可されるネットワークタイプ、およびアクセス制御ポリシーも指定できます。このセクションのコンソール手順では、インスタンス名、説明、およびリソースグループについて説明します。
コンソールまたは SDK のどちらを使用する場合でも、ワークフローは同じです。
ターゲットリージョンにインスタンスを作成します。
インスタンスの準備が完了するまで待ちます。
インスタンスのエンドポイントを取得します。
SDK およびデータプレーン API でリソースを特定するには、AgentStorage 名をインスタンス名としてインスタンスのエンドポイントとともに使用します。
コンソール
AgentStorage コンソールにログインし、ページ上部のリージョンドロップダウンリストからターゲットリージョンを選択します。コンソールには、選択したリージョンのリソースのみが表示されます。
左側メニューで [AgentStorage Management] をクリックし、ページの右上隅にある [Create AgentStorage] をクリックします。
[Create AgentStorage] ダイアログボックスで、次のパラメーターを設定し、[OK] をクリックします。
パラメーター 説明 名前 必須。命名規則については、「制限」をご参照ください。 説明 任意。インスタンスのビジネスシナリオを 128 文字以内で記述します。 リソースグループ 任意。この設定を使用して、リソースと権限を一元的に管理します。 インスタンスが作成されると、[AgentStorage Management] リストに表示されます。[ステータス] 列が [利用可能] になると、インスタンスは利用可能になります。管理プレーン API は、この状態を
normalとして返します。インスタンス名または [操作] 列の [詳細] をクリックしてインスタンスのエンドポイントを表示し、コピーします。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 アドレスに依存するアプリケーションが移行されたことを確認してください。
保持する必要のあるデータをエクスポートまたはバックアップしてください。
コンソール
AgentStorage コンソールにログインし、ページ上部でインスタンスが配置されているリージョンを選択します。左側メニューで、[AgentStorage Management] をクリックします。
対象インスタンスの行の [操作] 列で [その他] をクリックし、次に 削除 をクリックします。
[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 インスタンスをすぐに作成しないでください。