**🔑 主キー**: `商品番号 (ProductID)`\
**🔗 外部キー関連**: なし
### シナリオ 1：未完了の注文を追跡する
* **データベースの状態：** `Orders` テーブルには、まだ完了していない注文が 2 件あり、それぞれ `OR003` と `OR004` です。
* **自然言語の入力：** AI アシスタントの問い合わせで、「まだ完了していない注文を教えてください」と入力するだけです。AI アシスタントが自動的にツールを呼び出し、SQL の構造化クエリ文を生成します。
* **Supabase の自動クエリ：** AI アシスタントは自動的に Supabase ツールを呼び出し、お客様の自然言語を SQL クエリ文に変換します。例：
クエリ結果の応答と AI アシスタントの分析を総合し、AI アシスタントは以下の注文内容を優先度順に並べ替えて応答します。
Supabase ツールと AI アシスタントの協調により、未完了の注文を簡単に追跡でき、AI アシスタントが提供する分析と並べ替えの提案を得られます。これにより、注文をより効率的に処理し、顧客満足度を高めることができます。
### シナリオ 2：未完了注文の顧客連絡先情報を照会する
* OR003 はまだ処理中の注文で、顧客は CU003、担当者は**黄採購**です
* **自然言語の入力：** AI アシスタントの問い合わせで、「まだ処理中の注文について、誰に連絡すればよいですか」と入力します。AI アシスタントが自動的にツールを呼び出し、SQL の構造化クエリ文を生成します。
* **Supabase の自動対応クエリ：**AI アシスタントとの対話内容はすべて注文テーブルに属するものですが、設定した外部キーの対応関係により、Supabase はここでの `Customer ID` が `Customers` テーブルの `ID` に対応していることを認識できます。そのため、返される内容は `Customers` テーブルの内容になります。
* **AI アシスタントの応答：**ߙいて AI アシスタントが総合的に分析し、正しい担当者情報とその他の連絡方法を応答します
Supabase ツールを使えば、データベース内のテーブル間の対応関係を十分に活用し、複数の関連テーブルから情報を簡単に抽出して、AI アシスタントが提供する顧客名の一覧を得ることができます。テーブル間の対応関係と明確な定義により、データの関連性と一貫性が確保され、クエリ結果がより信頼できるものになります。
## **補足：**
* 実際のニーズに応じて自然言語の入力を調整できます。たとえば「今日まだ完了していない注文を教えてください」「VIP 顧客のまだ完了していない注文を教えてください」など、Supabase ツールはいずれも正確に解析してクエリを実行できます。
* AI アシスタントは、在庫状況や物流情報など、その他の情報をさらに統合し、より包括的な注文分析を提供できます。
{% hint style="warning" %}
ツールはデータベースに保存された内容のみを呼び出せます。分析が必要な場合は、必ずデータをデータベースにアップロードしてから分析を開始してください。
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/tools/text-to-sql-supabase.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.