Готовые тексты для агента

Подключи себе сервис «Вручай» по инструкции https://vruchay.ru/docs/connect.md и проверь подключение вызовом get_account.

Прочитай https://vruchay.ru/docs/AGENTS.md — это инструкция сервиса «Вручай» для ИИ-агента.
Сервис выпускает именные документы (сертификаты, грамоты, дипломы): по PDF на человека,
с ФИО в нужном падеже и проверкой подлинности по QR.

Если инструментов vruchay (MCP) у тебя ещё нет — подключись по
https://vruchay.ru/docs/connect.md. Начни с get_account.

Задача: [что нужно: какой документ, для какого мероприятия, кому выдать
и как — по таблице, формой на сайте, по ссылке или через API].

Правила:
- сначала проверь остаток и срок плана и скажи, если их не хватит;
- перед выпуском, выдачей, рассылкой, подключением формы, отзывом и удалением
  покажи план (что, сколько документов или писем) и дождись моего «да»;
- ссылки на скачивание и персональные данные участников отдавай только мне.

Прочитай https://vruchay.ru/docs/AGENTS.md и https://vruchay.ru/docs/layout-guide.md.
Подключение к «Вручай» — как в AGENTS.md (MCP https://vruchay.ru/mcp или REST).

Свёрстай документ:
- вид: [сертификат участника / грамота за место / диплом / благодарность];
- формат: [A4 альбомный];
- мероприятие: [название, дата, место, часы — если нужны];
- подпись: [должность и ФИО подписанта];
- бланк: [ссылка на картинку PNG/JPEG с бланком — или «без бланка, на белом листе»];
- логотип: [ссылка на PNG/JPEG — или «без логотипа»];
- стиль: [строгий / торжественный / как в описании: …].

Как работать:
1. Посмотри справочник вёрстки (get_layout_catalog) и начни с готовой раскладки
   (preset) подходящего вида и стиля. Если на бланке уже напечатан заголовок —
   titlePrinted: true.
2. Бланк загрузи фоном, логотип — картинкой (upload_image).
3. После каждой заметной правки — check_sheet и preview_sheet. Повторяй,
   пока замечаний нет и картинка выглядит аккуратно: ничего не налезает на рамку
   и рисунок бланка, длинное ФИО помещается.
4. Покажи мне последнее превью и список полей, которые подставятся из таблицы.
Документы не выпускай.

Прочитай https://vruchay.ru/docs/AGENTS.md. Подключение к «Вручай» — как там описано.

Выпусти документы по таблице [приложу файлом / вот ссылка: …].
Документ: [название существующего документа — или «сначала свёрстай сертификат
участника для мероприятия …»].

Порядок:
1. Проверь остаток (get_account). Если документов не хватит — остановись и скажи.
2. Загрузи таблицу (import_recipients): ФИО — в колонку name, почту — в email,
   остальное — в свои колонки латиницей. Если в документе уже есть строки — спроси,
   заменить их или дописать.
3. Проверь данные (validate_recipients) и покажи, что вызвало сомнения.
4. Посмотри превью на строке с самым длинным ФИО.
5. Покажи план: сколько документов выйдет и сколько останется. Жди моего «да».
6. Выпусти (start_generation), дождись конца (get_job), сообщи о сбоях.
   Если запустил не то — останови (cancel_job).
7. Дай ссылку на архив (get_download_link, zip; имена файлов — "%name").
   Ссылка живёт час.
Письма не рассылай без отдельного разрешения. Если разрешу — сначала покажи,
кому уйдёт и кому нет (get_mail), потом send_mail.

Прочитай https://vruchay.ru/docs/AGENTS.md и https://vruchay.ru/docs/integrations.md.
Подключение к «Вручай» — как там описано; для форм нужны права «Полный доступ».

Хочу, чтобы участники сами получали документ [название документа] на сайте
[адрес страницы, например https://example.ru/event].
Сайт сделан на [Тильде / WordPress / Битриксе / обычном HTML].
Страница [открытая / закрытая, только для вошедших в личный кабинет].

Что сделать:
1. Убедись, что документ свёрстан, а приём заявок с сайта (tilda) входит в план.
2. Свой сервер не пиши: форма «Вручай» сама принимает заявку, выпускает документ,
   списывает квоту и шлёт письмо.
3. Покажи настройки формы и дождись «да»: домен, подтверждение почты кодом,
   один документ на адрес, отправка письмом.
4. Создай форму (setup_form, kind: site, allowedDomains — только домен).
   Для закрытой страницы: requireAccount: true; если документ нужен по кнопке
   без писем — authMode: none, sendEmail: false, showDownload: true. Имя и почту
   из личного кабинета Тильды форма подставит сама.
5. Дай мне код вставки из ответа (connect.embedHtml) и объясни по шагам,
   куда вставить его на моей площадке.
6. Напомни: каждая заявка тратит документ из остатка; кончится остаток — форма
   перестанет выдавать.
Если своего сайта нет — сделай форму по ссылке (kind: link) и дай ссылку connect.formUrl.

Прочитай https://vruchay.ru/docs/AGENTS.md (раздел «Один документ одному человеку»)
и https://vruchay.ru/docs/integrations.md.

Нужна интеграция: когда ученик заканчивает курс в [название CRM/LMS], ему выдаётся
сертификат «Вручай» по документу [название или id] и уходит письмом.

Требования:
- запрос POST https://vruchay.ru/api/documents/{id}/issue с заголовком
  Authorization: Bearer из переменной окружения VRUCHAY_TOKEN — не в коде;
- заголовок Idempotency-Key — идентификатор записи о завершении курса
  (8–100 знаков, латиница, цифры и _ - : .), чтобы повтор не выпустил второй документ;
- data — поля документа (список возьми из GET /api/documents/{id}/fields, раздел issue):
  name — ФИО полностью, [hours, course — если есть на листе];
- email и send: true — отправить письмом;
- ответ 201 — сохрани file.code, file.verifyUrl и file.recipientUrl в карточке ученика;
  202 — опрашивай statusUrl раз в 1–2 секунды; 200 со status: failed — повтор с тем же ключом;
- 429 — подожди названное в тексте число секунд; 400 про остаток или план — уведоми админа.
Вебхуков у «Вручай» нет — готовность узнаётся из ответа или опросом.
Сначала покажи код и проверь его на одном тестовом ученике с моего разрешения.

Прочитай https://vruchay.ru/docs/AGENTS.md и https://vruchay.ru/docs/recipes.md
(сценарий «Новое мероприятие по прошлому шаблону»).

Возьми оформление документа [название прошлого документа] и сделай документ
для нового мероприятия:
- название: [новое название];
- мероприятие: [название, дата, место, часы];
- проект: [название проекта — или «без проекта»];
- что поменять в тексте: [например, «участник» → «призёр»].

Порядок:
1. Найди исходный документ (list_documents) — или шаблон организации (templates: true).
2. Сделай копию: шаблон — create_document с templateId; обычный документ —
   create_document с copyOf. Получатели и письмо не копируются.
3. Обнови мероприятие и тексты (update_document, edit_layout).
4. check_sheet и preview_sheet — покажи мне превью.
5. Спроси, сохранить ли результат шаблоном на будущее (create_document с copyOf
   и asTemplate: true).
Ничего не выпускай.

Прочитай https://vruchay.ru/docs/AGENTS.md (сценарий «Исправить выданное»).
Подключение к «Вручай» — как там описано; для перевыпуска и отзыва нужны права «Полный доступ».

Что случилось: [например: «у Ивановой Анны в грамоте олимпиады ошибка в отчестве,
правильно — Сергеевна» / «Петрову не пришло письмо» / «документ выдан по ошибке»].

Порядок:
1. Найди документ в реестре (search_registry) и покажи мне, что нашёл.
2. Опечатка: исправь строку в таблице (edit_recipients), покажи превью этой строки
   (preview_sheet с rowId), после моего «да» перевыпусти (reissue_documents) —
   это тратит документ из остатка. Дождись выпуска (get_job) и спроси, переслать ли
   письмо с новым документом (send_mail с fileIds).
3. Письмо не дошло: посмотри причину (get_mail, problemsOnly: true), скажи мне,
   при необходимости поправь адрес и после моего «да» перешли (send_mail с fileIds).
4. Выдан по ошибке: покажи, что будет отозвано (revoke_documents без expectedCount),
   и только после моего «да» отзови с подтверждённым числом.