Add Azure SQL tables as a knowledge source

當你將 Azure SQL 資料表整合為知識來源時,你的代理程式是建立在 Azure SQL 資料庫中結構化資料的基礎上。 您的客服人員可以透過您選擇的資料表中,利用製作者可用的連線憑證和權限來回答問題。

Note

要將 Azure SQL 資料表加入知識來源,您必須擁有存取底層資料庫和資料表的權限。 缺少或不足的權限可能會在設定時阻止伺服器、資料庫或資料表被看見或選擇。

先決條件

  • 一個 Azure SQL Database 或 Azure SQL 受控執行個體,你的組織可以從 Power Platform 存取。

  • 可以連接資料庫並讀取你計畫新增的資料表的憑證(例如 Microsoft Entra ID 或 SQL 認證,視連線設定而定)。

  • 存取 Copilot Studio 並授權編輯代理。

  • 網路存取已設定,讓 Power Platform 能存取你的 Azure SQL 伺服器。 例如,允許 Azure 服務的防火牆規則,或依組織要求的私人連線。

權限與認證

Azure SQL 知識是利用你在設定時建立或選擇的 Power Platform SQL 連線。 執行時,代理依賴代理使用者的 Microsoft 認證及透過該連線路徑獲得的存取權限。

  • 使用者只能根據製作者可透過設定的連線與資料庫權限存取資料獲得答案。

  • 如果設定時沒有顯示資料表,請確認連線在 Copilot Studio 外是否成功,且帳號能列出並讀取這些資料表。

準備你的 Azure SQL 資料庫

Copilot Studio agents 支援 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. 找出一個或多個表格加入。 如果需要,可以用搜尋欄縮小範圍,然後選擇你想讓客服人員使用的表格。

    Note

    只新增客服人員需要的資料表來回答使用者問題。 使用名稱清晰且欄位名稱清晰的資料表,讓客服人員能更可靠地解讀資料。

  7. 查看知識名稱和描述。 提供詳細 描述,因為描述有助於代理的協調,並幫助代理理解知識來源的上下文。

  8. 選取 加入至代理 以完成加入知識來源。

在你加入知識來源之後

加入 Azure SQL 後:

  • 確認知識來源是否出現在代理的 知識 頁面上,連同你選擇的連線和所選資料表。

  • 發佈代理人,讓知識來源能在已發佈的經驗中取得。

  • 用應該從選定表格中回答的問題來測試你的代理人。 例如,「顯示上個月銷售額排名前五的客戶。」如果回傳的結果是空的或錯誤的,請確保資料表包含預期資料,且查詢內容與你的結構一致。

Tip

在 Azure SQL 中建立一個診斷視圖,回傳一個小型且已知的資料集。 使用這個資料集確認連線是否正常,再使用生產資料表。

提升答案品質

清晰的命名與描述有助於代理了解何時以及如何使用您的 Azure SQL 資料。

  • 使用反映商業領域的特定知識來源名稱(例如「Customer orders – Azure SQL」),而非通用標籤。

  • 撰寫詳細描述 ,說明資料表包含哪些資料、它們回答了哪些商業問題,以及任何重要的篩選條件或關聯。

  • 只選擇相關的表格。 額外的資料表會稀釋接地,讓客服人員更難選擇正確的資料。

  • 偏好可讀的結構模式。 帶有商業友善名稱的表格和欄位通常比模糊的技術名稱更能獲得更好的回應。

範例描述

以下範例展示了有助於生成式協調選擇正確知識來源的描述類型:

Azure SQL knowledge for Contoso order management. 包含客戶、訂單及訂單線表格。 使用此資源詢問訂單狀態、訂單歷史、顧客購買、訂購數量,以及按客戶或日期劃分的收入。 不要用來存放庫存或追蹤運送人。