# ナレッジベースのクエリ

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

## クエリシミュレーション

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

* [列リストシミュレーションの例](/ja/products/customer-data-platform/ai-agent-foundry/knowledgebase/querying-a-knowledge-base#list-columns-simulation-examples)
* [スキーマ検索シミュレーションの例](/ja/products/customer-data-platform/ai-agent-foundry/knowledgebase/querying-a-knowledge-base#search-schema-simulation-examples)
* [データ直接クエリシミュレーションの例](/ja/products/customer-data-platform/ai-agent-foundry/knowledgebase/querying-a-knowledge-base#query-data-directly-simulation-examples)


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

![](/assets/knowledge-base-details.be1fce016409455ffc3f131bbd59a7d5cdd05aeb31b3e8d1818833d57d059bcf.91c26685.png)

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

![](/assets/knowledge-base-test-tab.cbf883cee5ed1d5ff9f75d29497aa9c51cf56ec31981646440cc40d470a8b8e2.91c26685.png)

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

列リスト

テーブル名を入力します

![](/assets/knowledge-base-list-columns.3813686296fca15161765ff28c170a76565b4443c27ce62e0684653d44d9e220.91c26685.png)

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

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

![](/assets/knowledge-base-search-schema.14fb0c19c2af235561532a9f98b884d5183eaa218e363f73c08d63d1dfc69073.91c26685.png)

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

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

![](/assets/knowledge-base-query-data.949ac83a5176da23e5f6815daeef12dd040cd9eb72880be49aeacded115dbbd0.91c26685.png)

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

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

### Markdown-KV形式

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

**列リストの例:**

![Markdown-KV形式の列リスト結果](/assets/knowledge-base-markdown-kv-list-columns.7bbfd81bd2cf34e5f04c824e7e20d15824363dec5374ef765c9db38057db3cd4.91c26685.png)

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


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

**データ直接クエリの例:**

![Markdown-KV形式のクエリ結果](/assets/knowledge-base-markdown-kv-query-result.95cbbf9b4aead7c2b715eb070660805e584a79c30e656d34c71d933a93a1a313.91c26685.png)

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


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

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


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

**切り捨て警告:**

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

![Markdown-KV形式の切り捨て警告](/assets/knowledge-base-markdown-kv-truncation-warning.df1c07dd7980ba9dd60c59de4a87b6877c87a4bf5410e602d2fc65da2f8029e4.91c26685.png)

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


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


**次のステップ**

[エージェントの作成](/products/customer-data-platform/ai-agent-foundry/ai-agent/creating-an-agent)