コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Dify アプリケーションをインポートする — Dify インストール内のチャットアシスタント

Dify の DSL でエクスポートされた Dify のチャットアプリケーションを、aggrega import で Aggregate、Release、Manifest にインポートしたものです。これらは、そのアプリケーションを載せた標準ライブラリの Dify インストールを、書かれたままの状態で Kubernetes 向けにビルドします。

Dify アプリケーションをインポートする では、コマンド、それが書き出すファイル、ビルド、そしてビルドしたものの実行までを順を追って説明します。このフォルダーには、そのウォークスルーの各段階が収められています:

フォルダー内容
source/アプリケーション support-assistant.yml、フォルダーをワークスペースにする .aggrega-config.yaml、そしてどのアプリケーションにも含められない内容への回答である import-answers.yaml:インストールのアプリケーションシークレットとオーナーのパスワードを保持する Kubernetes Secret の名前、およびオーナーアカウントのメールアドレス
draft/aggrega import support-assistant.yml --target helm が書き出したファイル(変更なし)と、出力した内容:標準出力は stdout.txt、標準エラーは import.txt

source/support-assistant.yml はこの例のために書かれたもので、Dify が DSL バージョン 0.7.0 でアプリケーションをエクスポートする形式に従っています。

ドキュメントリポジトリのチェックアウトでは、check.sh がインポートを再実行し、書き出した内容と出力した内容を draft/ と比較し、ウォークスルーが引用するブロックをこれらのファイルと比較して、インポートが書き出したものを検証しビルドします。このリポジトリの隣に標準ライブラリのカタログ(入手先)がチェックアウトされているか、そのディレクトリが AGGREGA_CATALOG_DIRS に指定されている必要があります。

サンプルを生成する

この例のインポートは、以下のコマンドで実行することも、AI アシスタントに代わりに実行させることもできます。

例の名前を付けた新しいフォルダーに例を書き出します。

Terminal window
aggrega scaffold --example import-dify

その後、次に実行するコマンドを表示します。最初のコマンドは新しいフォルダーに移動します。

Terminal window
cd import-dify

ビルド

インポートは、プロジェクトの横の source/ に Aggrega ファイルを下書きし、どのアプリケーションにも含められない内容を import-answers.yaml から取得し、ビルドに必要なものをプルします。プロジェクトを標準ライブラリのカタログと照らし合わせます。このカタログは、ワークスペースのデフォルトレジストリが署名付きスナップショットとして公開しているものです:最初のインポートでそれを取得して検証し、ワークスペースのコンテンツキャッシュに保持し、下書きの横に書き出す記録にそのダイジェストで名前を記します。独自のカタログフォルダーを指定するワークスペース — AGGREGA_CATALOG_DIRS で、または workspace.catalog_dirs の下で — では、代わりにそれらに対してインポートします:

Terminal window
cd source
aggrega import support-assistant.yml --target helm
aggrega validate --release release.yaml
aggrega build --release release.yaml

ビルドのマニフェストが読み取る Secret の作成と、マニフェストの実行については、上でリンクしたウォークスルーにあります。

AI アシスタントを使う

Aggrega のツールでセットアップした AI アシスタントでも同じことができます。次のプロンプトを貼り付けてください。

Aggrega のツールだけを使い、フォルダーは自分で作成しないでください。ワークスペースフォルダーにまだ `import-dify` フォルダーがない場合は、`example` を `import-dify` に設定し、`dir` を指定せずに `scaffold` ツールを一度呼び出してください。このツールは例を新しい `import-dify` フォルダーに書き込み、その `source` フォルダーにこの例がインポートするものが入ります。次に、`workspace_root` を `import-dify/source`、`source` を `support-assistant.yml`、`target` を `helm` に設定して `import` ツールを呼び出してください。このツールは必要な回答を `support-assistant.yml` の隣にある `import-answers.yaml` から読み取り、下書きを `import-dify/source` に書き込み、下書きが必要とするものをプルします。次に、`workspace_root` を `import-dify/source`、`release` を `release.yaml` に設定して `validate` ツールを、`workspace_root` を `import-dify/source`、`release` を `release.yaml`、`write` を true に設定して `build` ツールを呼び出してください。ビルドが書き込んだファイルを教えてください。それらは `import-dify/source/dist/` の下にあります。

テストする

--target compose でインポートし、ウォークスルーの Docker Compose の場合 に示すとおりに起動すると、インストールはこのマシン上で応答します。API は http://127.0.0.1:5001、コンソールは http://127.0.0.1:3001/signin です。アプリケーションは自身のキーで送られたメッセージに応答します。このキーは ウォークスルー で、サインインし、Dify のプラグインマーケットプレイスから OpenAI プロバイダーをインストールし (下書きの Release の marketplace_enabled によってインストールはこのマーケットプレイスに到達できます)、プロバイダーのキーを設定した後に作成します:

Terminal window
curl -sS http://127.0.0.1:5001/v1/chat-messages \
-H 'Authorization: Bearer <app key>' -H 'Content-Type: application/json' \
-d '{"inputs": {}, "query": "In one short sentence: what does a support plan cover?", "response_mode": "blocking", "user": "test-it"}'

この実行のプロバイダーキーはプレースホルダーであり、設定時に Dify が OpenAI の Incorrect API key provided で拒否したため、メッセージには次の応答が返りました:

{"code":"provider_not_initialize","message":"Model gpt-4o-mini credentials is not initialized.","status":400}

上記のとおり Kubernetes 向けにビルドし、ウォークスルーの 実行する と同じように適用すると、ローカルポートをその Service に転送した時点で、API は同じアドレスで同じリクエストに応答します。この実行でもそこで同じ応答が得られました:

Terminal window
kubectl port-forward -n <namespace> svc/dify-zdapi-default 5001:5001