總覽
地圖平台代理 UI 工具包是專為對話式 AI 時代設計的開發人員工具包。這項服務提供一系列 LLM 系統指令和 UI 元件程式庫，可協助大型語言模型 (LLM) 和 AI 代理，為地理空間資料建構即時互動式視覺化回覆。
開發人員不必硬式編碼視覺元素，而是使用工具包將 LLM 的「意圖導向指令」轉換為動態、情境感知地圖和地點顯示畫面，讓使用者在對話體驗中保持互動。
常見用途包括：
- AI 助理：為當地查詢 (例如飯店、餐廳) 的文字回覆提供視覺情境。
- 旅遊規劃工具：內嵌顯示地圖、路線和地點詳細資料。
- 低程式碼開發：減少手動自動化調度管理多個 Maps API 時的摩擦。
核心概念
1. 可供服務專員使用的 UI
啟用可擴充的高品質圖像，例如地點資訊卡、沉浸式地圖檢視畫面和路線預覽，專為即時 LLM 輔助體驗設計。
2. 情境豐富的體驗
讓使用者不必離開即時通訊，就能探索及決定要採取的行動。提供豐富的內嵌地圖內容 (例如相片庫、評分或路線選項)，可讓使用者保持參與度，並有信心採取行動。
3. 智慧型元件
Agentic UI 工具包會自動處理複雜的地理空間邏輯，即時根據使用者意圖調整情境和版面配置，同時設定樣式，確保每次互動都與您的品牌相關。
4. 不受特定 LLM 限制
Agentic UI 工具包不依賴 AI 堆疊的特定模型。無論您使用 Gemini、OpenAI 或 Anthropic 的模型，以及無論您使用哪個基礎資料來源，Agentic UI 工具包都會提供專屬的呈現層，以便顯示位置資料。
開始使用
如要開始使用 Agentic UI 工具包，您需要使用單一 API 金鑰初始化工具包。這會抽象化基礎地圖服務，因此您不需要管理個別的 API。
如需詳細操作說明，請參閱「入門指南」。
UI 結果
代理式 UI 工具包提供一整套專門的 UI 功能，可直接使用。
- 地點詳細資料 (精簡)：精簡資訊卡中的特定 POI 資訊。
- 內嵌地圖：地點或區域定位器。
- 內嵌地圖 + 路線：導航或行程預覽畫面。
- 內嵌地圖詳細資料：使用豐富的圖像呈現地點氛圍或背景資訊。
系統指示
Agentic UI 工具包提供「系統指令」，引導主機 LLM 瞭解建構 UI 的時機和方式。
規範
主機模型必須瞭解：
哪個元件符合哪個使用者意圖 (例如，使用內嵌地圖處理方向查詢)。
將自然語言對應至結構定義的參數 (例如，如果使用者要求「風景」，請將地圖模式設為衛星)。
工具使用結構定義
代理式 UI 工具包會公開與標準 LLM 工具使用結構定義 (例如函式呼叫) 相容的定義目錄。
政策和服務條款
這個程式庫會使用 Google 地圖平台服務。透過這個程式庫使用 Google 地圖平台服務時，必須遵守《Google 地圖平台服務條款》。部分 API 和後端服務 (例如Grounding Lite和利用 Google 地圖建立基準) 設有附加服務條款規定，您也必須遵守。
這個程式庫並非 Google Maps Platform 核心服務。因此，Google 地圖平台服務條款 (例如技術支援服務、服務水準協議和淘汰政策) 不適用於這個程式庫中的程式碼。
支援
這個程式庫是透過開放原始碼授權提供。不適用於《Google 地圖平台支援技術支援服務指南》、《服務水準協議》或《廢止政策》。不過，程式庫使用的任何 Google 地圖平台服務仍須遵守《Google 地圖平台服務條款》。
Google 地圖來源的註明出處規定
Agentic UI 工具包的每則工具回覆都會附上來源。使用工具包提供的工具呈現結果時，必須以符合下列規定的方式，附上相關的 Google 地圖來源：
- Google 地圖來源必須緊接在來源支援的生成內容後方。
- Google 地圖來源必須在一次使用者互動中顯示。