このトピックでは、Dify と Hologres を使用して ChatBI アプリケーションを迅速に構築する方法について説明します。
背景情報
Dify は、Backend as a Service（BaaS）と LLMOps の概念を統合したオープンソースの大規模言語モデル（LLM）アプリケーション開発プラットフォームです。開発者は、Dify を使用して、本番レベルの生成 AI アプリケーションを迅速に構築できます。非技術者も、AI アプリケーションの定義とデータ操作プロセスに参加できます。
前提条件
Dify 1.2.0 以降がデプロイされている。
Hologres データが準備されている。次の操作を実行してデータを準備できます。
アカウントを作成し、作成したデータベースに対する操作権限をアカウントに付与します。詳細については、「カスタムアカウントを作成する」および「ユーザーに権限を付与する」をご参照ください。
ビジネスデータを準備します。このトピックでは、Hologres 用の TPC-H 10 GB パブリックデータセットを例として使用します。パブリックデータセットのインポート方法の詳細については、「数クリックでパブリックデータセットをインポートする」をご参照ください。
注意事項
Dify は、構成済みのアカウントを使用して Hologres インスタンスにアクセスします。次の点に注意してください。
リソースの隔離: サーバーレスコンピューティング を使用してリソースを隔離できます。
権限の隔離: アカウントにはクエリ権限のみを付与することをお勧めします。 ChatBI のアクセスコントロールの詳細については、「Dify ドキュメント」をご参照ください。
手順
hologres_text2data とモデルツールをインストールします。この Topic では、モデルサービスを提供するために TONGYI をインストールします。
Dify プラットフォームで、[プラグイン] をクリックし、[マーケットプレイスを探索] を選択します。次に、hologres_text2data と TONGYI を検索し、[インストール] をクリックします。
説明手順Dify 公式マーケットプレイスGitHub プラグインは で公開されており、そのソースコードは でオープンソース化されています。
モデルプロバイダーを構成します。
右上隅にあるアカウント名をクリックし、[設定] をクリックして [メンバー] ページに移動します。
左側のナビゲーションウィンドウで、[モデルプロバイダー] をクリックします。
TONGYI の横にある [設定] をクリックします。 [TONGYI の設定] ダイアログボックスで、API キーを入力します。
[TONGYI の設定] ダイアログボックスで [AliCloud から API キーを取得] をクリックして、API キーを取得できます。詳細については、「Qwen への最初の API 呼び出しを行う」をご参照ください。
[保存] をクリックして構成を完了します。
DSL ファイルをインポートしてチャットフローを構築します。
Dify プラットフォームで、メニューバーから [Studio] を選択し、[DSL ファイルをインポート] をクリックします。
表示されるダイアログボックスで、DSL ファイル Hologres ChatBI with Holo Plugin-250422-v1.yml をアップロードします。
[作成] をクリックしてアップロードを完了します。
アップロードが完了すると、システムはデフォルトで次のチャットフローを生成します。このチャットフローは、Model Studio の Qwen-Max-Latest モデルを使用します。モデルの詳細については、「モデル」をご参照ください。
チャットフローの [オーケストレーション] ページで、[hologres_text2data] ノードと [hologres_excute_sql] ノードをクリックして、関連する Hologres パラメーターを構成します。
パラメーター
説明
データベース IP/ホスト
Hologres インスタンスのエンドポイント（例:
hgprecn-cn-xxxk3ovx003-cn-hangzhou.hologres.aliyuncs.com）。エンドポイントを取得するには、Hologres コンソール にログインし、左側のナビゲーションウィンドウで [インスタンス] をクリックし、インスタンスの ID をクリックします。 [インスタンスの詳細] ページの [ネットワーク情報] セクションでエンドポイントを取得します。詳細については、「Hologres に接続するためのエンドポイント」をご参照ください。
データベースポート
ポート番号。デフォルト値は 80 です。
データベース名
作成したデータベースの名前。
データベース名を取得するには、Hologres コンソール にログインし、左側のナビゲーションウィンドウで [インスタンス] をクリックし、インスタンスの ID をクリックします。 [インスタンスの詳細] ページで、[データベース管理] をクリックします。 [データベース認証] ページでデータベース名を取得します。
ユーザー名
作成したアカウントの名前。形式は
BASIC$<name>です。アカウント名を取得するには、Hologres コンソール にログインし、左側のナビゲーションウィンドウで [インスタンス] をクリックし、インスタンスの ID をクリックします。 [インスタンスの詳細] ページで、[アカウント管理] をクリックします。 [ユーザー管理] ページでアカウント名を取得します。詳細については、「ユーザー管理」をご参照ください。
パスワード
アカウントのパスワード。
構成が完了したら、右上隅にある を選択します。
公開が完了したら、右上隅にある を選択して ChatBI アプリケーションに入り、チャットを開始します。