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 của 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 xây dựng 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, nhà phát triể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 bối 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: Tăng cường câu trả lời bằng văn bản bằng bối cảnh trực quan cho 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 bằng mã nguồn thấp: Giảm khó khăn khi điều phối nhiều Maps API theo cách thủ công.

Khái niệm chính

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

Bật 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 phong phú về bối 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à tin tưởng để 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 sẽ tự động xử lý logic phức tạp về không gian địa lý – 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

Bộ công cụ Agentic UI 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ơ 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í.

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á API duy nhất. Thao tác này sẽ trừu tượng hoá các dịch vụ Maps cơ bản để bạn không cần quản lý các API riêng biệt.

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ộ tính năng toàn diện về giao diện người dùng chuyên biệt ngay khi xuất xưởng.

  • 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ẻ nhỏ gọn.
  • Maps 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 đồ nội tuyến: Bầu không khí hoặc bối cảnh của địa điểm bằng hình ảnh phong phú.

Hướng dẫn về 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 (ví dụ: sử dụng Bản đồ nội tuyến cho các truy vấn về hướng).

  2. Liên kết tham số từ ngôn ngữ tự nhiên đến giản đồ (ví dụ: nếu người dùng yêu cầu "đẹ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 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 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 dịch vụ hỗ trợ kỹ thuật của Google Maps Platform, 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 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ụ trong bộ công cụ Agentic UI đề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 quan vào theo cách đáp ứng các yêu cầu sau:

  • Các nguồn trên 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 của Google Maps trong một lượt tương tác của người dùng.