メモリ機能の使用

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

機能の概要

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

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

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

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

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

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

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

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

前提条件

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

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

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

1. OB 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))