QueryData 總覽

QueryData 可讓您使用對話式語言和資料代理與資料互動，協助您查詢資料。資料代理是 AI 輔助的助理和應用程式，可理解使用者意圖、查詢營運資料，並傳回準確、有依據的答案。QueryData 會使用情境集為資料庫生成查詢，情境集是精選藍圖、商業邏輯和結構定義資訊的集合。QueryData 會根據這些背景資訊，將自然語言問題轉換成準確的查詢，滿足目標用途的需求。

QueryData 的使用時機

QueryData 適合用於下列應用程式：

  • 客戶服務自動化：處理大量查詢，例如「我的訂單在哪裡？」或「我目前的餘額是多少？」。
  • 電子商務購物助理：協助使用者以自然語言查詢大型產品目錄，例如「顯示 $100 美元以下的跑鞋」。
  • 現場作業工具：讓行動員工即時查詢庫存量、零件供應情形或服務單詳細資料。

核心概念

為確保能將對話式問題準確轉譯為資料庫查詢，QueryData 採用下列重要概念：

QueryData 和 Conversational Analytics API

Conversational Analytics API 中的 QueryData 端點是一項代理工具，可讓您以程式輔助方式，將自然語言轉換為資料庫的 SQL 查詢。在對話式應用程式或 Agentic Workflows 中，QueryData 端點會處理結構定義解讀和查詢合成。您的代理駕馭系統 (例如 Antigravity、Agent Development Kit (ADK) 或 LangChain) 會管理對話記錄、使用者狀態和工具自動化調度管理，以便在將自然語言要求傳送至 QueryData 端點前，先瞭解使用者的輸入內容。

脈絡資料集

情境集是與資料庫執行個體相關聯的資料庫特定知識、精選查詢模式和業務規則的集合。QueryData 不會只依賴一般 LLM 知識或原始表格結構定義，而是會使用情境集瞭解資料模型和貴機構專屬術語的細微差異。

情境集包含三個主要構成元素：

  • 查詢藍圖：精選一組代表性的自然語言問題，以及對應且預先驗證的 SQL 查詢。藍圖提供標準範例，定義特定商家意圖如何對應至 SQL 陳述式。
  • 查詢面向：模組化 SQL 述詞和篩選條件 (例如日期範圍、門檻計算或業務標記)。Facet 可讓 QueryData 將多個篩選條件動態合併至查詢，不必為每個組合建立個別藍圖。
  • 值搜尋：語意和字串比對查詢，可將非正式詞組對應至資料庫資料欄中儲存的確切值。值搜尋會使用完全比對、三字母組字串相似度或語意向量嵌入，協助解決模稜兩可的問題 (例如將「Bay Area」對應至 San Francisco，或將「Heathrow」對應至 London Heathrow Airport)。

參數化安全檢視區塊

為確保 AI 生成的查詢符合資料列層級安全性和多租戶隔離機制，您可以使用參數化安全檢視，限制生成的 SQL 只能存取已驗證應用程式使用者有權查看的資料列。詳情請參閱「使用參數化安全檢視畫面，確保應用程式資料安全並控管存取權」。

QueryData 的運作方式

當代理程式或應用程式傳送自然語言要求 (例如代理程式根據對話記錄或使用者狀態，將使用者問題脈絡化)，QueryData 會執行下列步驟：

  1. 值解析：QueryData 會對資料庫執行值搜尋查詢，將提示中的實體 (例如名稱、城市或類別) 對應至特定資料庫欄值。
  2. 意圖比對和消歧：QueryData 會根據您在情境集中定義的精選查詢藍圖和面向，比對情境化要求。如果要求不夠明確或模稜兩可，QueryData 可以傳回釐清問題，讓代理或應用程式要求使用者釐清。
  3. 查詢合成：QueryData 會使用相符的藍圖結構、套用的層面和已解析的值，為資料庫引擎合成完整的 SQL 查詢。
  4. 查詢執行：對資料庫執行生成的查詢，傳回結果。

建立及管理脈絡資料集

如要製作及管理內容集，請按照下列步驟操作：

  1. 編寫情境：定義資料庫的查詢藍圖、切面和值搜尋。詳情請參閱「情境集總覽」。 您也可以使用脈絡工程代理，自動建立脈絡。
  2. 在 Google Cloud 控制台管理：在 Cloud SQL Studio 建立及管理情境集，以便用於生成查詢。
  3. 與應用程式整合：使用 MCP Toolbox 或直接呼叫 API，將應用程式或 AI 代理連結至 QueryData。

定價

建立內容集並搭配資料代理程式或資料庫資料來源使用 QueryData 時，系統會按照 MySQL 適用的 Cloud SQL 計算價格，針對執行的查詢向您收費。在預先發布期間，建立及使用脈絡資料集和 QueryData 不會產生額外費用。詳情請參閱「Data Cloud 代理定價」。

後續步驟