メモリ機能の使用

メモリ機能は、インテリジェントなアプリケーションに永続的なパーソナライズドメモリ機能を提供します。メモリスペースを作成および管理することで、対話中のユーザーの嗜好や履歴コンテキストなどの情報を蓄積し、後のインタラクションでインテリジェント検索を通じて迅速に呼び出すことができます。これにより、アプリケーションの回答精度と連続性が向上します。メモリ機能は現在無料ですが、2026年下半期に正式に有料化される予定です。

機能の概要

AIメモリ機能は、スマートアプリケーションに永続的なパーソナライズドメモリ機能を提供します。対話中のユーザーの嗜好、行動習慣、履歴コンテキストなどの情報を構造化されたメモリとして蓄積し、アプリケーションは後続のインタラクションでセマンティック検索を活用して関連情報を迅速に呼び出すことができます。これにより、より正確で連続性のあるパーソナライズドレスポンスを実現します。

メモリ機能は、**メモリスペース（Memory Space）**を基本管理単位としています。各メモリスペースにはグローバルで一意の Space ID が付与され、データは互いに完全に隔離されています。異なるビジネスシナリオ、異なるユーザーグループ、または異なるアプリケーションごとに独立したメモリスペースを作成することで、メモリデータの相互干渉を防ぐことができます。アプリケーションを統合する際には、対象のメモリスペースのSpace IDを指定するだけで、そのスペースに対話メッセージを書き込んだり、蓄積されたメモリを検索したりできます。

AIサービスの メモリ ページでは、以下の操作を実行できます：

• メモリスペースを作成：異なるビジネスシナリオやユーザーグループごとに独立したメモリコンテナを作成します。

• メモリスペースの管理：既存のメモリスペースの表示、編集、削除を行い、各スペースの作成日時と識別子を確認します。

• メモリデータの表示：指定したメモリスペースに移動し、蓄積されたパーソナライズドメモリの内容を確認します。

• アプリケーションへの統合：連携サンプル からAPI Key設定、メモリスペースの接続、およびセマンティック検索のサンプルコードを入手します。

• 使用状況モニタリング：メモリ機能または指定したメモリスペースのリソース消費状況を確認します。

前提条件

• AIサービスページにアクセスし、サービスを有効にしていること。

• 利用可能なAPI Keyを作成していること。詳細な操作については、AI API Keyの管理をご参照ください。

メモリページへのアクセス

1. OceanBase Cloudコンソールにログインします。

2. 左側のナビゲーションペインで AIサービス をクリックし、AIサービスページに移動します。

3. AIサービスの左側メニューで、メモリ をクリックし、メモリスペースのリストページに移動します。

メモリスペースの作成

1. メモリページの右上隅にある メモリスペースを作成 をクリックします。

2. 表示された メモリスペースを作成 ダイアログボックスで、以下の情報を入力します：

   フィールド	必須	説明
   名前	はい	メモリスペースの表示名。最大128文字。
   説明	いいえ	このスペースの用途を説明するために使用します。最大512文字。

3. OK をクリックして作成を完了します。新しく作成されたメモリスペースは、リスト内にカード形式で表示されます。

メモリスペースの管理

メモリスペース一覧の表示

メモリスペースページは、すべてのメモリスペースをカードグリッドで表示します。各カードには以下が含まれます：

• 名称：メモリスペースの名前です。

• 説明：作成時に入力した説明情報（該当する場合）。

• スペースID：一意の識別子です。

• 作成日時：そのメモリスペースの作成日時です。

連携サンプルの表示

メモリスペースカードの ··· メニューで、連携サンプル を選択すると、そのメモリスペースのアクセス例を確認できます。

使用量モニタリングの表示

メモリスペースカードの ··· メニューで、使用量モニタリング を選択すると、そのメモリスペースのリソース消費状況を確認できます。

メモリスペースの編集

1. 対象のメモリスペースカードの右上隅にある ··· をクリックします。

2. 編集 を選択します。

3. ポップアップウィンドウで名前または説明を変更し、OK をクリックして保存します。

メモリスペースの削除

1. 対象のメモリスペースカードの右上隅にある ··· をクリックします。

2. 削除 を選択します。

3. ページの指示に従って削除操作を完了します。

メモリスペースの詳細表示

1. メモリスペース一覧で、対象のメモリスペースカードをクリックし、メモリスペース の詳細ページに移動します。

2. ページの左上隅にある メモリスペース ドロップダウンから、表示するスペースを切り替えます。

3. メモリ タブで、現在のスペースに蓄積されたメモリデータを確認します。

詳細ページの右上には、以下の操作が用意されています：

• 使用状況を確認：現在のメモリスペースの使用量情報を確認します。

• リフレッシュ：現在のページのメモリデータリストを更新します。

• 連携サンプル：連携サンプルパネルを開き、連携用のサンプルコードを取得します。

連携サンプル

ページの 連携サンプル ボタン（リストページの右上、詳細ページ、またはカードメニュー内）をクリックして連携サンプルパネルを開き、以下の手順に従ってアプリケーションにメモリ機能を統合します。

APIキーの取得

1. ステップ1：APIキーを取得する エリアで、呼び出し用のAPIキーをドロップダウンリストから選択します。

2. リストがマスク形式で表示されている場合は、AI APIキーの管理 ページに移動し、作成時に保存した完全なキーを取得し、以下のコマンドのプレースホルダーを完全なAPIキーに置き換えます。

    API_KEY="sk_ba2cc287-******8b86c" 
   

メモリスペースの統合

1. ステップ2：メモリスペースを統合する エリアで、アプリケーションに統合するメモリスペースをドロップダウンリストから選択します。

2. ページに表示された Space ID（例：1dbbd82b553a4299a2e60e84c9837631）を記録し、コード内の {sid} をこの値に置き換えます。

3. ページで提供されているPythonサンプルを参考に、クライアントを初期化し、メッセージを書き込みます：

   #!/usr/bin/env python3
   # -*- coding: utf-8 -*-
   """
   OBCloud Memory · 記憶への書き込み
   POST /spaces/{spaceId}/memories
   """
   
   import json
   import urllib.request
   
   # ====== 設定 ======
   # APIキーを取得し、以下に入力します。
   API_KEY    = "sk_xxxxxx"
   
   # ページの左上にある組織名をクリックし、プロジェクトリストから現在のプロジェクトIDをコピーします。
   PROJECT_ID = "xxxxxxx"
   
   # スペースの左下にある「完全なスペースIDをコピー」をクリックしてSPACE_IDを取得します。
   SPACE_ID   = "xxxxxc"
   
   BASE_URL   = "https://ai-api-g.oceanbase.com/api/v1/memory"
   # ==================
   
   body = {
       "content": "ユーザーの張三は北京に住んでおり、バスケットボールが好きで、コーヒーはラテが好みです",
       "metadata": {"userId": "user_001", "category": "personal_info"},
   }
   
   req = urllib.request.Request(
       f"{BASE_URL}/spaces/{SPACE_ID}/memories",
       data=json.dumps(body, ensure_ascii=False).encode("utf-8"),
       method="POST",
       headers={
           "Authorization": f"Bearer {API_KEY}",
           "X-OB-Project-ID": PROJECT_ID,
           "Content-Type": "application/json",
       },
   )
   
   with urllib.request.urlopen(req, timeout=30) as resp:
       print(json.dumps(json.loads(resp.read()), ensure_ascii=False, indent=2))
   
   

各メモリスペースは独立したパーソナライズドメモリを持っています。アプリケーションで業務シナリオに合致するメモリスペース及びそのSpace IDを使用していることを確認してください。

スマート検索を体験

メモリ機能にはスマート検索機能が組み込まれており、アプリケーションがユーザーのニーズをより正確に理解するのに役立ちます。以下の例を参考に情報を追加し、検索を実行してください：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
OBCloud Memory · メモリの検索
POST /spaces/{spaceId}/memories/search
"""

import json
import urllib.request

# ====== 設定 ======
# API Keyを取得し、以下に入力してください。
API_KEY    = "sk_xxxxxx"

# ページの左上にある組織名をクリックし、プロジェクトリストから現在のプロジェクトIDをコピーします。
PROJECT_ID = "xxxxxx"

# スペースの左下にある「完全なスペースIDをコピー」をクリックしてSPACE_IDを取得します。
SPACE_ID   = "xxxxx"

BASE_URL   = "https://ai-api-g.oceanbase.com/api/v1/memory"
# ==================

body = {
    "query": "張三は普段どんなコーヒーを飲むのが好きですか？",
}

req = urllib.request.Request(
    f"{BASE_URL}/spaces/{SPACE_ID}/memories/search",
    data=json.dumps(body, ensure_ascii=False).encode("utf-8"),
    method="POST",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "X-OB-Project-ID": PROJECT_ID,
        "Content-Type": "application/json",
    },
)

with urllib.request.urlopen(req, timeout=30) as resp:
    print(json.dumps(json.loads(resp.read()), ensure_ascii=False, indent=2))