مهارت‌های نماینده Google Ads API

مهارت‌های عامل Google Ads API ماژول‌های قابل‌حمل و مستقل از دانش، دستورالعمل‌ها، و گردش‌های کاری مختص Google Ads API هستند. مهارت‌های عامل Google Ads API با دستیارهای هوش مصنوعی که از استاندارد باز Agent Skills پشتیبانی می‌کنند، ازجمله Google Antigravity و Claude Code، کار می‌کنند.

این مهارت‌های عامل برای کمک به دستیارهای هوش مصنوعی طراحی شده‌اند تا بهترین روش‌های Google Ads API را درک کنند، ابزارها را پیکربندی کنند، و گردش‌های کاری را با دقت بالاتر و هزینه توکن کمتر اجرا کنند. برای مشاهده فهرست مهارت‌های دردسترس، مهارت‌های دردسترس را ببینید.

شروع کنید

مهارت‌های عامل مناسب برای محیط توسعه‌تان را نصب کنید.

نصب مهارت‌های عامل Google Ads API

در بیشتر موارد، مهارت‌های عامل Google Ads API را می‌توان در ویرایشگر دلخواهتان با یک فرمان نصب کرد:

Antigravity

مهارت‌های عامل Google Ads API به‌عنوان یکی از دسته‌های ادغام ساخت با Google برای Antigravity گنجانده شده است. می‌توانید این بسته را برای دسترسی در سطح جهانی در دو نقطه فعال کنید:

  • درطول آماده‌سازی: چارگوش انتخاب را برای پشته Google Ads API انتخاب کنید.
  • در «تنظیمات»:
    1. به تنظیمات > سفارشی‌سازی‌ها بروید.
    2. در بخش ساخت با افزونه‌های Google، روی سفارشی‌سازی کلیک کنید، سپس برای ادغام Google Ads API روی بارگیری کلیک کنید.

اگر دسترسی در سطح پروژه را ترجیح می‌دهید، فرمان زیر را در دایرکتوری پروژه‌تان اجرا کنید:

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

مکان‌نما

می‌توانید مهارت‌های عامل Google Ads API را مستقیماً با افزودن نقطه پایانی مخزن GitHub مهارت (برای مثال، https://github.com/google/skills) در تنظیمات ویرایشگرتان در بخش قوانین سفارشی نصب کنید. برای جزئیات بیشتر، اسناد Cursor درباره نصب مهارت‌ها از GitHub را ببینید.

همچنین می‌توانید مهارت‌ها را بااستفاده از npx نصب کنید (به Node.js نیاز دارد):

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

عامل‌های دیگر

برای سایر دستیارهای هوش مصنوعی که از استاندارد باز «مهارت‌های عامل» پشتیبانی می‌کنند، می‌توانید مهارت‌ها را بااستفاده از npx نصب کنید (به Node.js نیاز دارد):

npx skills add google/skills/skills/ads

به‌روزرسانی مهارت‌های عامل Google Ads API

با اجرای فرمان update می‌توانید همه به‌روزرسانی‌های دردسترس را دریافت کنید و مهارت‌های قدیمی را پاک کنید:

Antigravity

ادغام‌های فعال‌شده ازطریق ساخت با Google به‌طور خودکار توسط ویرایشگر مدیریت و به‌روزرسانی می‌شوند.

اگر مهارت‌های نماینده را بااستفاده از فرمان npx نصب کرده‌اید، می‌توانید همه به‌روزرسانی‌های دردسترس را با اجرای فرمان update دریافت کنید:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

مکان‌نما 

npx skills update --all

عامل‌های دیگر

برای سایر دستیارهای هوش مصنوعی که از استاندارد باز «مهارت‌های عامل» پشتیبانی می‌کنند، می‌توانید همه مهارت‌های فعال را بااستفاده از npx به‌روز کنید:

npx skills update --all

استفاده از مهارت‌های عامل Google Ads API

دستیارهای هوش مصنوعی به‌گونه‌ای طراحی شده‌اند که هرگاه تشخیص دهند شرح مهارتی با درخواست فعلی شما مطابقت دارد، به‌طور خودکار از آن مهارت استفاده کنند. مهارت‌های نصب‌شده به‌صورت سراسری در پروژه‌های نامرتبط غیرفعال می‌مانند، مگراینکه بافت پیام‌واره شما با تکالیف Google Ads API مطابقت داشته باشد.

مهارت‌ها را می‌توان به‌صورت دستی نیز با تایپ کردن / در گپ نماینده و جستجوی نام مهارت فراخوانی کرد.

اجزای اصلی مهارت

هر مهارت عامل یک بسته تخصصی است که مؤلفه‌های زیر را برای دستیار هوش مصنوعی فراهم می‌کند:

  • دستورالعمل‌های تخصصی: دستورالعمل‌های دقیق پیام‌واره که به پنجره بافت تزریق شده‌اند تا دستیار را در تولید پُرسمان‌های GAQL، پیکربندی اطلاعات کاربری OAuth، و رسیدگی به کدهای خطای رایج راهنمایی کنند.
  • روال‌های مطلوب: توصیه‌های استاندارد عملکرد، امنیت، و ادغام که توسط تیم Google Ads API DevRel تعریف شده است.
  • دستورگان‌های خودکارسازی: دستورگان‌های قابل‌اجرا (مثلاً برای اعتبارسنجی محیط یا راه‌اندازی فضای کاری) که در بسته‌های مهارت گنجانده شده‌اند تا تکالیف را به‌صورت محلی اجرا کنند.

مزایای استفاده از مهارت‌ها

مهارت‌های عامل قابلیت‌های دستیار را با دانش تخصصی درصورت درخواست گسترش می‌دهند، بدون اینکه بار اضافی بار کردن دستورالعمل‌های حجیم در هر مکالمه وجود داشته باشد.

کاهش هزینه توکن

ادغام‌های هوش مصنوعی سنتی اغلب مقادیر زیادی از اسناد را ازقبل بارگیری می‌کنند که باعث مصرف تعداد زیادی ژتون و افزایش هزینه‌های جلسه می‌شود. مهارت‌های عامل از شفاف‌سازی تدریجی برای به‌حداقل رساندن این سربار استفاده می‌کنند:

  • دستیار هوش مصنوعی در ابتدا فقط نام و شرح مهارت را بررسی می‌کند تا ببیند آیا به درخواست شما مربوط است یا نه.
  • دستورالعمل‌ها و مراجع کامل مهارت فقط زمانی به پنجره بافت فعال اضافه می‌شوند که دستیار تشخیص دهد برای تکلیف خاص شما ضروری هستند، که این کار باعث صرفه‌جویی در فضای بافت می‌شود.

پیاده‌سازی با راهنمایی هوش مصنوعی

به‌جای جستجوی دستی در اسناد، می‌توانید قصدتان را به زبان طبیعی شرح دهید. مهارت‌ها دستیار هوش مصنوعی شما را برای انجام کارهایی مثل موارد زیر راهنمایی می‌کنند:

  • یک پُرسمان GAQL برای بازیابی سنجه‌های عملکرد پویش از حسابم تولید کن.
  • بااستفاده از کتابخانه‌های مشتری، یک اسکریپت Python برای ایجاد پویش جدید بنویسید.
  • بازیابی تبدیل‌های پویش و داده‌های عیب‌یابی بااستفاده از Google Ads API.

برای دیدن فهرست کامل مهارت‌های دردسترس، به مهارت‌های دردسترس مراجعه کنید.

استفاده از مهارت‌ها در کنار سرور MCP مربوط به Google Ads API

مهارت‌های عامل برای تکمیل سرور پروتکل بافتار مدل (MCP) Google Ads API طراحی شده‌اند:

  • سرور Google Ads API MCP: برای گردش‌های کاری توسعه با کمک هوش مصنوعی طراحی شده است، و به دستیارهای هوش مصنوعی امکان می‌دهد به‌صورت برنامه‌نویسی‌شده با منابع Google Ads API، پویش‌ها، و سنجه‌های شما تعامل داشته باشند.
  • مهارت‌های عامل Google Ads API: دستورالعمل‌های پیام‌واره و روش‌های توصیه‌شده‌ای را ارائه دهید که دستیار را برای انجام تکالیف ازطریق شفاف‌سازی تدریجی با مصرف بهینه از کد راهنمایی کند. این دستورالعمل‌ها به عامل می‌گویند که چگونه از ابزارهایی مثل سرور MCP و کتابخانه‌های کارخواه به‌طور مؤثر استفاده کند.

مهارت‌های دردسترس

تیم Google Ads API مجموعه‌ای از مهارت‌ها را برای ساختن با Google Ads API ارائه می‌دهد:

مهارت شرح
google-ads-api-account-diagnostics مشکلات عملکرد حساب Google Ads مانند ازدست رفتن تبدیل، حجم پایین مشتریان بالقوه، و سهم ظهور ازدست‌رفته به‌دلیل رتبه آگهی، پیشنهادهای قیمت، یا بودجه‌ها را بااستفاده از سرور MCP در Google Ads API تشخیص می‌دهد.
google-ads-api-mcp-setup به راه‌اندازی و پیکربندی سرور «پروتکل بافتار مدل» (MCP) در Google Ads API کمک می‌کند و اصالت‌سنجی و پیکربندی را در محیط‌های محلی ساده می‌کند.
google-ads-api-quickstart شما را در راه‌اندازی محیط توسعه‌دهنده، پیکربندی اطلاعات اعتباری، و برقراری اولین تماس میانای برنامه‌سازی کاربردی با Google Ads API راهنمایی می‌کند.

مراحل بعدی