DID Spaces メモリ

このガイドでは、DID Spaces を使用して永続的なメモリを持つチャットボットを構築する方法を説明します。AIGNE フレームワークの DIDSpacesMemory プラグインを活用することで、Agent は分散型かつ安全な方法で、複数のセッションにわたって会話履歴を保持できます。

前提条件

始める前に、以下がインストールされ、設定されていることを確認してください：

クイックスタート

npx を使用すると、ローカルに何もインストールせずにこのサンプルを直接実行できます。

1. サンプルを実行する

ターミナルで次のコマンドを実行します：

memory-did-spaces サンプルを実行する

npx -y @aigne/example-memory-did-spaces

2. AI モデルに接続する

初回実行時、API キーが設定されていないため、CLI は AI モデルへの接続を促します。

続行するにはいくつかのオプションがあります：

ローカルでのインストールと実行

ソースコードからサンプルを実行したい場合は、以下の手順に従ってください。

1. リポジトリをクローンする

まず、GitHub から AIGNE フレームワークのリポジトリをクローンします：

git clone https://github.com/AIGNE-io/aigne-framework

2. 依存関係をインストールする

サンプルのディレクトリに移動し、pnpm を使用して必要な依存関係をインストールします：

cd aigne-framework/examples/memory-did-spaces
pnpm install

3. サンプルを実行する

最後に、サンプルを開始します：

pnpm start

スクリプトは、メモリ機能を実証するために3つのテストを実行します：ユーザープロファイルの保存、嗜好の想起、保存されたデータに基づくポートフォリオの作成。結果はコンソールに表示され、確認用にマークダウンレポートファイルに保存されます。

仕組み

このサンプルは @aigne/agent-library パッケージの DIDSpacesMemory プラグインを利用しています。このプラグインにより、Agent は会話履歴を分散型パーソナルデータストレージソリューションである DID Spaces に保存することで、永続化できます。

主な機能は次のとおりです：

このサンプルでは、ユーザープロファイルの詳細を保存し、新しい対話でそれを思い出し、その記憶されたコンテキストを使用してパーソナライズされた推奨を提供することで、これを実証しています。

設定

このサンプルにはデモンストレーション目的で事前設定された DID Spaces エンドポイントが付属していますが、本番アプリケーションでは設定を更新する必要があります。これには、独自の DID Spaces インスタンスを設定し、コード内で正しい URL と認証情報を提供することが含まれます。

memory-config.ts

import { DIDSpacesMemory } from '@aigne/agent-library';

const memory = new DIDSpacesMemory({
  url: "YOUR_DID_SPACES_URL",
  auth: {
    authorization: "Bearer YOUR_TOKEN",
  },
});

"YOUR_DID_SPACES_URL" と "Bearer YOUR_TOKEN" を実際のエンドポイントと認証トークンに置き換えてください。

AIGNE Observe を使用したデバッグ

Agent の実行を監視およびデバッグするには、aigne observe コマンドを使用できます。このツールは、Agent のトレースを詳細に表示するローカルウェブサーバーを起動し、その動作の理解、問題の診断、パフォーマンスの最適化に役立ちます。

観察サーバーを起動するには、次を実行します：

aigne observe

実行されると、提供された URL（デフォルトでは http://localhost:7893）をブラウザで開いて、最近の Agent 実行のリストを表示し、その詳細を検査できます。

まとめ

このサンプルでは、DIDSpacesMemory プラグインを使用して、分散型の永続メモリを AI Agent に統合する方法を示しました。この機能により、セッションを越えてユーザーの対話を記憶する、より洗練されたコンテキスト認識型のチャットボットを作成できます。

関連する概念についてさらに学ぶには、以下のドキュメントを参照してください：