Яндекс Директ: Управление группами объявлений

Управление группами объявлений

Используй этот скилл, когда пользователь просит выполнить задачу в Яндекс Директ: Создать или обновить группы объявлений и проверить их связь с кампанией.

Перед началом

1. Открой актуальную официальную документацию: https://yandex.ru/dev/direct/doc/ru/
2. Уточни целевой аккаунт, объект, период и ожидаемый результат.
3. Проверь авторизацию: OAuth-токен Яндекс ID и доступ к API Директа.
4. Никогда не проси вставлять секрет в чат и не выводи его в команды, логи или ответ.

Порядок работы

1. Сначала выполни доступный read-only запрос и проверь идентификаторы объектов.
2. Учитывай пагинацию, лимиты, актуальную версию API и повтор с backoff для 429/5xx.
3. Выполни задачу: Создать или обновить группы объявлений и проверить их связь с кампанией.
4. Для повторяемой записи используй идемпотентность либо предварительную проверку текущего состояния.
5. После изменения перечитай объект через API и сравни фактическое состояние с запросом пользователя.
6. Верни краткий отчёт: что изменено, идентификаторы, ошибки и что осталось сделать вручную.

Ограничения безопасности

• Перед удалением, публикацией, денежной операцией, запуском рекламы или необратимой сменой статуса получи явное подтверждение.
• Не расширяй права токена и не работай с аккаунтами, которые пользователь не указал.
• Не обходи модерацию, тарифные ограничения, rate limits и правила обработки персональных данных.
• Если документация расходится с памятью или примером, следуй текущей официальной документации.

Источник

• https://yandex.ru/dev/direct/doc/ru/
• Исходный Agent Skill: https://github.com/VKirill/yandex-direct-docs