エージェント メモリの構成

メモリ空間を作成し、エージェントでエピソード メモリとエスカレーション メモリを有効化し、エージェントを運用環境で実行する前に再現率をテストします。

エージェント メモリは 2 か所に設定されます。メモリ空間が Agents のインスタンスの管理ページに作成されてから、エージェントにアタッチされて Studio Web の Agent Builder で調整されます。それぞれの種類のメモリの機能と使用状況については、「 エージェント メモリ」をご覧ください。

メモリ空間を作成する

メモリ空間には、1 つ以上のエージェントのメモリ項目が格納されています。スペースを共有するエージェントは、互いのケースから学んだことも共有します。

1. Agents で [管理] に移動し、[メモリ空間] を選択します。
2. [ メモリ空間を作成] を選択します。
3. メモリ 空間の名前を入力します 。
4. (任意)[ 説明] を入力します (最大 1024 文字)。
5. メモリ空間が属する フォルダー を選択します。
6. (任意)組織で顧客管理のキー (CMK) を使用している場合は、 暗号化を有効化します。
7. [保存] を選択します。

メモリ空間が [メモリ空間] リストに表示され、エージェントに接続できます。スペースの作成後に暗号化を変更することはできません。

エピソード メモリを有効化

エピソード メモリは、意味的に類似した過去のケースからコンテキストを各実行に追加します。これは、[記憶を編集してテスト] ダイアログの [エピソード] タブで設定します。

設定	制御するもの
動的な少数ショット学習	最も関連性の高い過去のインタラクションを例として自動的に選択し、エージェントの応答をガイドします。
Semantic similarity (意味的類似性)	例として使用するには、新しいクエリが過去のクエリとどの程度一致する必要があるか。値が大きいほど厳密になります。
取得する例 (K)	動的少数ショット学習に含める例の数です。
検索モード	ハイブリッドでは 、キーワードと意味ベースの一致を組み合わせて、最も広範な結果を得ることができます。意味のみに応じたセマンティック マッチングを行い、正確なキーワードは無視します。
重み付け	入力引数の一致シェア。すべての引数の重みの合計は常に 100% になります。

ケースを定義する引数 (顧客 ID など) には重みを付け、自由に変化する引数 (フリー テキストのメモなど) には重みを低くします。

1. Studio Web でエージェントを開きます。
2. エージェントに メモリ ノードを追加します。
3. [プロパティ] パネルから、既存のメモリ空間を選択するか、新しいメモリ空間を作成します。
4. [ 編集/テスト] を選択します。
5. [ エピソード] タブで、[ 動的少数ショット学習] を有効化します。
6. 意味的類似性、[取得する例] (K)、および検索モードを設定します。
7. [ 引数] で [ 引数を追加] を選択します。
8. リストから入力引数を選択します。
9. 引数の [重み ] を入力します。
10. 一致に寄与するはずの入力ごとに、手順 7 から 9 を繰り返します。
11. [保存] を選択します。
12. エージェントをパブリッシュします。

この設定は、パブリッシュ済みのエージェントの実行に適用されます。

エスカレーション メモリを有効化

エスカレーション メモリは、ユーザーが同等のエスカレーションをどのように解決したかを再利用するため、エージェントは、同じエスカレーションを再度発生させるのではなく、保存された結果を適用します。同じダイアログの [ エスカレーション ] タブで設定し、上位ランクのメモリのみを取得します。

注:

エスカレーション メモリには、[ 引数 ] (手順 8) で少なくとも 1 つの引数が必要です。

1. Studio Web でエージェントを開きます。
2. エージェントに メモリ ノードを追加します。
3. [プロパティ] パネルから、既存のメモリ空間を選択するか、新しいメモリ空間を作成します。
4. [ 編集/テスト] を選択します。
5. [ エスカレーション ] タブを開きます。
6. 意味的類似性と検索モードを設定します。
7. [ エスカレーションを追加] を選択します。
8. [ 引数] で [ 引数を追加] を選択します。
9. リストから入力引数を選択します。
10. 引数の [重み ] を入力します。
11. [保存] を選択します。
12. エージェントをパブリッシュします。

メモリ空間をテストする

メモリ プレイグラウンドは、エージェントを実行せずに、エージェントが実行した場合と同じ再現手順を実行します。これを使用して、引数、重み、および類似性のしきい値が期待どおりのメモリを返すことを確認します。

1. Studio Web でエージェントを開きます。
2. プロパティ パネルの [ メモリ ] セクションに移動します。
3. [ 編集/テスト] を選択します。
4. [ エピソード ] タブまたは [ エスカレーション ] タブを開きます。
5. 各引数のテスト値を入力します。
6. [実行] を選択します。

プレイグラウンドには、その入力に対して取得される記憶とその類似性スコアが一覧表示されます。[ エスカレーション ] タブには、保存した解決策が適用されるかどうかが結果に表示されます。

メモリ項目の管理

Agents のインスタンスの管理でメモリ空間を開き、そのメモリ項目をグリッドに表示します。グリッドからは、次のことが可能です。

• エスカレーション メモリ用にキャプチャされた解決策を含め、保存されている各項目を確認します。
• エントリを編集します。
• メモリ項目を有効または無効にして、メモリ検索時に考慮するかどうかを制御します。
• 適用されなくなったエントリを削除します。
• エントリをエクスポートし、別のメモリ空間またはテナントにインポートします。

注:

既存のエピソード メモリ項目の入力の編集はサポートされていません。修正するには、削除して新しい追加します。