Umiejętności agenta interfejsu Google Ads API

Umiejętności agenta interfejsu Google Ads API to przenośne, samodzielne moduły zawierające wiedzę, instrukcje i procesy związane z interfejsem Google Ads API. Umiejętności agenta interfejsu Google Ads API współpracują z asystentami AI , którzy obsługują otwarty standard umiejętności agenta, w tym Google Antigravity i Claude Code.

Te umiejętności agenta mają pomóc asystentom AI w zrozumieniu sprawdzonych metod korzystania z interfejsu Google Ads API, konfigurowaniu narzędzi i wykonywaniu procesów z większą dokładnością i niższym kosztem tokenów. Listę dostępnych umiejętności znajdziesz w sekcji Dostępne umiejętności.

Rozpocznij

Zainstaluj umiejętności agenta odpowiednie dla Twojego środowiska programistycznego.

Instalowanie umiejętności agenta interfejsu Google Ads API

W większości przypadków umiejętności agenta interfejsu Google Ads API można zainstalować w preferowanym edytorze za pomocą jednego polecenia:

Antigravity

Umiejętności agenta interfejsu Google Ads API są dostępne jako jeden z pakietów integracji Build with Google dla Antigravity. Ten pakiet możesz włączyć na 2 sposoby, aby uzyskać dostęp na poziomie globalnym:

  • Podczas wdrażania: zaznacz pole wyboru stosu interfejsu Google Ads API.
  • W ustawieniach:
    1. Kliknij Ustawienia > Dostosowania.
    2. W sekcji Wtyczki Build with Google kliknij Dostosuj, a potem kliknij Pobierz w przypadku integracji z interfejsem Google Ads API.

Jeśli wolisz dostęp na poziomie projektu, uruchom to polecenie w katalogu projektu:

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

Umiejętności agenta interfejsu Google Ads API możesz zainstalować bezpośrednio, dodając punkt końcowy repozytorium GitHub umiejętności (np. https://github.com/google/skills) w ustawieniach edytora w sekcji reguł niestandardowych. Więcej informacji znajdziesz w dokumentacji reguł kursora.

Inni agenci

W przypadku innych asystentów AI obsługujących otwarty standard umiejętności agenta możesz zainstalować umiejętności za pomocą NPX:

npx skills add google/skills

Aktualizowanie umiejętności agenta interfejsu Google Ads API

Aby pobrać wszystkie dostępne aktualizacje i usunąć nieaktualne umiejętności, uruchom polecenie update:

Antigravity

Integracje włączone za pomocą Build with Google są zarządzane i automatycznie aktualizowane przez edytor.

Jeśli umiejętności agenta zostały zainstalowane za pomocą polecenia npx, możesz pobrać wszystkie dostępne aktualizacje, uruchamiając polecenie update:

npx skills update --all

Claude Code 

claude plugin update google-ads@skills

Codex 

npx skills update --all

Kursor 

npx skills update --all

Inni agenci

W przypadku innych asystentów AI obsługujących otwarty standard umiejętności agenta możesz zaktualizować wszystkie aktywne umiejętności za pomocą NPX:

npx skills update --all

Korzystanie z umiejętności agenta interfejsu Google Ads API

Asystenci AI są zaprojektowani tak, aby automatycznie korzystać z umiejętności, gdy wykryją, że opis umiejętności pasuje do bieżącego żądania. Umiejętności zainstalowane globalnie pozostają nieaktywne w niezwiązanych projektach, chyba że kontekst prompta pasuje do zadań interfejsu Google Ads API.

Umiejętności można też wywoływać ręcznie, wpisując / w czacie agenta i wyszukując nazwę umiejętności.

Podstawowe komponenty umiejętności

Każda umiejętność agenta to specjalistyczny pakiet, który udostępnia asystentowi AI te komponenty:

  • Specjalistyczne instrukcje: szczegółowe instrukcje prompta wstawiane do okna kontekstu, aby pomóc asystentowi w generowaniu zapytań GAQL, konfigurowaniu danych uwierzytelniających OAuth i obsłudze typowych kodów błędów.
  • Sprawdzone metody: standardowe zalecenia dotyczące skuteczności, bezpieczeństwa i integracji określone przez zespół DevRel interfejsu Google Ads API.
  • Skrypty automatyzacji: skrypty wykonywalne (np. do sprawdzania środowiska lub konfigurowania obszaru roboczego) zawarte w pakietach umiejętności, które umożliwiają wykonywanie zadań lokalnie.

Zalety korzystania z umiejętności

Umiejętności agenta rozszerzają możliwości asystenta o specjalistyczną wiedzę na żądanie bez obciążenia związanego z wczytywaniem obszernych instrukcji do każdej rozmowy.

Niższe koszty tokenów

Tradycyjne integracje AI często wczytują z góry ogromne ilości dokumentacji, co zużywa znaczną liczbę tokenów i zwiększa koszty sesji. Umiejętności agenta minimalizują to obciążenie dzięki progresywnemu ujawnianiu informacji:

  • Asystent AI sprawdza początkowo tylko nazwę i opis umiejętności, aby sprawdzić, czy jest ona odpowiednia do Twojego żądania.
  • Pełne instrukcje i odniesienia do umiejętności są dodawane do aktywnego okna kontekstu tylko wtedy, gdy asystent stwierdzi, że są one niezbędne do wykonania konkretnego zadania, co pozwala zaoszczędzić miejsce w kontekście.

Implementacja z pomocą AI

Zamiast ręcznie przeszukiwać dokumentację, możesz opisać swój zamiar w języku naturalnym. Umiejętności pomagają asystentowi AI w wykonywaniu takich zadań jak:

  • Wygeneruj zapytanie GAQL, aby pobrać dane o skuteczności kampanii z mojego konta.
  • Napisz skrypt w Pythonie, używając bibliotek klienta, aby utworzyć nową kampanię.
  • Pobierz konwersje kampanii i dane diagnostyczne za pomocą interfejsu Google Ads API.

Pełną listę dostępnych umiejętności znajdziesz w sekcji Dostępne umiejętności.

Korzystanie z umiejętności razem z serwerem MCP interfejsu Google Ads API

Umiejętności agenta zostały zaprojektowane tak, aby uzupełniać serwer Model Context Protocol (MCP) interfejsu Google Ads API:

  • Serwer MCP interfejsu Google Ads API: zaprojektowany do procesów programowania z pomocą AI, umożliwiający asystentom AI programowe interakcje z zasobami, kampaniami i danymi interfejsu Google Ads API.
  • Umiejętności agenta interfejsu Google Ads API: zawierają instrukcje prompta i zalecane metody, które pomagają asystentowi w wykonywaniu zadań za pomocą progresywnego ujawniania informacji, które jest efektywne pod względem zużycia tokenów. Instruują agenta, jak skutecznie korzystać z narzędzi takich jak serwer MCP i biblioteki klienta.

Dostępne umiejętności

Zespół interfejsu Google Ads API udostępnia zestaw umiejętności do tworzenia aplikacji za pomocą interfejsu Google Ads API:

Umiejętność Opis
google-ads-api-mcp-setup Pomaga w konfigurowaniu serwera Model Context Protocol (MCP) interfejsu Google Ads API, upraszczając uwierzytelnianie i konfigurację w środowiskach lokalnych.
google-ads-api-quickstart Pomaga w konfigurowaniu środowiska programistycznego, danych uwierzytelniających i wykonywaniu pierwszego wywołania interfejsu Google Ads API.

Dalsze kroki