مهارت‌های عامل هوش مصنوعی Google Analytics

برای ساختن ادغام‌های گزارش‌دهی و مدیریت دارایی Google Analytics با دقت بالاتر و سربار کمتر کد، عامل کدنویسی هوش مصنوعی خود را به مهارت‌های عامل هوش مصنوعی Google Analytics مجهز کنید. مهارت‌های عامل هوش مصنوعی Google Analytics برای توسعه‌دهندگانی طراحی شده است که با Google Analytics Data API و Google Analytics Admin API کار می‌کنند. این مهارت‌ها ماژول‌های قابل‌حمل و مستقل از دستورالعمل‌ها، گردش‌های کاری، و مراجع کتابخانه مشتری هستند.

این مهارت‌های عامل هوشواره‌ای با عامل‌های کدنویسی هوشواره‌ای که از استاندارد open Agent Skills پشتیبانی می‌کنند کار می‌کنند، ازجمله Google Antigravity،‏ Claude Code،‏ Codex، و Cursor. برای دیدن فهرست مهارت‌های منتشرشده، به مهارت‌های دردسترس مراجعه کنید.

قبل‌از شروع

قبل‌از نصب و اجرای مهارت‌های عامل هوش مصنوعی Google Analytics، پیش‌نیازهای زیر را تکمیل کنید:

  • یک عامل کدنویسی هوش مصنوعی نصب کنید که از استاندارد باز Agent Skills پشتیبانی کند، مثل Google Antigravity،‏ Claude Code،‏ Codex، یا Cursor.
  • Node.js را نصب کنید که شامل فرمان npx برای نصب و به‌روزرسانی مهارت‌ها از خط فرمان است.
  • هنگام اجرای گردش‌های کاری میانای برنامه‌سازی کاربردی، پروژه‌ای با دسترسی به دارایی Google Analytics ایجاد یا انتخاب کنید.

شروع کنید

مهارت‌های عامل هوش مصنوعی Google Analytics را در محیط توسعه نرم‌افزار خود نصب، به‌روزرسانی، و فراخوانی کنید.

نصب مهارت‌های عامل هوش مصنوعی Google Analytics

بااستفاده از فرمان npx، مجموعه مهارت Google Analytics را در فهرست راهنمای پروژه‌تان نصب کنید یا ویرایشگرتان را مستقیماً پیکربندی کنید:

Antigravity

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

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

Claude Code

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

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

Codex

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

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

مکان‌نما

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

یا اینکه مهارت‌ها را بااستفاده از فرمان npx در فهرست راهنمای پروژه‌تان نصب کنید:

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

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

برای سایر نمایندگان کدنویسی هوش مصنوعی که از استاندارد باز Agent Skills پشتیبانی می‌کنند، فرمان زیر را در دایرکتوری پروژه خود اجرا کنید:

npx skills add google/skills/skills/analytics

به‌روزرسانی مهارت‌های عامل هوش مصنوعی Google Analytics

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

npx skills update --all

استفاده از مهارت‌های عامل هوش مصنوعی Google Analytics

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

برای فراخوانی دستی مهارت در عامل‌های کدنویسی با هوش مصنوعی پشتیبانی‌شده، نویسه / را در ورودی گپ وارد کنید و مهارت را براساس نام انتخاب کنید.

عناصر اصلی مهارت

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

  • دستورالعمل‌های تخصصی: راهنمای گام‌به‌گام برای فعال کردن Google Analytics APIs با gcloud CLI، پیکربندی اعتبارنامه‌های پیش‌فرض برنامه (ADC)، ساختن runReport پرس‌وجوها، و بررسی سازگاری فیلد.
  • روال‌های مطلوب: انتخاب نسخه API توصیه‌شده (پایانه‌های v1beta برای پایداری عمومی و پایانه‌های v1alpha برای ویژگی‌های Admin API با دسترسی زودرس)، ساخت درخواست با نوع قوی، و گردش‌های کاری اعتبارسنجی طرح‌واره.
  • اسناد مرجع: راهنماهای نصب کتابخانه مشتری مختص زبان و نمونه کدها برای Python،‏ Java،‏ Node.js،‏ PHP،‏ Go،‏ ‎.NET، و Ruby در فهرست راهنمای references/ هر مهارت.

مزایای مهارت‌های عامل هوش مصنوعی

مهارت‌های عامل هوش مصنوعی، عامل کدنویسی هوش مصنوعی شما را با دانش تخصصی Google Analytics درصورت درخواست گسترش می‌دهد، بدون اینکه نیاز باشد مجموعه‌های بزرگ اسناد را در هر مکالمه بارگیری کنید.

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

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

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

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

هدف خود را به زبان طبیعی شرح دهید و مهارت‌های نصب‌شده، نماینده کدنویسی هوش مصنوعی شما را در انجام تکالیف پیاده‌سازی Google Analytics مانند موارد زیر راهنمایی می‌کنند:

  • ‫Google Analytics Data API را در پروژه من فعال کن و یک اسکریپت Python بنویس که سنجه‌های activeUsers و sessions را براساس ابعاد city و date پُرسمان کند.
  • بااستفاده از روش checkCompatibility، بررسی کنید که آیا بُعد itemName با سنجه‌های activeUsers و totalRevenue برای دارایی Google Analytics من سازگار است یا نه.
  • بااستفاده از Google Analytics Admin API، همه خلاصه‌های حساب Google Analytics و دارایی‌های فرزند قابل‌دسترسی را در Node.js فهرست کنید.
  • پیکربندی ابعاد سفارشی، جریان‌های داده، و رازهای «پروتکل اندازه‌گیری» برای دارایی Google Analytics من.

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

مهارت‌های عامل هوش مصنوعی Google Analytics مکمل سرور «پروتکل بافتار مدل» (MCP) در Google Analytics است:

  • سرور MCP در Google Analytics: عامل کدنویسی هوش مصنوعی شما را مستقیماً به دارایی‌های Google Analytics زنده متصل می‌کند تا عامل بتواند خلاصه‌های حساب، جزئیات دارایی، ابعاد سفارشی، سنجه‌های سفارشی، و گزارش‌های زنده را بررسی کند.
  • مهارت‌های عامل هوشواره‌ای Google Analytics: دستورالعمل‌های کارآمد ازنظر مصرف ژتون و مراجع کتابخانه مشتری را ارائه می‌دهد که عامل کدنویسی هوش مصنوعی شما را هنگام فعال کردن میاناهای برنامه‌سازی کاربردی، پیکربندی اصالت‌سنجی ADC، بررسی سازگاری فیلد، و نوشتن کد برنامه راهنمایی می‌کند.

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

Google مهارت‌های عامل هوش مصنوعی Google Analytics زیر را در مخزن google/skills نگهداری می‌کند:

مهارت شرح
google-analytics-data-api-basics Google Analytics Data API (analyticsdata.googleapis.com) را با gcloud CLI فعال می‌کند، ADC را با دامنه analytics.readonly OAuth 2.0 پیکربندی می‌کند، و کتابخانه‌های مشتری رسمی v1beta (Python،‏ Java،‏ PHP،‏ Node.js،‏ Go،‏ ‎.NET، و Ruby) را نصب می‌کند. عامل شما را در ساختن پُرسمان‌های runReport و بررسی سازگاری فیلد با روش‌های getMetadata و checkCompatibility راهنمایی می‌کند.
google-analytics-admin-api-basics ‫Google Analytics Admin API‏ (analyticsadmin.googleapis.com) را با gcloud CLI فعال می‌کند، ADC را با دامنه‌های OAuth 2.0‏ analytics.readonly و analytics.edit پیکربندی می‌کند، و کتابخانه‌های مشتری رسمی v1beta و v1alpha (Python،‏ Java،‏ PHP،‏ Node.js،‏ Go،‏ ‎.NET، و Ruby) را نصب می‌کند. نماینده شما را در فهرست کردن خلاصه‌های حساب و مدیریت دارایی‌ها، جریان‌های داده، ابعاد سفارشی، سنجه‌های سفارشی، رویدادهای کلیدی، رازهای «پروتکل اندازه‌گیری»، و پیوندهای محصول راهنمایی می‌کند.

مراحل بعدی