QueryData 可讓您使用對話式語言,與 Spanner 資料庫中的屬性圖譜資料互動,並建構資料代理。QueryData 會根據屬性圖的結構定義,從自然語言問題生成 Graph Query Language (GQL) 查詢。如要提高用途的準確度,您也可以提供情境組合,也就是查詢範本、查詢面向和值搜尋的集合,用於擷取特定領域的商業邏輯和使用者提出的問題。如要進一步瞭解情境集,請參閱「情境集總覽」。
QueryData 的使用時機
QueryData for Spanner Graph 適合用於下列應用程式:
- 圖表資料對話式助理:支援或分析師助理會透過 QueryData 生成並執行多躍點 GQL 查詢,回答「從帳戶 7 匯出的款項是否在 60 天內退回?」等問題。
- 詐欺、風險和法規遵循調查輔助工具:分析師透過後續問題探索擁有權和轉移網路,而情境設定則可確保「高風險轉移」等字詞在每個答案中保持一致。
- 知識圖譜推論代理:使用 ADK 或 MCP 用戶端建構的代理會呼叫 QueryData 做為工具,根據圖譜中儲存的關係進行推論,例如某人透過中介機構控制哪些帳戶。
核心概念
為確保能將對話式問題準確翻譯成 GQL 查詢,QueryData 採用下列重要概念:
QueryData 和 對話式數據分析 API
對話式數據分析 API 中的 QueryData 端點是代理功能工具,可透過程式輔助方式,將自然語言轉換為 GQL (NL2GQL) 查詢,用於 Spanner 資料庫中的屬性圖。在對話式應用程式或 Agentic Workflows 中,QueryData 端點會解讀結構定義,並為您在每個要求的 graph_ids 欄位中列出的屬性圖合成查詢。您的代理駕馭系統 (例如 Antigravity、Agent Development Kit (ADK) 或 LangChain) 會管理對話記錄、使用者狀態和工具自動化調度管理,在將自然語言要求傳送至 QueryData 端點之前,先為使用者輸入內容提供脈絡。
脈絡資料集
情境集是與資料庫相關的資料庫特定知識、精選查詢模式和業務規則集合。QueryData 不僅仰賴一般 LLM 知識或原始屬性圖結構定義,還會使用情境集來瞭解圖表模型的細微差異和組織專屬術語,例如貴公司在銀行金融圖表中認定的高風險轉移。本指南中的範例使用 FinGraph 屬性圖表結構定義和範例資料集。如要建立 FinGraph 結構定義並插入樣本資料,請參閱「設定及查詢 Spanner Graph」。
情境集包含三個主要構成元素:
- 查詢範本:精選的代表性自然語言問題,以及對應且預先驗證的 GQL 查詢。範本提供標準範例,定義特定業務意圖如何對應至 GQL 陳述式 (例如「哪些帳戶收到 Dana 帳戶的轉帳?」如何對應至周遊
Owns和Transfers邊緣的GRAPH FinGraph MATCH查詢)。 - 查詢切面:可重複使用的 GQL 子句 (例如圖表模式、篩選條件、日期範圍、金額門檻,或遭封鎖帳戶等業務條件)。Facet 可讓 QueryData 將多個篩選條件動態合併至查詢,不必為每種組合建立個別範本。
- 值搜尋:語意和字串比對查詢,以
SELECT陳述式形式寫在GRAPH_TABLE上,將使用者問題中的值詞組,與儲存在節點和邊緣屬性中的確切值建立關聯。值搜尋功能會使用完全比對、字串相似度或語意向量嵌入,協助解決語意模糊的問題 (例如將「rainy day」對應至帳戶暱稱Rainy Day Fund,或將「Czech Republic」對應至儲存的值Czech_Republic)。
QueryData 的運作方式
當代理或應用程式傳送自然語言要求 (例如代理根據對話記錄或使用者狀態,提供使用者問題的背景資訊),QueryData 會執行下列步驟:
- 值解析:QueryData 會對 Spanner 資料庫執行值搜尋查詢,將提示中的值詞組 (例如人名、帳戶暱稱或國家/地區) 對應至特定節點和邊緣屬性值。
- 意圖比對和消歧:QueryData 會將情境化要求與您在情境集中定義的精選查詢範本和 facet 進行比對。如果要求不夠明確或模稜兩可,QueryData 會傳回消歧問題,讓代理或應用程式向使用者釐清。
- 查詢合成:QueryData 會使用
graph_ids中列出的屬性圖譜結構定義、相符的範本結構、套用的 facet 和解析的值,合成完整的 GQL 查詢。 - 執行查詢:系統會對 Spanner 資料庫執行生成的 GQL 查詢,並傳回結果。
編寫及管理脈絡資料集
如要建立及管理情境集,請按照下列步驟操作:
- 編寫情境:定義屬性圖的查詢範本、facet 和值搜尋。詳情請參閱「情境組合總覽」。您也可以使用脈絡工程代理,自動建立脈絡。
- 在 Google Cloud 控制台管理:在 Spanner Studio 建立及管理情境集,以便用於生成查詢。
- 與應用程式整合:使用直接 REST API 呼叫,將應用程式或 AI 代理連結至 QueryData,並在
graph_ids中列出目標屬性圖。
後續步驟
- 瞭解 Spanner Graph 的情境集。
- 瞭解如何測試 Spanner Graph 的 QueryData。
- 按照教學課程將 QueryData 與應用程式整合。