Add Azure SQL tables as a knowledge source

Azure SQLテーブルを知識ソースとして統合すると、エージェントはAzure SQLデータベースに保存された構造化データに基づいています。 エージェントは、選択したテーブルから取得可能な接続情報と権限を使って質問に答えることができます。

Note

Azure SQLテーブルを知識ソースとして追加するには、基盤となるデータベースやテーブルへのアクセス権限が必要です。 権限が欠如または不足すると、セットアップ時にサーバー、データベース、テーブルが表示または選択できなくなることがあります。

Prerequisites

  • あなたの組織がPower PlatformからアクセスできるAzure SQL DatabaseまたはAzure SQL Managed Instance。

  • データベースに接続し、追加予定のテーブルを読み取れる認証情報(例えば、接続の設定によりますがMicrosoft Entra IDやSQL認証など)を使えます。

  • Copilot Studioへのアクセスとエージェント編集の許可。

  • Power PlatformがAzure SQLサーバーにアクセスできるようにネットワークアクセスを設定してください。 例えば、Azureサービスや組織で求められるプライベート接続を許可するファイアウォールルールなどです。

権限と認証

Azure SQLの知識は、セットアップ時に作成または選択したPower PlatformのSQL接続を利用します。 実行時には、エージェントはエージェントユーザーのMicrosoft認証と、その接続経路を通じて付与されたアクセスに依存しています。

  • ユーザーは、作成者が設定した接続やデータベース権限を通じてアクセスできるデータに基づいてのみ回答を受け取ります。

  • セットアップ時にテーブルが表示されない場合は、Copilot Studio外での接続が成功し、アカウントがそれらのテーブルを一覧化・読み取れるかを確認してください。

Azure SQL データベースを準備してください

Copilot StudioエージェントはAzure SQLデータベースまたはSQL Serverをサポートしています。 テーブルを追加する前に、テーブルの構成が以下のものであることを確認してください:

  • 列名は明確にしつつ、意味不明な略語は避けましょう。 たとえば、CustomerNameではなくCustNmを使用します。
  • 各テーブルごとにプライマリキーが定義されています。 エージェントは主キーを使って行を特定し、結果を返します。
  • 記述的データであり、エージェントがデータの文脈を理解し、より正確に質問に答えるのに役立ちます。 たとえば、OrderDateではなくDate1を使用します。

Add Azure SQL tables to your agent

Azure SQLテーブルを知識ソースとして追加するには、以下の手順を踏みます:

  1. Copilot Studioのエージェントを開いてください。

  2. ビルド タブを選択します。

  3. コンポーネントパネルで 「知識」を選択します。

  4. 知識追加ダイアログでAzure SQL(または環境のラベルに応じてSQL Server)を選択してください。

  5. Azure SQLデータベースへの接続を作成または選択する:

    • まだ接続がない場合は、「 新しい接続を作成 」または 「接続を追加」を選択してください。

    • Azure SQLリソースのサーバー名とデータベース名を入力してください。

    • 組織で要求される認証タイプを選択し、サインインまたは認証情報を入力して接続を作成します。

    • もしすでに接続がある場合は、リストから選択して続けてください。

  6. 追加できるテーブルを1つ以上見つけてください。 必要に応じて検索フィールドでリストを絞り込み、エージェントに使わせたいテーブルを選択します。

    Note

    エージェントがユーザーの質問に答えるために必要なテーブルだけを追加してください。 明確なカラム名の明確な名前のテーブルを使い、エージェントがデータをより確実に解釈できるようにします。

  7. その知識名と説明を確認します。 詳細な 記述を提供しましょう。記述はエージェントのオーケストレーションを助け、知識源の文脈を理解するのに役立ちます。

  8. [ エージェントに追加] を 選択して、ナレッジ ソースの追加を完了します。

知識源を追加した後

Azure SQLを追加した後:

  • ナレッジソースがエージェントの ナレッジ ページに表示され、接続と選択したテーブルが表示されているか確認してください。

  • エージェントを公開して、知識ソースを公開した経験で利用できるようにしましょう。

  • 選んだテーブルから答えられるべき質問でエージェントをテストしてください。 例えば、「先月の総売上で上位5人の顧客を表示してください」といった具合です。結果が空または誤りの場合は、テーブルに期待されるデータが含まれ、クエリがスキーマと整合していることを確認してください。

Tip

Azure SQLで小さな既知のデータセットを返す診断ビューを作成します。 このデータセットを使って接続が正常かどうかを確認し、その後に本番テーブルを使いましょう。

回答の質を向上させる

明確なネーミングと説明は、エージェントがAzure SQLデータをいつどのように使うべきかを理解するのに役立ちます。

  • 一般的なラベルではなく、ビジネスドメインを反映した特定のナレッジソース名(例:「Customer orders – Azure SQL」)を使いましょう。

  • テーブルに含まれるデータ、どのビジネス質問に答えるか、重要なフィルターや関係性について詳細な説明を書きましょう。

  • 関連するテーブルのみを選択してください。 余分なテーブルは接地を薄め、エージェントが適切なデータを選ぶのを難しくします。

  • 読みやすいスキーマを好みます。 ビジネスに親しみやすい名前の表や列は、不明白な技術名よりも一般的により良い反応を生み出します。

例の説明

以下の例は、生成的オーケストレーションが適切な知識ソースを選択するのに役立つ記述の種類を示しています。

Azure SQL knowledge for Contoso order management. 顧客、注文、OrderLinesのテーブルを含みます。 注文状況、注文履歴、顧客購入、注文した商品数量、顧客または日付ごとの収益に関する質問には、このソースをご利用ください。 在庫管理や配送業者の追跡には使わないでください。

  • 最終更新: