Kỹ năng của nhân viên hỗ trợ Google Maps Platform

Kỹ năng của tác nhân Nền tảng Google Maps (GitHub) là các mô-đun di động, độc lập về kiến thức, hướng dẫn và quy trình làm việc dành riêng cho Nền tảng Google Maps. Các mô-đun này được thiết kế để giúp trợ lý AI hiểu các phương pháp hay nhất của Nền tảng Google Maps và thực thi các tác vụ phức tạp với độ chính xác cao hơn và chi phí token thấp hơn.

Các kỹ năng hiện có

Nền tảng Google Maps cung cấp một bộ kỹ năng cho các sản phẩm cốt lõi. Các kỹ năng cho các sản phẩm và tính năng bổ sung sẽ sớm ra mắt!

Kỹ năng Mô tả
google-maps-platform Một tập hợp các kỹ năng để thiết kế và triển khai mã sẵn sàng cho hoạt động sản xuất bằng cách sử dụng API và SDK của Google Maps Platform trên Web, Android, iOS và API Dịch vụ web cho bất kỳ nội dung nào sau đây: bản đồ, địa điểm, địa chỉ, mã hoá địa lý, định tuyến/Giờ đến dự kiến (bao gồm cả chọn tuyến đường thân thiện với môi trường), Nearby Search, bản đồ 3D/Chế độ xem đường phố/bản đồ tĩnh, phân cụm điểm đánh dấu, tạo kiểu tuỳ chỉnh, vẽ, khoanh vùng địa lý, bản đồ nhiệt hoặc môi trường (chất lượng không khí/Phấn hoa/Solar/thời tiết).

Bắt đầu

Các kỹ năng của tác nhân Nền tảng Google Maps hoạt động với mọi trợ lý AI hỗ trợ kỹ năng, bao gồm Gemini, Cursor, Windsurf, Copilot và Claude.

Cài đặt các kỹ năng của tác nhân Google Maps Platform

Trong hầu hết các trường hợp, bạn có thể cài đặt các kỹ năng của tác nhân Google Maps Platform bằng một lệnh duy nhất:

CLI kỹ năng

Đối với hầu hết các công cụ hỗ trợ AI phổ biến, bạn có thể sử dụng CLI skills để cài đặt các kỹ năng của tác nhân Google Maps Platform. Chạy lệnh sau trong thư mục gốc của dự án:

npx skills add googlemaps/agent-skills

Phương thức này đã được kiểm thử dưới dạng lệnh đầu cuối hoặc lời nhắc bằng ngôn ngữ tự nhiên cho tác nhân trong:

Gemini CLI

Kho lưu trữ này được định cấu hình dưới dạng tiện ích Gemini CLI. Bạn có thể thêm tiện ích này bằng Gemini CLI:

gemini extensions install https://github.com/googlemaps/agent-skills

Lovable

Cài đặt các kỹ năng của tác nhân Google Maps Platform trong Lovable bằng giao diện người dùng cài đặt Kỹ năng:

  1. Truy cập vào https://lovable.dev/settings/skills
  2. Trong phần Kỹ năng của không gian làm việc, hãy nhấp vào Thêm > Nhập từ GitHub.
  3. Dán URL cho kỹ năng chính google-maps-platform:
https://github.com/googlemaps/agent-skills/tree/main/skills/google-maps-platform

Sử dụng các kỹ năng của tác nhân Google Maps Platform

Tự động kích hoạt hoặc gọi kỹ năng của tác nhân theo cách thủ công

Trợ lý AI được thiết kế để tự động sử dụng các kỹ năng bất cứ khi nào phát hiện thấy nội dung mô tả của một kỹ năng phù hợp với yêu cầu hiện tại của bạn. Tuy nhiên, bạn cũng có thể gọi các kỹ năng theo cách thủ công. Bạn thường thực hiện việc này bằng cách nhập / trong cuộc trò chuyện với tác nhân và tìm kiếm tên kỹ năng.

Ví dụ: sau khi cài đặt, bạn có thể nhập nội dung sau vào cuộc trò chuyện với tác nhân để yêu cầu một tính năng mới trong ứng dụng mà bạn đang xây dựng:

/google-maps-platform Add a 3D map featuring a marker for the user's location

Sử dụng các kỹ năng cùng với máy chủ Code Assist MCP

Các kỹ năng của tác nhân được thiết kế để bổ sung cho máy chủ Code Assist MCP:

  • Các kỹ năng của tác nhân Nền tảng Google Maps: Cung cấp hướng dẫn nhanh và các phương pháp hay được đề xuất để cho tác nhân biết cách thực hiện các tác vụ của Nền tảng Google Maps thông qua việc tiết lộ thông tin từng bước một cách hiệu quả về token. Các kỹ năng này hướng dẫn tác nhân cách sử dụng các công cụ của máy chủ MCP một cách hiệu quả.

  • Máy chủ Code Assist MCP: Được thiết kế cho các quy trình làm việc phát triển có sự hỗ trợ của AI, cho phép trợ lý AI tương tác với các dự án, tài nguyên và dữ liệu của Google Maps Platform theo phương thức lập trình.

Cập nhật các kỹ năng của tác nhân Google Maps Platform

Bạn có thể nhận tất cả các bản cập nhật hiện có và dọn dẹp các kỹ năng đã lỗi thời bằng cách chạy lệnh update:

CLI kỹ năng 

npx skills update google-maps-platform

Gemini CLI 

gemini extensions update

Các thành phần cốt lõi của một kỹ năng

Mỗi kỹ năng của tác nhân là một gói chuyên biệt có thể cung cấp cho trợ lý AI các thành phần sau:

  • Hướng dẫn chuyên biệt: Hướng dẫn chi tiết về cách thực hiện các tác vụ cụ thể, chẳng hạn như triển khai Place Autocomplete hoặc tạo bản đồ bằng Điểm đánh dấu nâng cao.
  • Các phương pháp hay nhất: Các mẫu bảo mật và hiệu suất tích hợp sẵn để đảm bảo ứng dụng của bạn tuân theo các đề xuất của Nền tảng Google Maps ngay từ đầu, bao gồm cả việc tối ưu hoá chi phí.
  • Tập lệnh tự động hoá: Mã có thể thực thi cho phép tác nhân AI của bạn tự động thực hiện việc thiết lập hoặc cấu hình môi trường cục bộ.
  • Độ mạnh mẽ trong thế giới thực: Các mẫu xử lý lỗi và ngoại lệ được rút ra trực tiếp từ các cách triển khai kho lưu trữ nguồn mở đã được xác minh.

Lợi ích khi sử dụng các kỹ năng

Việc sử dụng các kỹ năng của tác nhân giúp giảm bớt nỗ lực thủ công trong việc tìm kiếm tài liệu, đồng thời cải thiện hiệu quả của các tương tác AI.

Giảm chi phí token

Các hoạt động tích hợp AI thông thường thường tải trước một lượng lớn tài liệu, điều này tiêu tốn đáng kể token và làm tăng chi phí phiên. Các kỹ năng của tác nhân sử dụng việc tiết lộ thông tin từng bước để giảm thiểu chi phí này:

  • Ban đầu, tác nhân chỉ "quét" siêu dữ liệu ngắn gọn để xem một kỹ năng có liên quan hay không.
  • Hướng dẫn và tài nguyên chi tiết chỉ được tải khi tác nhân xác định rằng chúng cần thiết cho tác vụ cụ thể của bạn.

Triển khai có hướng dẫn của AI

Thay vì tìm kiếm tài liệu theo cách thủ công, bạn có thể mô tả ý định của mình bằng ngôn ngữ tự nhiên. Các kỹ năng hướng dẫn trợ lý AI của bạn thực hiện các tác vụ như sau:

  • Thêm bản đồ có điểm đánh dấu vào ứng dụng web của tôi.
  • Triển khai tính năng Place Autocomplete để nhập địa chỉ.
  • Giúp tôi tạo hình ảnh bản đồ tĩnh.

Để biết danh sách đầy đủ các kỹ năng của tác nhân Nền tảng Google Maps, hãy xem Các kỹ năng hiện có.

Các bước tiếp theo