Neo4j

Neo4j は、データをテーブルやドキュメントではなく、ノード・リレーションシップ・プロパティとして保存するグラフデータベースです。この構造により、ホワイトボードにアイデアを書き出すような直感的なデータ整理が可能になります。SambaNova を組み合わせることで、最先端の言語モデルを活用した高度なグラフ分析や自然言語クエリを Neo4j アプリケーションに取り入れることができます。

本ガイドは Neo4j 5.x と SambaNova GraphRAG コードベース v1.x で動作確認しています。異なるバージョンを使用している場合、一部の手順が異なる可能性があります。

概要

本ガイドでは、SambaNova の LLM を活用したエージェントと Neo4j を用いて GraphRAG アプリケーションを構築する手順を解説します。GraphRAG は、単純なテキスト断片ではなくグラフのリレーションシップを活用する、構造化された階層的な検索拡張生成 (RAG) のアプローチです。サンプルアプリケーションは、Synthea データセットに含まれる患者の電子カルテを取得します。エージェントは Neo4j のグラフクエリ言語 (Cypher) を使用し、次の 2 つの方法でレコードにアクセスします。

静的クエリ: 一般的な操作向けに事前定義された Cypher クエリ。
動的クエリ: 自然言語の入力から LLM が生成する Cypher クエリ (Text-to-Cypher)。

前提条件

SambaCloud のアカウントと API キー、または SambaStack 環境
Python 3.11 以上
Python の依存関係管理用の UV パッケージマネージャー
Neo4j データベースインスタンス (ローカルまたはクラウドホスト)

セットアップ

依存パッケージのインストール

UV パッケージマネージャーのインストール

pip install uv

integrations リポジトリのクローン

git clone https://github.com/sambanova/integrations.git
cd integrations/langgraph/agentic_graph_rag

仮想環境の作成と依存パッケージのインストール

uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

Synthea データセットの読み込み

Synthea データセットのダンプファイルのダウンロード

Synthea データセットのダンプファイルをローカルマシンにダウンロードします。

Neo4j Desktop へのダンプの読み込み

データベースを停止します。
対象データベースのターミナルを開きます。
パスをダウンロード先に置き換えて、以下のコマンドを実行します。
neo4j-admin database load --from-path=/path/to/dump synthea --overwrite-destination
データベースを起動します。

Neo4j Aura などのクラウドインスタンスについては、Neo4j のデータインポートに関するドキュメントをご参照ください。

環境変数の設定

サンプルの環境設定ファイルのコピー

cp .env.example .env

.env を編集して以下の変数を設定

# SambaNova API configuration
SAMBANOVA_API_KEY=your_api_key_here
SAMBANOVA_BASE_URL=https://api.sambanova.ai/v1

# Neo4j connection
NEO4J_URI=bolt://localhost:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your_password_here

アプリケーションの実行

バックエンドの起動

SambaNova の LLM を使用して Neo4j データベースに接続する HTTP サーバーを起動します。

bash ./start_server.sh

サーバーが起動すると、以下のような出力が表示されます。

INFO:     Uvicorn running on http://0.0.0.0:8000
INFO:     Application startup complete.

フロントエンドの表示

ブラウザでアプリケーションのランディングページを開きます。

http://localhost:8000/app

接続の確認

チャットボットのインターフェースで、「List all patients.」などのテストクエリを入力します。
アプリケーションが Neo4j データベースから患者レコードを返すことを確認します。

主な機能

設定が完了すると、GraphRAG アプリケーションで以下のことができるようになります。

自然言語クエリ: 患者データについて平易な英語で質問できます。
グラフトラバーサル: 患者・症状・投薬・受診の間のリレーションシップを探索できます。
Text-to-Cypher: 自然言語の入力から Cypher クエリを自動生成します。
ヘルスケア分析: グラフベースのインサイトを用いて、Synthea データセット全体のパターンを分析できます。

デモ動画

以下の動画では、GraphRAG アプリケーションが SambaNova の LLM を活用して Neo4j データベースのヘルスケアデータにアクセスする様子をご覧いただけます。

トラブルシューティング

問題	解決方法
バックエンド起動時の `Connection refused`	Neo4j が稼働していること、および `.env` の `NEO4J_URI` が正しいことを確認してください。
認証エラー	`NEO4J_USERNAME` と `NEO4J_PASSWORD` が Neo4j の認証情報と一致しているか確認してください。
`SAMBANOVA_API_KEY not set` エラー	`.env` ファイルが存在し、SambaCloud の有効な API キーが記載されていることを確認してください。
クエリ結果が空	Synthea データセットが正しく読み込まれたか確認してください。Neo4j Browser で `MATCH (n) RETURN count(n)` を実行し、データが存在することを確認できます。
`ModuleNotFoundError`	仮想環境を有効化しているか確認してください: `source .venv/bin/activate`

概要

開発者ツール

フレームワーク

インターフェースとローコード

データとインフラ

マルチモーダル

評価とモニタリング

概要

前提条件

セットアップ

依存パッケージのインストール

Synthea データセットの読み込み

環境変数の設定

アプリケーションの実行

バックエンドの起動

フロントエンドの表示

接続の確認

主な機能

デモ動画

トラブルシューティング

参考情報

​概要

​前提条件

​セットアップ

​依存パッケージのインストール

​Synthea データセットの読み込み

​環境変数の設定

​アプリケーションの実行

​バックエンドの起動

​フロントエンドの表示

​接続の確認

​主な機能

​デモ動画

​トラブルシューティング

​参考情報

概要

前提条件

セットアップ

依存パッケージのインストール

Synthea データセットの読み込み

環境変数の設定

アプリケーションの実行

バックエンドの起動

フロントエンドの表示

接続の確認

主な機能

デモ動画

トラブルシューティング

参考情報