---
title: "AIを活用したNLQ設定"
canonical: "https://wiki.yellowfin.co.jp/space/yfcurrent/108855540/AI%E3%82%92%E6%B4%BB%E7%94%A8%E3%81%97%E3%81%9FNLQ%E8%A8%AD%E5%AE%9A"
format: markdown
---
> Macro (toc)

## 概要

このページは、Yellowfinの管理者権限を持つユーザーで、YellowfinインスタンスでAI対応のNLQを設定したい方向けです。設定手順は次のとおりです。

## AI搭載型NLQとは何ですか？

ガイド付き自然言語クエリ（NLQ）では特定の選択肢に基づいて質問要素を入力または選択する必要がありますが、AI搭載のNLQでは質問形式の関連テキストを自由に入力できます。AIエンジンがその質問を解釈し、Yellowfinレポートに変換します。

## ガイド付きNLQの設定手順

ガイド付きNLQの設定に必要な手順は、AI対応NLQの設定にも必要です。これには、ロール、ビュー、フィールドがすべて正しく設定されていることを確認することが含まれます。ガイド付きNLQの設定ガイドは[こちら](https://yellowfinjp.atlassian.net/wiki/spaces/yfcurrent/pages/1906902)を参照してください。

ビューには必ず説明を追加してください。この説明はAIモデルに渡され、追加の文脈を提供し、モデルからより良い回答を得るのに役立ちます。ビューの説明を更新する手順は[こちら](https://wiki.yellowfin.co.jp/space/yfcurrent/1900943/%E3%83%93%E3%83%A5%E3%83%BC%E3%81%AE%E8%A9%B3%E7%B4%B0%E3%81%AE%E7%B7%A8%E9%9B%86)でご確認いただけます。

## AIエンジンに接続する

外部AIモデルへの接続に関する情報は、[こちら](https://wiki.yellowfin.co.jp/space/yfcurrent/187596995/AI%E3%83%A2%E3%83%87%E3%83%AB%E3%81%B8%E3%81%AE%E6%8E%A5%E7%B6%9A)でご確認いただけます。AI-NLQをご利用になるには、モデルへの外部接続設定において以下のチェックボックスを選択し、NLQのデフォルトプロバイダーとしてモデルが設定されていることをご確認ください：

![image-20260309-072805.png](media://8ba9449d-fe12-411c-a975-269c944cae74)

## ガイド付きNLQ AIロールを有効にする

AI対応NLQへのアクセスはロール機能で制御されます。これにより、アクセスを許可するユーザーやグループを正確に指定できます。Yellowfinを古いバージョンからアップグレードする際、ガイド付きNLQユーザーロール機能がオンに設定されているロールに対しては、ガイド付きNLQ AIロール機能も自動的にオンに設定されます。

![image-20250430-045245.png](media://f2fb5053-6da6-4610-91a0-f1d3008c4658)