ふくふくHukuhuku LLC
EP.39AI Basics 11分公開:

NVIDIA Kumo Relationalとは? 顧客・注文の表から予測するAIと、導入前のデータ点検

複数の業務テーブルから解約や需要を予測するKumo Relational。LLM・SQLとの役割の違い、MacのクライアントとGPU推論の区別、外部送信、未来の情報が混ざる評価ミスを解説します。

#業務AI#データ基盤#NVIDIA#予測モデル
執筆 / 監修
松尾 亮合同会社ふくふく 代表社員

データ基盤・データパイプライン構築 / BI / 生成 AI 活用支援を専門とするエンジニア (28 年)。 本記事は AI 利用ポリシーに基づき、生成 AI の補助で執筆 → 人間が監修・編集して公開しています。

プロフィール詳細
シェア
ATTENTION:学習不要でも、データの準備と評価は必要

Kumo Relationalは、顧客・注文・商品などの関連する表を使う予測モデルです。「新しい用途ごとにモデルを学習し直さなくてよい」ことと、「正解例もデータ整備も不要」なことは違います。本稿は公式仕様を確認した解説で、製品の予測精度を実測した記事ではありません。

NVIDIAは2026年10月21日付の紹介記事で、業務データベースから予測するKumo Relationalを説明しました。同日のAgent Toolkitの発表でも、企業データを扱うKumoモデル群が紹介されています。営業や在庫管理で「過去の集計の次に、これから起こることを知りたい」ときの選択肢です。 紹介記事の公開日時メタデータは10月21日18時26分UTC、日本時間では22日3時26分です。

ただし、10月21日を重みの初公開日とは扱いません。モデルのコミット履歴には9月28日付の「Release Kumo Relational」があり、最初に一般利用可能になった正確な時刻は未確認です。今回は10月21日の説明・企業向け発表を受け、導入時の判断材料を整理します。

SQLの集計、LLMの説明、予測モデルの役割を分ける

やりたいこと主な役割出力の例
先月の商品別売上を知るSQL・BIで記録済みの事実を集計商品別の金額と件数
集計結果を担当者向けに説明するLLMが文章を作る。数値は元データと照合増減要因の説明案
来月購入しそうな顧客を選ぶ予測モデルが過去の関係と結果から推定購入する確率や優先順位

これは編集部による役割整理です。LLMにCSVを渡してもっともらしい文章が返ってきても、それだけで予測精度が検証されたことにはなりません。Kumo Relationalは会話文を生成する汎用LLMではなく、関連するテーブルと正解付きの過去例を使う基盤モデルです。エージェントの部品として利用する場合も、問い合わせの作成、数値の推定、結果の説明、実際の業務操作を分けて設計します。

「複数の表の関係」を予測に使う仕組み

公式の仕組み解説では、主キー・外部キーなどの関係を使って行どうしを結び、予測に必要な過去の行を選びます。主キーは行を見分けるID、外部キーは別の表の行を指すIDです。注文のcustomer_idが顧客のidを指す、と考えると分かりやすくなります。

架空の表主な列役割
customerscustomer_id、登録日時予測する顧客を識別
ordersorder_id、customer_id、注文日時顧客の過去の購入行動を結ぶ
order_itemsorder_id、product_id、数量注文と商品をつなぐ
productsproduct_id、商品分類どんな商品を買ったかを補う

架空の小売業で「9月1日時点で、今後30日以内に再購入する顧客」を考えます。予測したい顧客だけでなく、以前のある時点の顧客情報と、その後に再購入したかどうかが既に分かっている例を用意します。この過去例を文脈として与える方法がin-context learningです。標準の使い方では、この都度の例のためにモデルの重みを更新する必要はありません。

モデルカードは、KumoRFM-2を基に、行の表現と関係をたどる処理を組み合わせる分類・回帰モデルと説明しています。NIMの概要では予測期間を持つ数値予測や関連候補のランキングも案内されています。モデル重みのAPIと、周辺エンジンを含むサービスの機能を同じ一覧として扱わないことが大切です。

日本の業務では、まず一つの判断を支援する

試用案(実績ではありません)決める対象先に決める評価
再購入見込みを使う営業支援連絡候補の上位100社上位候補の実購入率、既存ルールとの差
商品ごとの需要予測次の一定期間に売れる数量予測誤差、欠品と過剰在庫の偏り
解約の兆候を調べるサポート担当が確認する候補見逃しと誤検知、対応できる件数

最初から予測値に従って自動発注や一斉連絡をする必要はありません。既存の担当者判断と並べて候補を表示し、どこで役立ち、どこで外すかを確認します。確率が高い人への連絡で売上が増えるかは、購入確率の評価とは別の問題です。施策の効果を知りたい場合は、比較できる対象群を用意するなど、別の検証が必要です。

導入経路は二つ。Mac対応とMac単体推論は別

経路何を動かすか導入条件・注意
structured-data-modelsで直接推論Pythonでモデルと入力テーブルを扱う公式READMEはPython 3.11以上・PyTorch 2.7以上。公式例はCUDAを指定
Kumo Relational ClientからNIMを呼ぶクライアントがグラフと文脈を用意し、NIMが予測Python 3.10〜3.13。接続可能なNIMが別途必要

直接推論用ライブラリとNIMへの接続手順は異なる入口です。後者のrelationalエンジンの対応表はLinux x86-64/ARM64、macOS 11以降のIntel/Apple silicon、Windows x64で、Windows ARM64は対象外です。Macでクライアントが動くことは、MacだけでNIMのGPU推論を動かせることを意味しません。NIMの自己ホストは、対応するNVIDIA GPUホストとその配備手順を確認します。

日本語の顧客名や商品名を含む実データでの精度、日本語の自由文指示をPQLへ変換する品質は、本稿では未検証です。PQLは予測対象や期間を記述するSQLに似た言語で、日本語チャット欄そのものではありません。既存のID・数量・日付から始め、表記ゆれや文章列が結果に与える影響は別に測ります。

確認したモデルカードでは重みはOpenMDW 1.1、ライブラリのNVIDIA作成部分はApache 2.0です。ライセンスは別々に確認してください。計算機、保管領域、配備・運用の費用まで無料とは限りません。本稿ではAPIの料金、無料枠、日本からの契約条件を実契約で確認していないため、定額や無制限無料とは案内しません。

「データを動かさない」という紹介だけで外部送信を判断しない

公式の処理説明には、リクエスト用に選んだレコードをNIMの接続先へ送ると明記されています。DB全体を移さない構成でも、予測に使う行がどこへ渡るかは確認が必要です。社内に置いたNIMと、外部のホスト型エンドポイントでは境界が異なります。匿名化した教材データから始め、実データを使う前に接続先・利用権限・保存やログの扱いを担当者が確認します。

認証にも差があります。接続手順によると、NVIDIA API CatalogはBearer認証ですが、RelationalClientのapi_keyはX-API-Keyとして送られます。CatalogのURLとキーをそのままこのクライアントへ渡す方法では直接認証できません。Catalogは公式REST例、RelationalClientは自己ホストNIMまたは互換ゲートウェイの手順を使い分けます。

確認時点の紹介ブログにはstructured-data-models-client/SDMClientを使う例もあります。本稿のNIM接続の説明は、上記の公式接続文書にあるkumo-relational-client/RelationalClientに沿っています。クラス名、引数、認証方式を異なる資料からつなぎ合わせず、採用するパッケージの版と対応する手順を揃えてください。

最初の試用は、接続確認と精度評価を分ける

  1. 1対象業務を一つに絞り、予測対象のID、予測時点、何日先を見るか、何を正解とするかを書き出す。
  2. 2表ごとの主キー・外部キー・時刻列を点検する。欠損や重複、後から修正された履歴の扱いを決める。
  3. 3導入経路を選ぶ。NIM経路では先に利用可能なエンドポイントと認証方式を確認し、その後でクライアントを入れる。
  4. 4公式Quickstartの小さな架空表で、グラフの作成から予測結果の受け取りまでを確かめる。
  5. 5十分な履歴を使い、過去の時点から未来を予測する評価を実施する。既存ルールや既存モデルと同じ期間・対象で比較する。
  6. 6精度だけでなく待ち時間、費用、データ送信範囲、人が確認する件数を記録し、小さな業務から導入可否を決める。

公式Quickstart自身も、小さな表はAPIの確認用であり、予測品質を評価するだけの履歴ではないと注意しています。「結果が返った」と「仕事で使える精度だった」は分けて記録しましょう。コードやパッケージは更新されるため、試用時のバージョンとモデルのリビジョンも残します。

手元で試せる教材:未来の情報が混ざる失敗を見つける

下の教材は編集部が作成したPython標準ライブラリだけの例です。Kumoを呼ばず、ネットワークにも接続しません。2026年9月1日0時UTCの予測を想定し、注文が起きた時刻だけでなく、システムで利用できるようになった時刻も点検します。

架空レコード内容9月1日の入力としての扱い
o18月28日に発生し、同日に利用可能使える
o29月2日に発生未来なので使えない
o38月31日に発生したが、9月3日に到着当時は未入手なので使えない
h2という過去例結果を判定する期間が9月15日まで続く9月1日には正解が確定していない

時刻境界を点検するPython教材を保存して、次の二つを実行できます。Python 3.10以降を想定しています。

2行目は意図的な失敗例で、終了コード1になります。
Bash
python3 ab-39-kumo-time-boundary-demo.pypython3 ab-39-kumo-time-boundary-demo.py --unsafe
教材の実行確認結果。モデルの予測結果ではありません。
Text
通常実行:query_records=1context_examples=1time_boundary_check=PASS
--unsafe:query_records=3context_examples=2time_boundary_check=FAIL: o2,o3,h2

後から届いたデータまで過去の評価に混ぜると、実運用ではできなかった予測ができたように見えます。この教材はその一部を示す簡略例です。すべてのデータ漏れを検出するものではなく、過去例ごとの入力時点、顧客の重複、更新履歴、正解列の紛れ込みは実データ側で別に検査します。

性能の数字は、条件を揃えてから読む

NVIDIAの紹介記事は15データベース・41タスクでの評価を報告しています。ただし提供元の評価であり、ふくふくが日本企業のデータで比較実測した結果ではありません。同記事も、非常に大きな訓練データがある場合には個別に学習する方式が上回り得ること、予測に効く情報へ限られた関係のたどり方で到達できる必要があることを挙げています。

導入判断では「最高精度」という一言より、自社の対象期間で既存の方法と比べます。再購入の分類なら見逃し・誤検知・上位候補の実購入率、数量予測なら誤差の大きさと過小予測の偏りを確認します。季節や施策が変わった期間も分けて測り、予測が外れたときの扱いまで決めると、試用の価値が判断しやすくなります。

担当者とLLMに渡す、予測案件の整理文

編集部作成の検討用指示文。機密の生データや認証情報は貼り付けません。
Text
あなたは業務データの予測案件を整理する担当です。次の匿名化済みテーブル定義だけを使い、実データへの接続や外部送信は行わず、確認事項を整理してください。1. 予測対象のID、予測時点、予測期間、正解の定義を表にする。2. 主キー・外部キー、発生時刻・利用可能時刻・更新履歴を確認し、不明を残す。3. 予測時点より未来の情報や未確定の正解が混ざる可能性を列挙する。4. SQLによる既存ルールとの比較方法、評価期間、誤検知・見逃しの確認方法を提案する。5. ローカル推論、社内NIM、外部エンドポイントでデータが渡る境界を整理する。6. モデルの精度や日本語対応を推測せず、試用で確かめる項目にする。

確認日:2026年10月22日。参照したstructured-data-modelsのPyPI版は0.2.1、モデルカードのリビジョンはefdbb110daea5aae123447864a64612e8a3dc6beです。資料と教材の動作を確認しました。KumoのAPI・GPU推論、日本語精度、実業務での効果は未実測です。

よくある質問

Kumo RelationalはChatGPTのようなLLMですか?
汎用の対話LLMではなく、関連する表と過去の正解例から分類や数値予測を行う基盤モデルです。LLMやエージェントと組み合わせる場合も、それぞれの役割を分けます。
Macにクライアントを入れればローカル推論できますか?
クライアント対応と推論ホストの対応は別です。NIM経路は接続できる推論サービスが必要です。直接推論ライブラリの公式例はCUDAを使い、Mac単体での推論は本稿では検証していません。
学習不要なら正解データや評価も不要ですか?
いいえ。標準のin-context learningは過去の正解例を文脈として使います。未来の情報が混ざらないように評価し、既存の方法と比べて導入を判断します。
シェア

この記事の感想を教えてください

あなたの 1 クリックで、本当にこの記事は更新されます。「もっと詳しく」「続編希望」が一定数集まった記事は、 ふくふくが 実際に内容を拡充したり続編記事を公開 します。 送信したリアクションはお使いのブラウザに記録され、再カウントされません。

シリーズの外も探す:

まずは、現状を聞かせてください。

要件が固まっていなくて大丈夫です。現状診断と方針提案までを無料でお手伝いします。

無料相談フォームへ hello [at] hukuhuku [dot] co [dot] jp