Keahlian agen Google Ads API

Keahlian agen Google Ads API adalah modul berisi pengetahuan, petunjuk, dan alur kerja khusus Google Ads API yang bersifat portabel dan berdiri sendiri. Keahlian agen Google Ads API dapat digunakan dengan asisten AI yang mendukung standar Keahlian Agen terbuka, termasuk Google Antigravity dan Claude Code.

Keahlian agen ini dirancang untuk membantu asisten AI memahami praktik terbaik Google Ads API, mengonfigurasi alat, dan menjalankan alur kerja dengan akurasi yang lebih tinggi dan biaya token yang lebih rendah. Untuk mengetahui daftar keahlian yang tersedia, lihat Keahlian yang tersedia.

Mulai

Instal keterampilan agen yang sesuai untuk lingkungan pengembangan Anda.

Menginstal keahlian agen Google Ads API

Dalam sebagian besar kasus, keahlian agen Google Ads API dapat diinstal di editor pilihan Anda dengan satu perintah:

Antigravity

Kemampuan agen Google Ads API disertakan sebagai salah satu paket integrasi Build with Google untuk Antigravity. Anda dapat mengaktifkan paket ini untuk akses tingkat global di dua titik:

  • Selama proses aktivasi: Centang kotak untuk stack Google Ads API.
  • Di Setelan:
    1. Buka Setelan > Penyesuaian.
    2. Di bagian Build with Google Plugins, klik Customize, lalu klik Download untuk integrasi Google Ads API.

Jika Anda lebih memilih akses level project, jalankan perintah berikut di direktori project Anda:

npx skills add google/skills --agent=antigravity

Claude Code 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Codex 

npx skills add google/skills

Kursor

Anda dapat menginstal kemampuan agen Google Ads API secara langsung dengan menambahkan endpoint repositori GitHub kemampuan (misalnya, https://github.com/google/skills) di setelan editor Anda dalam aturan kustom. Untuk mengetahui detail selengkapnya, lihat Dokumentasi aturan kursor.

Agen lain

Untuk asisten AI lain yang mendukung standar Keterampilan Agen terbuka, Anda dapat menginstal keterampilan menggunakan NPX:

npx skills add google/skills

Memperbarui keahlian agen Google Ads API

Anda bisa mendapatkan semua update yang tersedia dan menghapus keterampilan yang sudah tidak berlaku dengan menjalankan perintah update:

Antigravity

Integrasi yang diaktifkan melalui Buat dengan Google dikelola dan diupdate secara otomatis oleh editor.

Jika Anda menginstal keterampilan agen menggunakan perintah npx, Anda bisa mendapatkan semua update yang tersedia dengan menjalankan perintah update:

npx skills update --all

Claude Code 

claude plugin update google-ads@skills

Codex 

npx skills update --all

Kursor 

npx skills update --all

Agen lain

Untuk asisten AI lain yang mendukung standar Agent Skills terbuka, Anda dapat memperbarui semua keahlian aktif menggunakan NPX:

npx skills update --all

Menggunakan keahlian agen Google Ads API

Asisten AI dirancang untuk menggunakan keahlian secara otomatis setiap kali asisten AI tersebut mendeteksi bahwa deskripsi keahlian cocok dengan permintaan Anda saat ini. Keterampilan yang diinstal secara global tetap tidak aktif dalam project yang tidak terkait kecuali jika konteks perintah Anda cocok dengan tugas Google Ads API.

Keahlian juga dapat dipanggil secara manual dengan mengetik / di chat agen dan menelusuri nama keahlian.

Komponen inti keahlian

Setiap keahlian agen adalah paket khusus yang menyediakan komponen berikut untuk asisten AI:

  • Petunjuk khusus: Petunjuk perintah mendetail yang dimasukkan ke dalam jendela konteks untuk memandu asisten dalam membuat kueri GAQL, mengonfigurasi kredensial OAuth, dan menangani kode error umum.
  • Praktik terbaik: Rekomendasi performa, keamanan, dan integrasi standar yang ditentukan oleh tim DevRel Google Ads API.
  • Skrip otomatisasi: Skrip yang dapat dieksekusi (seperti untuk validasi lingkungan atau penyiapan ruang kerja) yang disertakan dalam paket kemampuan untuk menjalankan tugas secara lokal.

Manfaat menggunakan keahlian

Keterampilan agen memperluas kemampuan asisten dengan pengetahuan khusus sesuai permintaan tanpa overhead pemuatan petunjuk yang besar ke dalam setiap percakapan.

Biaya token yang lebih rendah

Integrasi AI konvensional sering kali memuat dokumentasi dalam jumlah besar di awal, sehingga menghabiskan banyak token dan meningkatkan biaya sesi. Keahlian agen menggunakan pengungkapan progresif untuk meminimalkan beban ini:

  • Pada awalnya, asisten AI hanya memeriksa nama dan deskripsi keahlian untuk melihat apakah keahlian tersebut relevan dengan permintaan Anda.
  • Petunjuk dan referensi lengkap skill hanya ditambahkan ke jendela konteks aktif saat asisten menentukan bahwa petunjuk dan referensi tersebut diperlukan untuk tugas spesifik Anda, sehingga menghemat ruang konteks.

Penerapan yang dipandu AI

Daripada menelusuri dokumentasi secara manual, Anda dapat mendeskripsikan maksud Anda menggunakan bahasa alami. Keahlian akan memandu asisten AI Anda untuk melakukan tugas-tugas seperti berikut:

  • Buat kueri GAQL untuk mengambil metrik performa kampanye dari akun saya.
  • Tulis skrip Python menggunakan library klien untuk membuat kampanye baru.
  • Mengambil konversi kampanye dan data diagnostik menggunakan Google Ads API.

Untuk mengetahui daftar lengkap keahlian yang tersedia, lihat Keahlian yang tersedia.

Menggunakan keahlian bersama server MCP Google Ads API

Keahlian agen dirancang untuk melengkapi server Model Context Protocol (MCP) Google Ads API:

  • Server MCP Google Ads API: Dirancang untuk alur kerja pengembangan yang dibantu AI, sehingga memungkinkan asisten AI berinteraksi dengan resource, kampanye, dan metrik Google Ads API Anda secara terprogram.
  • Keahlian agen Google Ads API: Memberikan petunjuk perintah dan praktik yang direkomendasikan untuk memandu asisten dalam melakukan tugas melalui pengungkapan progresif yang hemat token. Keahlian ini menginstruksikan agen tentang cara menggunakan alat seperti server MCP dan library klien secara efektif.

Keahlian yang tersedia

Tim Google Ads API menyediakan serangkaian keterampilan untuk membangun dengan Google Ads API:

Badge Deskripsi
google-ads-api-mcp-setup Membantu menyiapkan dan mengonfigurasi server Model Context Protocol (MCP) Google Ads API, menyederhanakan autentikasi dan konfigurasi di lingkungan lokal.
google-ads-api-quickstart Memandu Anda menyiapkan lingkungan developer, mengonfigurasi kredensial, dan melakukan panggilan API pertama ke Google Ads API.

Langkah berikutnya