コンテンツにスキップ

LLMステップは、ワークフローの1つのステップとして、大規模言語モデルに対してプロンプトを実行します。プロジェクト内の特定のテーブル、ディメンション、ドキュメントへのアクセス範囲を限定してモデルに与え、オブジェクトごとに読み取り、書き込み、またはその両方を選択します。モデルは必要なデータを読み取り、書き込みを許可した場合は、選択したオブジェクトに結果を直接書き戻します。出力形式を別途設定する必要はありません。書き込みが有効なバインディングが、そのままステップの出力になります。

よくある使い方は、財務テーブルを事業部門ごとのコメントに要約し、書き込みアクセスでバインドした結果テーブル(またはドキュメントファイル)に、そのコメントをモデルに書き込ませることです。

次のものが必要です。

  • LLM接続。 このステップには、種類がLLMの接続(たとえばAnthropic)が必要です。接続には、プロバイダーのAPIキー、任意のデフォルトモデル、エージェントアクセスレベルが保持されます。詳しくは接続を参照してください。
  • 接続への書き込みアクセス(書き込みが有効なバインディングがある場合のみ)。 バインディングが書き込みできるのは、接続のエージェントアクセスが読み取りと書き込みの場合のみです。完全は非推奨で、2027年1月15日に削除されます。読み取り専用の接続では、書き込みバインディングは保存時に拒否されます。
  • 作成済みの出力先オブジェクト。 モデルは、選択したオブジェクト(既存のテーブル、ディメンション、ドキュメントアカウント)に書き込みます。先に出力先を作成してバインドしてください。このステップは新しいオブジェクトを作成しません。
  1. ワークフローを開き、Analyze Stepsタブに移動します。
  2. 標準的な変換を追加するときと同じ方法で、希望する位置にステップを追加します。
  3. ステップタイプとしてLLMステップを選択します。エディターが開き、LLMリクエスト、Bindings、制限の3つのセクションが表示されます。

LLMリクエストグループでは、次の項目を設定します。

  • LLM接続 (必須) — ステップが使用するLLM接続。
  • モデル (任意) — claude-opus-4-7などの特定のモデル名。空欄にすると、接続のデフォルトモデルが使用されます。
  • プロンプト (必須) — モデルに送信する指示。バインドしたオブジェクトは、{{tables.NAME}}、{{dimensions.NAME}}、{{documents.NAME}}でインラインに参照できます。各参照は、後述のバインディングのいずれかと一致している必要があります。何をどこに書き込むかをモデルにわかりやすく伝えてください(例:「事業部門ごとに1行をsummaryテーブルに書き込む」)。
  • Result schema (Anthropic接続では任意、他のプロバイダーでは必須) — 実行の構造化サマリーを記録として取得するためのJSONスキーマ。指定する場合、ルートは"type": "object"のJSONオブジェクトである必要があります。Anthropic接続では、モデルの実際の作業がMCP経由の書き込みである場合は空欄にできます。他のプロバイダーはMCPにアクセスできず、構造化されたレスポンスが唯一の出力になるため、スキーマが必須です。

プロジェクトデータのバインド

Section titled “プロジェクトデータのバインド”

Bindingsセクションでは、アクセスを許可し、ステップが読み取りおよび書き込みできる対象を選択します。テーブル、ディメンション、ドキュメントの3つのグループがあり、それぞれに追加ボタンがあります。各行には次の項目があります。

  • オブジェクトを選択するセレクター。テーブルピッカー、ディメンションピッカー、または(ドキュメントの場合)アカウントとパスのブラウザーです。IDを手入力する必要はありません。
  • 名前 — プロンプトで参照するラベル({{tables.NAME}})。
  • 読み取りと書き込みのチェックボックス。読み取りをオンにするとモデルがオブジェクトを読み取れ、書き込みをオンにするとオブジェクトに書き込め、両方もオンにできます。少なくとも一方は常に設定されます。
  • ドキュメントの場合は、pdfなどの形式のヒント。

MCPツールを通じて、モデルが各種類に書き込む方法は次のとおりです。

バインディング モデルの書き込み方法
テーブル(書き込み) 行の挿入。通常は、バインドしたテーブルに追加する行を生成するSELECTを使います。
ディメンション(書き込み) バインドしたディメンションの階層にあるノードの追加または更新。
ドキュメント(書き込み) バインドしたドキュメントアカウントとパスへのファイルのアップロード。

制限グループでは、リクエストの上限を設定します。

  • 最大出力トークン数 — モデルが返せる最大のレスポンスサイズ(1,024~128,000、デフォルトは16,000)。
  • 認証情報のTTL(秒) — ステップのアクセス範囲が限定された一時的なデータアクセス認証情報が有効な期間(60~3,600、デフォルトは1,800)。ステップのジョブはこの期間内に制限されるため、モデルが完了するのに十分な長さで、かつ必要以上に長くならないように設定してください。

LLMステップは、他のステップと同様に、ワークフロー全体の実行の一部として、または単独で実行されます(ワークフロー内の1つのステップを実行するを参照)。実行時には、ステップが有効期間の短い、アクセス範囲が限定された認証情報を発行し、プロンプトとバインドしたオブジェクトをモデルに送信します。モデルはMCPツールを通じて直接読み取りと書き込みを行います。認証情報は、ステップが終了すると同時に失効します。モデルの呼び出しは専用のジョブで実行されるため、長時間かかるステップがワークフローランナーを占有することはありません。