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

n8n ワークフローをインポートする — チャットメッセージに応答する AI エージェント

n8n のワークフロー — チャットトリガー、AI Agent、OpenAI Chat Model、Simple Memory — を、aggrega import で Aggregate、Release、Manifest にインポートしたもので、これらは書かれたままで Docker Compose 向けにビルドできます。

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

フォルダー内容
source/ワークフロー support-agent.json、フォルダーをワークスペースにする .aggrega-config.yaml、そして Kubernetes 向けのインポートが求める、どのワークフローにも保持できない事柄への回答である import-answers.yaml
draft/aggrega import support-agent.json --target compose が書き出したファイル(変更なし)と、出力した内容:標準出力は stdout.txt、標準エラーは import.txt

source/support-agent.json はこの例のために書かれたもので、n8n がワークフローをエクスポートする形式に従っています。

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

サンプルを生成する

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

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

Terminal window
aggrega scaffold --example import-n8n

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

Terminal window
cd import-n8n

ビルド

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

Terminal window
cd source
aggrega import support-agent.json --target compose
aggrega validate --release release.yaml
aggrega build --release release.yaml

ビルドが書き出したものの実行方法は、上記のリンク先のウォークスルーにあります。

AI アシスタントを使う

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

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

テストする

ウォークスルーと同じようにスタックを実行した状態で(認証情報を保存し、ワークフローを有効にした状態で)、http://127.0.0.1:5678 を開いて n8n のエディターを表示し、チャットトリガーが保存しているユーザーとパスワードを使ってメッセージを送信します。ユーザーとパスワードは curl の標準入力で CHAT_USER と CHAT_PASSWORD から読み取ります:

Terminal window
printf 'user = "%s:%s"\n' "$CHAT_USER" "$CHAT_PASSWORD" | curl --config - -sS -i -X POST \
http://127.0.0.1:5678/webhook/a3c9e1f2-4b5d-4e6f-8a7b-9c0d1e2f3a04/chat -H 'Content-Type: application/json' \
-d '{"action": "sendMessage", "sessionId": "s1", "chatInput": "In one short sentence: what does a support plan cover?"}'
HTTP/1.1 500 Internal Server Error
[… omitted: the response's other headers]
{"message":"Error in workflow"}

この実行では OpenAI キーにプレースホルダーを保存したため、ワークフローはモデルの呼び出しで停止し、エディターでのその実行には OpenAI の拒否が表示されます:Incorrect API key provided: sk-place*****************-key.

--target helm でインポートして Kubernetes に適用した場合も、ウォークスルーが示すとおり、実行中のインスタンスで認証情報を保存してワークフローを有効にし、ローカルポートをその Service に転送すれば、n8n は同じアドレスで同じメッセージを受け取ります。実行ではそこでも同じ応答が得られました:

Terminal window
kubectl port-forward -n <namespace> svc/n8n-default 5678:5678