Tổng quan
Bộ công cụ giao diện người dùng Agentic của Nền tảng Google Maps là một bộ công cụ dành cho nhà phát triển được thiết kế riêng cho kỷ nguyên AI đàm thoại. Công cụ này cung cấp một bộ chỉ dẫn hệ thống LLM và một thư viện thành phần giao diện người dùng giúp các mô hình ngôn ngữ lớn (LLM) và tác nhân AI xây dựng câu trả lời trực quan, tương tác theo thời gian thực cho dữ liệu không gian địa lý.
Thay vì cố định giá trị cho các thành phần hình ảnh trong mã, bạn có thể sử dụng bộ công cụ này để dịch "hướng dẫn dựa trên ý định" từ một LLM thành bản đồ và màn hình hiển thị địa điểm linh động, nhận biết theo bối cảnh, giúp người dùng luôn tương tác trong trải nghiệm trò chuyện.
Sau đây là các trường hợp sử dụng phổ biến:
- Trợ lý AI: Bổ sung bối cảnh trực quan cho câu trả lời dạng văn bản đối với các cụm từ tìm kiếm về địa điểm, chẳng hạn như khách sạn và nhà hàng.
- Công cụ lập kế hoạch du lịch: Hiển thị bản đồ, tuyến đường và thông tin chi tiết về địa điểm ngay trong câu trả lời.
- Phát triển ít mã: Giảm bớt sự phức tạp khi điều phối thủ công nhiều API Maps trên các điểm tiếp xúc web và thiết bị di động.
Khái niệm chính
1. Giao diện người dùng hỗ trợ tác nhân
Tạo hình ảnh chất lượng cao, có thể mở rộng (như thẻ địa điểm, chế độ xem bản đồ sống động và bản xem trước tuyến đường) được thiết kế riêng cho trải nghiệm theo thời gian thực dựa trên mô hình ngôn ngữ lớn (LLM).
2. Trải nghiệm giàu bối cảnh
Giúp người dùng khám phá và đưa ra quyết định mà không cần rời khỏi cuộc trò chuyện. Cung cấp bối cảnh phong phú về bản đồ cùng dòng, chẳng hạn như thư viện ảnh, điểm xếp hạng hoặc các lựa chọn về tuyến đường, để tăng mức độ tương tác của người dùng và giúp họ tự tin hành động.
3. Thành phần thông minh
Bộ công cụ giao diện người dùng Agentic tự động xử lý logic không gian địa lý phức tạp, ngay lập tức điều chỉnh bối cảnh và bố cục theo ý định của người dùng, đồng thời tạo kiểu để đảm bảo mọi hoạt động tương tác đều có cảm giác gắn kết với thương hiệu của bạn.
4. Không phụ thuộc vào LLM
Bộ công cụ Agentic UI không phụ thuộc vào mô hình trong hệ tầng AI của bạn. Cho dù bạn sử dụng Gemini, các mô hình của OpenAI hay Anthropic và bất kể nguồn dữ liệu có căn cứ của bạn là gì, bộ công cụ này đều cung cấp một lớp trình bày chuyên dụng để trực quan hoá dữ liệu vị trí.
5. Cấu trúc mẫu phía máy chủ
Kiến trúc mẫu phía máy chủ giúp tăng tốc độ kết xuất thành phần bằng cách thực hiện mở rộng mẫu và phân giải tham số ở phía máy chủ. Điều này giúp cải thiện độ trễ cho trải nghiệm đàm thoại theo thời gian thực.
Bắt đầu
Để bắt đầu sử dụng bộ công cụ Agentic UI, bạn cần khởi chạy bộ công cụ này bằng một khoá Google Gemini API và một khoá Google Maps Platform API.
Để biết thêm thông tin, hãy xem phần Bắt đầu.
Kết quả giao diện người dùng
Bộ công cụ Agentic UI cung cấp một bộ tính năng giao diện người dùng chuyên biệt toàn diện ngay từ đầu. Các thành phần này có trên web, Android và iOS.
- Chi tiết địa điểm, thu gọn: Thông tin cụ thể về địa điểm yêu thích (POI) trong thẻ thu gọn
- Bản đồ cùng dòng: Bộ định vị điểm hoặc khu vực
- Bản đồ cùng tuyến đường: Bản xem trước tuyến đường hoặc thông tin chỉ đường
- Chi tiết bản đồ cùng dòng: Thông tin chi tiết hoặc bối cảnh về vị trí bằng hình ảnh phong phú
Chỉ dẫn hệ thống
Bộ công cụ Agentic UI cung cấp "hướng dẫn hệ thống" để hướng dẫn LLM lưu trữ về thời điểm và cách xây dựng giao diện người dùng.
Nguyên tắc
Mô hình lưu trữ phải hiểu được các khái niệm sau:
- Cách so khớp các thành phần với ý định của người dùng, chẳng hạn như sử dụng Bản đồ cùng dòng cho các truy vấn về đường đi.
- Cách liên kết các tham số từ ngôn ngữ tự nhiên với giản đồ, chẳng hạn như đặt chế độ bản đồ thành vệ tinh nếu người dùng yêu cầu "phong cảnh".
Lược đồ sử dụng công cụ
Bộ công cụ Agentic UI cung cấp một danh mục các định nghĩa tương thích với lược đồ sử dụng công cụ LLM tiêu chuẩn, chẳng hạn như lệnh gọi hàm.
Chính sách và Điều khoản dịch vụ
Thư viện này sử dụng các dịch vụ của Google Maps Platform. Việc sử dụng các dịch vụ của Google Maps Platform thông qua thư viện này phải tuân theo Điều khoản dịch vụ của Google Maps Platform. Một số API và dịch vụ phụ trợ, chẳng hạn như Grounding Lite và Grounding với Google Maps, có các yêu cầu bổ sung trong Điều khoản dịch vụ mà bạn cũng phải đáp ứng.
Thư viện này không phải là một Dịch vụ cốt lõi của Google Maps Platform. Do đó, Điều khoản dịch vụ của Google Maps Platform (chẳng hạn như Dịch vụ hỗ trợ kỹ thuật, Thoả thuận mức độ dịch vụ và Chính sách về việc ngừng cung cấp) không áp dụng cho mã trong thư viện này.
Hỗ trợ
Thư viện này được cung cấp thông qua giấy phép nguồn mở. Phiên bản này không chịu sự điều chỉnh của Nguyên tắc về dịch vụ hỗ trợ kỹ thuật của Google Maps Platform, Thoả thuận mức độ dịch vụ (SLA) hoặc Chính sách về việc ngừng cung cấp. Tuy nhiên, mọi dịch vụ của Nền tảng Google Maps mà thư viện sử dụng vẫn phải tuân theo Điều khoản dịch vụ của Nền tảng Google Maps.
Yêu cầu về thông tin ghi công đối với các nguồn của Google Maps
Mỗi phản hồi của công cụ từ Agentic UI Toolkit đều có nguồn. Khi trình bày kết quả sử dụng các công cụ do bộ công cụ cung cấp, bạn phải đưa vào các nguồn Google Maps liên quan theo cách đáp ứng các yêu cầu sau:
- Nguồn của Google Maps phải xuất hiện ngay sau nội dung được tạo mà nguồn đó hỗ trợ.
- Người dùng phải xem được các nguồn của Google Maps chỉ bằng một lượt tương tác.
Chia sẻ ý kiến phản hồi
Để chia sẻ ý kiến phản hồi về Maps Agentic UI Toolkit, hãy sử dụng các biểu mẫu sau: