このトピックでは、Dify と Hologres を使用して ChatBI アプリケーションをクイックに構築する方法について説明します。
背景情報
Dify は、オープンソースの大規模言語モデル (LLM) アプリケーション開発プラットフォームです。Backend as a Service と LLMOps の概念を組み合わせることで、開発者は本番環境レベルの生成系 AI アプリケーションを迅速に構築できます。技術者以外のスタッフも、AI アプリケーションの定義やデータ操作に参加できます。
前提条件
-
Dify 1.2.0 以降がデプロイされていること。詳細については、「Dify」をご参照ください。
-
Hologres のデータが準備されていること。操作の詳細は次のとおりです。
-
ユーザーを作成し、対象のデータベースに対する操作権限をユーザーに付与します。詳細については、「カスタムユーザーの作成」および「ユーザーへの権限付与」をご参照ください。
-
ビジネスデータを準備します。このトピックでは、Hologres の TPC-H 10 GB パブリックデータセットを例として使用します。パブリックデータセットのインポート方法の詳細については、「ワンクリックでのパブリックデータセットのインポート」をご参照ください。
注意事項
Dify は、構成されたユーザーを介して Hologres インスタンスにアクセスします。次の点にご注意ください。
-
リソースの隔離:リソースの隔離には Serverless Computing を使用します。
-
権限の隔離:ユーザーにはクエリ権限のみを付与します。ChatBI のアクセスの制御に関する詳細については、Dify の公式ドキュメントをご参照ください。
手順
-
hologres_text2data とモデルツールをインストールします。この例では、Qwen プラグインを使用してモデルサービスを提供します。
Dify プラットフォームで、[プラグイン] をクリックし、[マーケットプレイスを探索] をクリックして、hologres_text2data と tongyi を検索し、[インストール] をクリックします。
説明hologres_text2data プラグインは、Dify の公式マーケットプレイスで公開されており、GitHub でオープンソース化されています。
-
モデルプロバイダーを構成します。
-
アカウントアイコンをクリックし、設定 をクリックして、Account ページに移動します。

-
左側のナビゲーションウィンドウで、[モデルプロバイダー] をクリックします。
-
Qwen の横にある 設定 をクリックし、[Qwen の追加] ダイアログボックスで [API キー] を入力します。
[Qwen の追加] ダイアログボックスで、[Alibaba Cloud Model Studio から API キーを取得] をクリックして API キーを取得できます。詳細については、「Qwen API の初回呼び出し」をご参照ください。
-
保存 をクリックして構成を完了します。
-
-
DSL ファイルをインポートして ChatFlow を構築します。
-
Dify プラットフォームで、メニューバーから [Studio] を選択し、[DSL ファイルのインポート] をクリックします。

表示されるダイアログボックスで、DSL ファイル Hologres ChatBI with Holo Plugin-250422-v1.yml をアップロードします。
-
Create をクリックしてアップロードを完了します。
アップロードが完了すると、システムはデフォルトのワークフローを生成します。このワークフローは、Model Studio の Qwen-Max-Latest モデルを使用します。モデルの詳細については、「モデルリスト」をご参照ください。

-
-
対象の ChatFlow の [オーケストレーション] ページで、[hologres_text2data] および [hologres_execute_sql] ノードをクリックして、Hologres のパラメーターを構成します。
パラメーター名
説明
[データベース IP/ドメイン名]
Hologres インスタンスのエンドポイント。例:
hgprecn-cn-xxxk3ovx003-cn-hangzhou.hologres.aliyuncs.com。Hologres コンソールにログインします。左側のナビゲーションウィンドウで、Instances を選択します。対象インスタンスの ID をクリックします。Instance Details ページの Network Information セクションでエンドポイントを取得します。詳細については、「エンドポイント」をご参照ください。
データベースポート
ポート番号。デフォルト値は 80 です。
Database Name
作成したデータベースの名前。
Hologres コンソールにログインします。左側のナビゲーションウィンドウで、Instances を選択します。対象インスタンスの ID をクリックして Instance Details ページに移動します。Database Management をクリックします。Database Authorization ページでデータベース名を取得します。
Username
作成したユーザーの名前。フォーマットは
BASIC$<name>です。Hologres コンソールにログインします。左側のナビゲーションウィンドウで、Instances を選択します。対象インスタンスの ID をクリックして Instance Details ページに移動します。アカウント管理 をクリックします。Users ページでユーザー名を取得します。詳細については、「ユーザー管理」をご参照ください。
Password
ユーザーに対応するパスワード。
-
構成が完了したら、右上の をクリックします。
-
アプリケーションが公開されたら、右上の をクリックして ChatBI アプリケーションを開き、チャットを開始します。