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

Kỹ năng của tác nhân Google Ads API là các mô-đun độc lập, có thể di chuyển, chứa kiến thức, hướng dẫn và quy trình làm việc dành riêng cho Google Ads API. Các kỹ năng của tác nhân Google Ads API hoạt động với những trợ lý AI hỗ trợ tiêu chuẩn Kỹ năng tác nhân mở, bao gồm cả Google Antigravity và Claude Code.

Những kỹ năng tác nhân phần mềm này được thiết kế để giúp trợ lý AI hiểu rõ các phương pháp hay nhất về Google Ads API, định cấu hình công cụ và thực thi quy trình làm việc với độ chính xác cao hơn và chi phí token thấp hơn. Để xem danh sách các kỹ năng hiện có, hãy xem phần Các kỹ năng hiện có.

Bắt đầu

Cài đặt các kỹ năng của tác nhân phù hợp với môi trường phát triển của bạn.

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

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 Ads API trong trình chỉnh sửa mà bạn muốn bằng một lệnh duy nhất:

Antigravity

Kỹ năng của tác nhân Google Ads API là một trong những gói tích hợp Xây dựng bằng Google cho Antigravity. Bạn có thể bật gói này để truy cập ở cấp độ toàn cầu tại hai điểm:

  • Trong quá trình thiết lập ban đầu: Đánh dấu vào hộp cho ngăn xếp Google Ads API.
  • Trong phần Cài đặt:
    1. Chuyển đến phần Cài đặt > Tuỳ chỉnh.
    2. Trong mục Xây dựng bằng trình bổ trợ của Google, hãy nhấp vào Tuỳ chỉnh, rồi nhấp vào Tải xuống để tích hợp Google Ads API.

Nếu bạn muốn có quyền truy cập ở cấp dự án, hãy chạy lệnh sau trong thư mục của dự án:

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

Claude Code

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

Codex

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

Con trỏ

Bạn có thể cài đặt trực tiếp các kỹ năng của tác nhân Google Ads API bằng cách thêm điểm cuối kho lưu trữ GitHub của kỹ năng (ví dụ: https://github.com/google/skills) trong phần cài đặt của trình chỉnh sửa theo quy tắc tuỳ chỉnh. Để biết thêm thông tin, hãy xem tài liệu của Cursor về cách cài đặt kỹ năng từ GitHub.

Bạn cũng có thể cài đặt các kỹ năng bằng npx (yêu cầu Node.js):

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

Tác nhân khác

Đối với các trợ lý AI khác hỗ trợ tiêu chuẩn Kỹ năng tác nhân mở, bạn có thể cài đặt các kỹ năng bằng npx (yêu cầu Node.js):

npx skills add google/skills/skills/ads

Cập nhật kỹ năng của tác nhân phần mềm Google Ads API

Bạn có thể nhận tất 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:

Antigravity

Các tính năng tích hợp được bật thông qua Xây dựng bằng Google sẽ được trình chỉnh sửa quản lý và cập nhật tự động.

Nếu đã cài đặt kỹ năng của tác nhân bằng lệnh npx, bạn có thể nhận tất cả bản cập nhật hiện có bằng cách chạy lệnh update:

npx skills update --all

Claude Code

npx skills update --all

Codex

npx skills update --all

Con trỏ

npx skills update --all

Tác nhân khác

Đối với các trợ lý AI khác hỗ trợ tiêu chuẩn Kỹ năng của tác nhân mở, bạn có thể cập nhật tất cả kỹ năng đang hoạt động bằng npx:

npx skills update --all

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

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. Các kỹ năng được cài đặt trên toàn hệ thống sẽ không hoạt động trong những dự án không liên quan, trừ phi bối cảnh câu lệnh của bạn khớp với các nhiệm vụ của Google Ads API.

Bạn cũng có thể gọi kỹ năng theo cách thủ công bằng cách nhập / vào cuộc trò chuyện với nhân viên hỗ trợ và tìm tên kỹ năng.

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 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âu lệnh được đưa vào cửa sổ ngữ cảnh để hướng dẫn trợ lý tạo truy vấn GAQL, định cấu hình thông tin xác thực OAuth và xử lý các mã lỗi phổ biến.
  • Các phương pháp hay nhất: Các đề xuất tiêu chuẩn về hiệu suất, bảo mật và tích hợp do nhóm Quan hệ nhà phát triển Google Ads API xác định.
  • Tập lệnh tự động hoá: Tập lệnh thực thi (chẳng hạn như để xác thực môi trường hoặc thiết lập không gian làm việc) có trong các gói kỹ năng để thực thi các tác vụ trên thiết bị.

Lợi ích của việc sử dụng kỹ năng

Kỹ năng của tác nhân mở rộng khả năng của trợ lý bằng kiến thức chuyên môn theo yêu cầu mà không cần phải tải các hướng dẫn rườm rà vào mọi cuộc trò chuyện.

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

Các công cụ tích hợp AI thông thường thường tải một lượng lớn tài liệu ngay từ đầu, điều này tiêu tốn nhiều token và làm tăng chi phí cho phiên. Kỹ năng của tác nhân sử dụng phương pháp cung cấp thông tin theo trình tự lần lượt để giảm thiểu mức hao tổn này:

  • Ban đầu, trợ lý AI chỉ kiểm tra tên và nội dung mô tả của kỹ năng để xem kỹ năng đó có liên quan đến yêu cầu của bạn hay không.
  • Hướng dẫn và tài liệu tham khảo đầy đủ của kỹ năng chỉ được thêm vào cửa sổ ngữ cảnh đang hoạt động khi trợ lý xác định rằng chúng cần thiết cho nhiệm vụ cụ thể của bạn, giúp tiết kiệm không gian ngữ cảnh.

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

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. Kỹ năng hướng dẫn trợ lý AI thực hiện các nhiệm vụ như sau:

  • Tạo một truy vấn GAQL để truy xuất các chỉ số về hiệu suất chiến dịch từ tài khoản của tôi.
  • Viết tập lệnh Python bằng thư viện ứng dụng để tạo chiến dịch mới.
  • Truy xuất dữ liệu chẩn đoán và lượt chuyển đổi của chiến dịch bằng Google Ads API.

Để xem danh sách đầy đủ các kỹ năng hiện có, hãy xem phần Kỹ năng hiện có.

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

Kỹ năng của tác nhân được thiết kế để bổ sung cho máy chủ Giao thức ngữ cảnh mô hình (MCP) của Google Ads API:

  • Máy chủ MCP của Google Ads API: Được thiết kế cho quy trình phát triển có sự hỗ trợ của AI, cho phép trợ lý AI tương tác với tài nguyên, chiến dịch và chỉ số của Google Ads API theo phương thức lập trình.
  • Kỹ năng của tác nhân Google Ads API: Cung cấp hướng dẫn nhanh và các phương pháp hay nhất để hướng dẫn trợ lý thực hiện các nhiệm vụ thông qua việc tiết lộ dần dần và tiết kiệm mã thông báo. Các hướng dẫn này chỉ cho tác nhân cách sử dụng hiệu quả các công cụ như máy chủ MCP và thư viện ứng dụng.

Kỹ năng hiện có

Nhóm phụ trách API Google Ads cung cấp một bộ kỹ năng để xây dựng bằng Google Ads API:

Kỹ năng Mô tả
google-ads-api-account-diagnostics Chẩn đoán các vấn đề về hiệu suất của tài khoản Google Ads (chẳng hạn như mất lượt chuyển đổi, số lượng khách hàng tiềm năng thấp và tỷ lệ hiển thị bị mất do thứ hạng quảng cáo, giá thầu hoặc ngân sách) bằng máy chủ MCP của Google Ads API.
google-ads-api-mcp-setup Hỗ trợ thiết lập và định cấu hình máy chủ Giao thức ngữ cảnh mô hình (MCP) của Google Ads API, đơn giản hoá quy trình xác thực và định cấu hình trong môi trường cục bộ.
google-ads-api-quickstart Hướng dẫn bạn cách thiết lập môi trường phát triển, định cấu hình thông tin xác thực và thực hiện lệnh gọi API đầu tiên đến Google Ads API.

Các bước tiếp theo