Skip to content
Last updated

ナレッジベースのクエリ

AIプロジェクト用のナレッジベースを作成した後、期待するデータがあることを確認するためにいくつかのクイッククエリを実行したいでしょう。

クエリシミュレーション

このトピックには以下が含まれます。

Detailsタブを選択して、ナレッジベースの設定を確認できます

ナレッジベースをシミュレートするには、Testタブを選択します。

列リストシミュレーションの例

列リスト

テーブル名を入力します

スキーマ検索シミュレーションの例

検索するキーワードを入力します

データ直接クエリシミュレーションの例

実行するSQLステートメントを入力します

クエリ結果フォーマットの理解

データベースナレッジベースは、Markdown-KVJSONの2つの結果フォーマットをサポートしています。ナレッジベース作成時に選択したフォーマットによって、Testタブでのクエリ結果の表示方法が決まります。

Markdown-KV形式

Format TypeとしてMarkdown-KVを選択した場合、クエリ結果は見出しとキー・バリューペアで構成された、構造化された読みやすい形式で返されます。

列リストの例:

Markdown-KV形式の列リスト結果

結果には、データベースとテーブル情報、各列の詳細が構造化された形式で表示されます:

# Database "retail_demo"
## Table "customer_profiles"
### Column 1
name: customer_id
type: varchar
comment:
### Column 2
name: first_name
type: varchar
comment:

データ直接クエリの例:

Markdown-KV形式のクエリ結果

例えば、以下のクエリを実行すると:

SELECT customer_id, first_name, last_name, city, state 
FROM customer_profiles 
LIMIT 1

次のような形式で結果が返されます:

# Records
## Record 1
customer_id: CUST-00613
first_name: Aiden
last_name: Hernandez
city: San Diego
state: CA

切り捨て警告:

クエリ結果がMax rows制限を超えた場合、AIエージェントが結果が不完全であることを認識できるよう、警告メッセージが自動的に追加されます:

Markdown-KV形式の切り捨て警告

例えば、Max rowsが2に設定されているときに、より多くのレコードを取得しようとすると、以下の警告が表示されます:

# Warning
[TRUNCATED] Results limited to 2 rows. To retrieve more data, add pagination 
to your SQL query using OFFSET N LIMIT M (OFFSET must come before LIMIT), 
or add WHERE conditions to narrow the results.

この警告により、AIエージェントはページネーションまたは追加のフィルタリング条件を使用してクエリを絞り込むよう促されます。

JSON形式

Format TypeとしてJSONを選択した場合、クエリ結果は従来のJSON形式で返されます。これは以前のバージョンのナレッジベース機能と同様です。

主な違い

機能Markdown-KVJSON
結果の可読性高 - 見出しとキー・バリューペアで構造化中 - 標準的なJSON配列
切り捨て認識結果が切り捨てられた際にエージェントが明示的な警告を受け取る明示的な警告なし
テーブルフィルタリング利用不可 - データベース内のすべてのテーブルが含まれるTable設定経由で利用可能
Max rows / Timeout設定完全サポート制限あり、または無視される

次のステップ

エージェントの作成