> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sambanova.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# n8n
n8n は、ノーコード / ローコードのワークフロー自動化フレームワークです。本ガイドでは、OpenAI 互換の Chat Model ノードを通じて [SambaCloud](https://cloud.sambanova.ai?utm_source=n8n\&utm_medium=external\&utm_campaign=cloud_signup) のモデルを n8n に接続する手順を解説します。
## 前提条件
作業を始める前に、以下の環境を準備してください。
* n8n アカウント (クラウド版またはセルフホスト版、最新のリリース)。本ガイドで使用する Advanced AI クラスターノードは 1.x 系から提供されており、n8n は現在 2.x 系のため、保守されているバージョンであれば利用できます。古いビルドをセルフホストしている場合は、先へ進む前にノード検索で **AI Agent** が表示されることを確認してください
* SambaCloud の API キー。[SambaCloud](https://cloud.sambanova.ai?utm_source=n8n\&utm_medium=external\&utm_campaign=cloud_signup) アカウントを作成し、「API keys」タブでキーを生成して取得してください
OpenAI Chat Model ノードはサブノードであり、単体では動作しません。**AI Agent** や **Basic LLM Chain** などのルートノードに接続する必要があります。本ガイドでは AI Agent を使用します。
## ワークフローの作成または表示
n8n プラットフォームにログインし、**+** ボタンを選択します。または、**「Create Workflow」** ボタンを選択して新しいワークフローを開始します。
## AI Agent ノードの追加
キャンバス上で **「Add first step」** または **+** ボタンを選択し、**AI Agent** を検索して追加します。AI Agent ノードは、モデルと接続したツールを実行するルートノードです。キャンバスに追加すると下側に空のコネクタースロットが並び、そのひとつが **Chat Model** です。
## OpenAI Chat Model サブノードの追加
AI Agent ノードの **Chat Model** コネクターにある **+** を選択し、**OpenAI Chat Model** を選びます。SambaCloud は OpenAI 互換のため、SambaNova 専用のノードがなくてもこのノードで接続できます。
## 認証情報の設定
OpenAI Chat Model パネルで **「Credential to connect with」** ドロップダウンを開き、**「Create new credential」** を選択します。**API Key** に SambaCloud の API キーを入力し、**Base URL** に `https://api.sambanova.ai/v1` を設定します。
見落としやすいのが **Base URL** フィールドです。OpenAI のデフォルトのままにすると、すべてのリクエストが SambaNova のキーを付けたまま OpenAI に送信され、保存時ではなく最初の呼び出し時に失敗します。
認証情報を保存します。n8n が接続テストを実行し、キーと Base URL の両方が受理されると **Connection tested successfully** と表示されます。
## モデルの選択
**「Model」** ドロップダウンをクリックします。n8n は設定した Base URL の `/models` を呼び出して一覧を取得するため、認証情報を保存すると SambaCloud の最新のモデルカタログが表示されます。
| ワークフローの種類 | 選択するモデル |
| :- | :- |
| ツールを呼び出すエージェント (AI Agent ワークフローの大半がこれに該当) | `Meta-Llama-3.3-70B-Instruct` |
| 画像を読み取り、ツールは接続しない | `gemma-4-31B-it` |
現時点では、この 2 つの要件を 1 つのモデルで満たすことはできません。AI Agent は Function calling (関数呼び出し) を通じてツールを動かしますが、`gemma-4-31B-it` は [Function calling](/docs/ja/features/function-calling) の対応モデルに含まれていないため、gemma にツールを接続したエージェントはモデル単体で応答し、ツールを一切呼び出しません。n8n の実行ログには何も記録されないため、エージェントがツールを無視しているように見えます。`gemma-4-31B-it` は、ツールを使わない画像入力の用途に限って選択してください。
上のスクリーンショットに写っているモデル ID は以前のカタログのもので、その一部はすでに提供終了しています。画像内の名前ではなく、SambaCloud が現在提供しているモデルを一覧表示するドロップダウンを信頼してください。同じ一覧は `curl https://api.sambanova.ai/v1/models` でも確認できます (API キー不要)。[SambaCloud のモデル](/docs/ja/models/sambacloud-models) もご参照ください。
ドロップダウンが空の場合は、[トラブルシューティング](#トラブルシューティング) をご参照ください。
## トラブルシューティング
多くの場合、認証情報のテストには成功したものの `/models` の呼び出しが失敗していることが原因です。Base URL が末尾スラッシュの過不足なく正確に `https://api.sambanova.ai/v1` であること、および API キーが有効であることを確認してください。
この問題は、カスタム Base URL を設定した n8n のスタンドアロン **OpenAI** ノード (v2、「Message a model」) で報告されたものです。認証情報のテストと実行時のノードが同じ最終 URL を組み立てないため、テストだけが通ります。[n8n-io/n8n#21651](https://github.com/n8n-io/n8n/issues/21651) をご参照ください。別の OpenAI 互換プロバイダーに対して報告されたもので、2026-05-26 に完了としてクローズされているため、最新の n8n では発生しないはずです。
それでも発生する場合は、最終 URL で `/v1` が欠落または重複していないかを確認し、本ガイドと同様に AI Agent と組み合わせた **OpenAI Chat Model** サブノードを使用してください (こちらはこの問題の影響を受けていませんでした)。
原因は 2 つ考えられます。OpenAI Chat Model ノードの組み込みツール呼び出しは、Basic LLM Chain ではなく **AI Agent** ノードに接続されている場合にのみ機能します。すでに AI Agent を使用している場合はモデルを確認してください。ツール呼び出しには [Function calling](/docs/ja/features/function-calling) に記載されたモデルが必要ですが、`gemma-4-31B-it` は対象外のため、このモデルを使うエージェントはツールを一度も呼び出さずに応答し、エラーも記録しません。
API キーが余分な空白の混入なくコピーされていること、および SambaCloud のダッシュボードで失効していないことを再確認してください。
## 使用例: 家計簿エージェント
具体的な例として、シンプルな家計簿エージェントを構築する [サンプルワークフロー](https://github.com/sambanova/integrations/tree/main/n8n) をご覧ください。このワークフローは、SambaCloud と n8n を用いてより高度なエージェント型ワークフローを構築する際のテンプレートとして活用できます。