Bộ công cụ Maps Agentic UI (thử nghiệm)

Tổng quan

Bộ công cụ giao diện người dùng dựa trên tác nhân của Nền tảng Maps là một bộ công cụ dành cho nhà phát triển, được thiết kế dành riêng cho kỷ nguyên AI đàm thoại. Nền tảng này cung cấp một bộ hướng dẫn hệ thống LLM và một thư viện các thành phần giao diện người dùng giúp Mô hình ngôn ngữ lớn (LLM) và các tác nhân AI tạo ra các phản hồi trực quan, mang tính tương tác theo thời gian thực cho dữ liệu không gian địa lý.

Thay vì mã hoá cứng các phần tử trực quan, 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 các bản đồ và màn hình hiển thị địa điểm động, có nhận biết ngữ cảnh, giúp người dùng tương tác trong trải nghiệm trò chuyện.

Các trường hợp sử dụng phổ biến bao gồm:

  • Trợ lý AI: Bổ sung ngữ cảnh trực quan cho câu trả lời bằng văn bản đối với các cụm từ tìm kiếm địa phương (ví dụ: khách sạn, 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 trên trang.
  • Phát triển dựa trên mã nguồn thấp: Giảm bớt khó khăn khi điều phối nhiều Maps API theo cách thủ công trên các điểm tiếp xúc trên web và thiết bị di động.

Khái niệm chính

1. Giao diện người dùng sẵn sàng cho tác nhân

Cho phép hình ảnh chất lượng cao, có thể mở rộng (chẳng hạn 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 LLM.

2. Trải nghiệm giàu ngữ cảnh

Giúp người dùng khám phá và quyết định mà không cần rời khỏi cuộc trò chuyện. Cung cấp ngữ cảnh phong phú về bản đồ nội tuyến (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) giúp người dùng tương tác và tự tin thực hiện hành động.

3. Thành phần thông minh

Bộ công cụ giao diện người dùng dựa trên tác nhân 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 liên kết với thương hiệu của bạn.

4. Không phụ thuộc vào LLM

Agentic UI toolkit không phụ thuộc vào mô hình trong ngăn xếp AI của bạn. Cho dù bạn sử dụng Gemini hay các mô hình của OpenAI hoặc Anthropic, và bất kể nguồn dữ liệu có cơ sở của bạn là gì, bộ công cụ Agentic UI đều cung cấp 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ủ

Cấu trúc mẫu phía máy chủ giúp tăng tốc quá trình kết xuất thành phần bằng cách thực hiện việc 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 đáng kể độ trễ cho trải nghiệm trò chuyện 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.

Hãy xem Hướng dẫn bắt đầu sử dụng để biết hướng dẫn chi tiết.

Kết quả giao diện người dùng

Bộ công cụ giao diện người dùng dựa trên tác nhân cung cấp một bộ khả năng giao diện người dùng chuyên biệt toàn diện ngay khi xuất xưởng. Các thành phần này có trên web, Android và iOS.

  • Thông tin chi tiết về địa điểm (Thu gọn): Thông tin cụ thể về địa điểm yêu thích trong một thẻ thu gọn.
  • Bản đồ cùng dòng: Công cụ định vị điểm hoặc khu vực.
  • Bản đồ + Tuyến đường trong dòng: Bản xem trước về đường đi hoặc hành trình.
  • Thông tin chi tiết về bản đồ trong dòng: Thông tin về vị trí hoặc bối cảnh bằng hình ảnh phong phú.

Hướng dẫn hệ thống

Bộ công cụ giao diện người dùng dựa trên tác nhân 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 tạo giao diện người dùng.

Nguyên tắc

Mô hình lưu trữ phải hiểu:

  1. Thành phần nào phù hợp với ý định của người dùng nào (ví dụ: sử dụng Bản đồ nội tuyến cho các truy vấn về hướng).

  2. Ánh xạ tham số từ ngôn ngữ tự nhiên sang giản đồ (ví dụ: nếu người dùng yêu cầu "cảnh đẹp", hãy đặt chế độ bản đồ thành vệ tinh).

Lược đồ sử dụng công cụ

Bộ công cụ giao diện người dùng dựa trên tác nhân 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 (ví dụ: 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 thủ Đ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 with Google Maps, có các yêu cầu bổ sung về Đ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à Dịch vụ cốt lõi của Google Maps Platform. Do đó, Điều khoản dịch vụ của Nền tảng Google Maps (ví dụ: Dịch vụ hỗ trợ kỹ thuật, Thoả thuận mức độ cung cấp dịch vụ và Chính sách 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 theo giấy phép nguồn mở. Dịch vụ 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, SLA hoặc Chính sách 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 thủ Điều khoản dịch vụ của Nền tảng Google Maps.

Yêu cầu về việc ghi công đối với các nguồn trên 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 các nguồn Google Maps liên kết vào theo cách đáp ứng các yêu cầu sau:

  • Các nguồn của Google Maps phải nằm ngay sau nội dung được tạo mà các nguồn đó hỗ trợ.
  • Người dùng phải xem được các nguồn dữ liệu của Google Maps trong một lượt tương tác của người dùng.

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: