Kỹ năng của tác nhân AI trong Google Analytics

Để xây dựng các công cụ tích hợp báo cáo và quản lý tài sản Google Analytics với độ chính xác cao hơn và mức hao tổn mã thông báo thấp hơn, hãy trang bị cho tác nhân lập trình AI của bạn các kỹ năng của tác nhân AI Google Analytics. Được thiết kế cho những nhà phát triển xây dựng bằng Google Analytics Data API và Google Analytics Admin API, các kỹ năng của tác nhân AI trong Google Analytics là các mô-đun hướng dẫn, quy trình công việc và tệp đối chiếu thư viện ứng dụng độc lập, có thể di chuyển.

Các kỹ năng của tác nhân AI này hoạt động với những tác nhân lập trình AI hỗ trợ tiêu chuẩn Agent Skills mở, bao gồm Google Antigravity, Claude Code, Codex và Cursor. Để xem danh sách các kỹ năng đã xuất bản, hãy xem phần Kỹ năng hiện có.

Trước khi bắt đầu

Trước khi cài đặt và chạy các kỹ năng của tác nhân AI trong Google Analytics, hãy hoàn tất các điều kiện tiên quyết sau:

  • Cài đặt một tác nhân lập trình AI hỗ trợ tiêu chuẩn Agent Skills mở, chẳng hạn như Google Antigravity, Claude Code, Codex hoặc Cursor.
  • Cài đặt Node.js, bao gồm cả lệnh npx để cài đặt và cập nhật kỹ năng từ dòng lệnh.
  • Tạo hoặc chọn một dự án có quyền truy cập vào một tài sản Google Analytics khi chạy quy trình công việc API.

Bắt đầu

Cài đặt, cập nhật và gọi các kỹ năng của tác nhân AI trong Google Analytics trong môi trường phát triển của bạn.

Cài đặt các kỹ năng của tác nhân AI trong Google Analytics

Cài đặt bộ kỹ năng Google Analytics trong thư mục dự án bằng lệnh npx hoặc định cấu hình trực tiếp trình chỉnh sửa:

Antigravity

Chạy lệnh sau trong thư mục dự án:

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

Chạy lệnh sau trong thư mục dự án:

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

Chạy lệnh sau trong thư mục dự án:

npx skills add google/skills/skills/analytics --agent=codex

Con trỏ

Thêm URL kho lưu trữ kỹ năng (https://github.com/google/skills) vào chế độ cài đặt trình chỉnh sửa trong phần quy tắc tuỳ chỉnh. Để biết hướng dẫn, hãy xem tài liệu về Cursor về cách cài đặt kỹ năng từ GitHub.

Ngoài ra, hãy cài đặt các kỹ năng trong thư mục dự án bằng cách sử dụng lệnh npx:

npx skills add google/skills/skills/analytics --agent=cursor

Tác nhân khác

Đối với các tác nhân lập trình AI khác hỗ trợ tiêu chuẩn mở Agent Skills, hãy chạy lệnh sau trong thư mục dự án của bạn:

npx skills add google/skills/skills/analytics

Cập nhật kỹ năng của tác nhân AI trong Google Analytics

Tải các bản cập nhật có sẵn xuống và dọn dẹp các kỹ năng đã lỗi thời bằng cách chạy lệnh sau:

npx skills update --all

Sử dụng các kỹ năng của tác nhân AI trong Google Analytics

Tác nhân lập trình AI sẽ tự động tải các kỹ năng khi phát hiện thấy nội dung mô tả của một kỹ năng khớp với câu lệnh của bạn. Các kỹ năng được cài đặt trên toàn cầu vẫn không hoạt động trong các dự án không liên quan, trừ phi yêu cầu của bạn liên quan đến các nhiệm vụ của Google Analytics.

Để gọi một kỹ năng theo cách thủ công trong các tác nhân lập trình AI được hỗ trợ, hãy nhập ký tự / vào ô nhập nội dung trò chuyện rồi chọn kỹ năng theo tên.

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 AI trong Google Analytics đều cung cấp cho tác nhân lập trình AI của bạn các thành phần sau:

  • Hướng dẫn chuyên biệt: Hướng dẫn từng bước để bật API Google Analytics bằng gcloud CLI, định cấu hình Thông tin xác thực mặc định của ứng dụng (ADC), tạo truy vấn runReport và kiểm tra khả năng tương thích của trường.
  • Các phương pháp hay nhất: Lựa chọn phiên bản API được đề xuất (điểm cuối v1beta để đảm bảo độ ổn định chung và điểm cuối v1alpha cho các tính năng của API Quản trị có quyền truy cập sớm), xây dựng yêu cầu có kiểu dữ liệu rõ ràng và quy trình xác thực giản đồ.
  • Tài liệu tham khảo: Hướng dẫn cài đặt thư viện ứng dụng theo ngôn ngữ cụ thể và mã mẫu cho Python, Java, Node.js, PHP, Go, .NET và Ruby trong thư mục references/ của mỗi kỹ năng.

Lợi ích của kỹ năng của tác nhân AI

Kỹ năng của tác nhân AI giúp mở rộng tác nhân lập trình AI của bạn bằng kiến thức chuyên sâu về Google Analytics theo yêu cầu mà không cần tải các bộ tài liệu lớn vào mọi cuộc trò chuyện.

Giảm chi phí cho mã thông báo

Việc tải trước toàn bộ tài liệu tham khảo API sẽ tiêu tốn token ngữ cảnh và làm tăng chi phí cho phiên. Kỹ năng của tác nhân AI sử dụng tiết lộ tăng dần để giảm thiểu việc sử dụng ngữ cảnh:

  • Khi khởi động, tác nhân lập trình AI chỉ đọc tên và nội dung mô tả ngắn của từng kỹ năng để kiểm tra xem kỹ năng đó có khớp với câu lệnh của bạn hay không.
  • Tác nhân chỉ tải toàn bộ hướng dẫn SKILL.md và tệp đối chiếu theo ngôn ngữ cụ thể vào cửa sổ ngữ cảnh đang hoạt động khi nhiệm vụ của bạn yêu cầu.

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

Mô tả mục tiêu của bạn bằng ngôn ngữ tự nhiên và các kỹ năng đã cài đặt sẽ hướng dẫn tác nhân lập trình AI của bạn thực hiện các nhiệm vụ triển khai Google Analytics như sau:

  • Bật Google Analytics Data API trong dự án của tôi và viết một tập lệnh Python truy vấn các chỉ số activeUsers và sessions theo các phương diện city và date.
  • Kiểm tra xem phương diện itemName có tương thích với các chỉ số activeUsers và totalRevenue cho tài sản Google Analytics của tôi hay không bằng cách sử dụng phương thức checkCompatibility.
  • Liệt kê tất cả thông tin tóm tắt về tài khoản Google Analytics và tài sản con có thể truy cập trong Node.js bằng cách sử dụng Google Analytics Admin API.
  • Định cấu hình phương diện tuỳ chỉnh, luồng dữ liệu và khoá bí mật của Measurement Protocol cho tài sản Google Analytics của tôi.

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

Các kỹ năng của tác nhân AI trong Google Analytics bổ sung cho máy chủ Giao thức ngữ cảnh mô hình (MCP) của Google Analytics:

  • Máy chủ MCP của Google Analytics: Kết nối trực tiếp tác nhân lập trình AI của bạn với các tài sản Google Analytics đang hoạt động để tác nhân đó có thể kiểm tra thông tin tóm tắt về tài khoản, thông tin chi tiết về tài sản, phương diện tuỳ chỉnh, chỉ số tùy chỉnh và báo cáo theo thời gian thực.
  • Kỹ năng của tác nhân AI trong Google Analytics: Cung cấp hướng dẫn hiệu quả về mã thông báo và tài liệu tham khảo về thư viện ứng dụng để hướng dẫn tác nhân lập trình AI khi bật API, định cấu hình xác thực ADC, kiểm tra khả năng tương thích của trường và viết mã xử lý ứng dụng.

Kỹ năng hiện có

Google duy trì các kỹ năng sau đây của tác nhân AI trong Google Analytics trong kho lưu trữ google/skills:

Kỹ năng Mô tả
google-analytics-data-api-basics Bật Google Analytics Data API (analyticsdata.googleapis.com) bằng gcloud CLI, định cấu hình ADC với phạm vi OAuth 2.0 analytics.readonly và cài đặt các thư viện ứng dụng chính thức của v1beta (Python, Java, PHP, Node.js, Go, .NET và Ruby). Hướng dẫn tác nhân của bạn tạo truy vấn runReport và kiểm tra khả năng tương thích của trường bằng các phương thức getMetadata và checkCompatibility.
google-analytics-admin-api-basics Bật Google Analytics Admin API (analyticsadmin.googleapis.com) bằng gcloud CLI, định cấu hình ADC bằng phạm vi OAuth 2.0 analytics.readonly và analytics.edit, đồng thời cài đặt các thư viện ứng dụng chính thức v1beta và v1alpha (Python, Java, PHP, Node.js, Go, .NET và Ruby). Hướng dẫn nhân viên hỗ trợ liệt kê thông tin tóm tắt về tài khoản và quản lý tài sản, luồng dữ liệu, phương diện tuỳ chỉnh, chỉ số tuỳ chỉnh, sự kiện chính, mã thông báo bí mật cho Measurement Protocol và mối liên kết sản phẩm.

Các bước tiếp theo