Для чего это нужно

Robin Copilot помогает создать схему робота по обычному текстовому описанию. Пользователь пишет, что должен сделать робот, а Copilot подготавливает действия в открытом проекте Studio Web.

Работа выполняется через браузерное расширение Robin Copilot. Для первого запуска понадобится адрес Robin Copilot Service, который выдаёт системный администратор. Остальные технические настройки пользователю не нужны.

Что нужно перед началом

Перед генерацией проверьте пять вещей:

1. Открыт браузер с установленным расширением Robin Copilot.
2. Вы вошли в Studio Web под своей учётной записью.
3. Открыт один проект робота в конструкторе Studio Web.
4. В браузере не открыто несколько проектов Studio Web одновременно.
5. Вы получили у системного администратора адрес Robin Copilot Service.

Если открыто несколько проектов, Copilot не поймёт, куда добавлять сценарий. Оставьте только нужный проект.

Коротко: как пользоваться

1. Откройте один проект Studio Web.
2. Откройте Robin Copilot.
3. Укажите выданный администратором адрес сервиса.
4. Выберите доступный Robin Copilot Service или одну из сохранённых локальных моделей.
5. Опишите задачу как последовательность шагов.
6. Нажмите Отправить.
7. Если Copilot попросил локаторы, выберите элементы на странице и нажмите Применить.
8. Если Copilot попросил ресурсы, заполните их в Studio Web.
9. Проверьте схему и запустите её на тестовых данных.

Как открыть Robin Copilot

1. Откройте нужный проект робота в Studio Web.
2. Нажмите на значок расширения Robin Copilot в браузере.
3. Дождитесь, пока откроется окно Robin Copilot.
4. В нижней панели выберите модель генерации.

Robin Copilot Service отображается только когда сервис Robin доступен. Если его нет в списке, можно добавить локальную OpenAI-compatible модель: укажите понятное название профиля, адрес API, API-ключ при необходимости и точное название модели. Сохранённые профили доступны в этом расширении на текущем компьютере; профиль можно изменить или удалить в том же меню.

Robin Copilot может открыться маленьким окном или боковой панелью браузера. Предпочтительно использовать вариант формат боковой панели.

Какую локальную модель выбрать

Для работы через локальную модель рекомендуется использовать модель не хуже Qwen 3.8-27B.

Качество подготовленного сценария полностью зависит от возможностей выбранной модели. Более качественная модель лучше понимает сложные запросы, точнее выбирает действия и реже пропускает шаги или создаёт ошибочную схему.

Также важен размер поддерживаемого контекста. Чем больше контекст модели, тем больше условий, действий и промежуточных данных она может учитывать одновременно.
Для сложных и длинных сценариев более качественная модель с большим контекстом, как правило, даёт лучший результат.

Как указать адрес сервиса

Адрес Robin Copilot Service выдаёт системный администратор. Обычно его нужно указать только один раз: расширение автоматически сохранит адрес на текущем компьютере.

1. Откройте Robin Copilot.
2. В нижней панели нажмите Выберите модель, Проверяю сервис… или название выбранной модели.
3. В открывшемся меню найдите поле Адрес сервиса.
4. Вставьте полный адрес, полученный у администратора, начиная с http:// или https://. Не добавляйте к нему названия отдельных методов сервиса. Пример - https://example.com:9443/copilot
5. Подождите, пока расширение проверит доступность сервиса.
6. Когда в списке появится Robin Copilot Service, выберите его.

Адрес сервиса нужен и при работе через внешюю модель Robin Copilot Service, и при выборе локальной модели. Если Robin Copilot Service не появился в списке, проверьте, что адрес введён без ошибок, и обратитесь к системному администратору.

Как написать запрос

В нижнем поле напишите задачу для робота и нажмите Отправить.

Главное правило: чем понятнее описание, тем лучше схема. Copilot не знает, что пользователь имел в виду "по умолчанию". Если написать только общий результат, Copilot может выбрать неправильные действия, пропустить важный шаг или оставить часть логики для ручной доработки.

Пишите простыми словами, но конкретно. Хорошее описание отвечает на вопросы:

• где робот должен работать;
• какие данные нужно взять;
• что нужно проверить или изменить;
• какой результат должен получиться;
• какие значения пользователь должен будет заполнить сам.

Хороший запрос обычно содержит не только цель, но и порядок действий:

1. откуда взять данные;
2. куда перейти;
3. что ввести или нажать;
4. что проверить;
5. куда записать или как показать результат.

Не нужно писать названия внутренних действий Studio Web. Copilot сам подберёт подходящие шаги.

Примеры хороших запросов

Простой сценарий

Создай робота, который показывает пользователю сообщение "Проверка завершена".

Работа с файлом

Создай робота, который открывает Excel-файл с заявками, проходит по строкам и для каждой строки проверяет статус заявки. Путь к файлу пользователь заполнит в ресурсах Studio.

Работа с сайтом

Создай робота, который открывает сайт Руспрофайл, вводит ИНН из ресурса в поле поиска, открывает найденную карточку компании и сохраняет найденное название организации.

Сценарий с условиями

Создай робота, который проверяет значение переменной "Сумма". Если сумма больше 100000, робот показывает сообщение "Нужна ручная проверка", иначе показывает "Можно обработать автоматически".

Как понять, что генерация идёт

После отправки запроса Copilot показывает процесс подготовки схемы. Это может занять несколько минут.

Во время генерации не закрывайте:

• вкладку с проектом Studio Web;
• окно расширения Robin Copilot;
• браузер.

Когда генерация завершится, Copilot покажет сообщение с результатом.

Что произойдёт после успешной генерации

Если Copilot смог подготовить сценарий полностью, схема появится в открытом проекте Studio Web.

После этого:

1. Проверьте добавленные действия на схеме.
2. Заполните ресурсы, которые Copilot попросил заполнить вручную.
3. Сохраните проект.
4. Запустите робота на тестовых данных.

Не запускайте новый сценарий на важных данных без проверки.

Что такое "Нужны локаторы"

Иногда роботу нужно работать с элементами на сайте: кнопками, полями ввода, таблицами, ссылками. Copilot может подготовить сценарий, но попросить вас показать конкретные элементы на странице.

В этом случае в расширении появится блок Нужны локаторы.

Как захватить локаторы

1. Откройте страницу сайта, с которой должен работать робот.
2. Вернитесь в расширение Robin Copilot.
3. В блоке Нужны локаторы нажмите Захватить напротив первого элемента.
4. Наведите курсор на нужный элемент на странице.
5. Кликните по этому элементу.
6. Повторите действия для всех элементов в списке.
7. Когда все элементы выбраны, нажмите Применить.

Если выбрали не тот элемент, нажмите Заново и выберите правильный.

Чтобы отменить выбор во время захвата, нажмите Esc.

Как выбирать элементы на странице

Выбирайте именно тот элемент, с которым должен работать робот.

Примеры:

• если робот должен ввести текст, выбирайте поле ввода;
• если робот должен нажать кнопку, выбирайте саму кнопку;
• если робот должен прочитать значение из таблицы, выбирайте нужную ячейку или область таблицы;
• если рядом есть похожие элементы, выбирайте самый конкретный вариант.

Если сайт меняет вид после ввода данных, сначала вручную приведите страницу к нужному состоянию, а потом захватывайте элемент.

Что такое "Заполните ресурсы в Studio"

Copilot может создать сценарий, но оставить некоторые значения для ручного заполнения. Например:

• путь к файлу;
• логин или другое пользовательское значение;
• дату;
• папку для сохранения результата;
• элемент Windows-приложения, который нужно выбрать через Win-шпион.

Такие значения появятся в блоке Заполните ресурсы в Studio.

Что делать:

1. Откройте ресурсы проекта в Studio Web.
2. Найдите ресурс с названием из подсказки Copilot.
3. Заполните значение.
4. Сохраните проект.

Если ресурс связан с Windows-приложением, выберите его через Win-шпион в Studio.

Как писать запрос, чтобы результат был лучше

Запрос должен быть похож на короткую инструкцию для человека, который видит задачу впервые. Не рассчитывайте, что Copilot сам догадается, на каком сайте работать, где находится поле поиска, какой результат считать правильным и что делать после проверки.

Плохо:

Сделай робота для заявок.

Лучше:

Создай робота, который открывает Excel-файл с заявками, берёт ИНН из каждой строки, ищет организацию на сайте, сохраняет найденное название в соседний столбец и показывает сообщение после обработки всех строк.

Плохо:

Автоматизируй сайт.

Лучше:

Создай робота, который открывает сайт, вводит номер договора в поле поиска, нажимает кнопку "Найти", проверяет статус договора и показывает пользователю найденный статус.

Плохо:

Сделай как в инструкции.

Лучше:

Создай робота по шагам: открыть страницу входа, ввести логин из ресурса, ввести пароль из ресурса, нажать "Войти", открыть раздел "Отчёты", скачать отчёт за текущий месяц.

Плохо:

Сделай робота, который запрашивает ИНН, заходит на Руспрофайл и выводит результат проверки.

Почему плохо:

• не сказано, где именно робот должен взять ИНН;
• не сказано, в какую строку поиска его вводить;
• не сказано, какие признаки нужно проверить;
• не сказано, что считать результатом проверки;
• не сказано, как показать результат пользователю.

Лучше:

Создай робота, который запрашивает у пользователя ИНН, открывает сайт Руспрофайл, вводит ИНН в строку поиска, открывает найденную карточку компании, проверяет наличие признаков "Недобросовестные поставщики" и "Налоговая задолженность", затем показывает пользователю сообщение с результатом: какие признаки найдены, а какие нет.

Ещё лучше, если заранее понятно, что часть элементов сайта нужно будет выбрать вручную:

Если Copilot попросит локаторы, я выберу на странице строку поиска, кнопку поиска, карточку найденной компании и блоки с результатами проверок.

Что обязательно указывать в сложных запросах

Если сценарий работает с сайтом, файлом или несколькими условиями, добавьте в описание эти детали:

• источник данных: пользователь вводит значение, данные лежат в ресурсе, файле или таблице;
• точное место работы: сайт, страница, раздел, файл или приложение;
• основные клики и вводы: что открыть, куда ввести значение, какую кнопку нажать;
• проверяемые признаки: какие тексты, статусы, поля или значения нужно найти;
• результат: сообщение пользователю, запись в файл, ресурс или переменную;
• что делать, если данные не найдены.

Пример:

Создай робота, который запрашивает ИНН у пользователя. Затем открывает сайт Руспрофайл, вводит ИНН в поле поиска, открывает первую найденную организацию и проверяет блоки "Недобросовестные поставщики" и "Налоговая задолженность". Если блок найден, робот пишет в сообщение "Найдено: ..." и перечисляет найденные признаки. Если ничего не найдено, робот показывает "Проверки не выявили признаков риска".

Проверка запроса перед отправкой

Перед тем как нажать Отправить, проверьте свой текст:

• понятно, откуда робот берёт входные данные;
• понятно, где робот должен работать;
• перечислены основные шаги в правильном порядке;
• указано, какие поля, кнопки, таблицы или блоки нужно использовать;
• указано, что считать успешным результатом;
• указано, что делать, если данные не найдены;
• секретные данные не вставлены в текст запроса.

Если на один из пунктов нельзя ответить "да", лучше дописать запрос.

Что можно просить

Copilot хорошо подходит для черновика сценария, если задачу можно описать последовательными шагами.

Можно просить:

• создать простую цепочку действий;
• добавить условия;
• добавить циклы по строкам таблицы или списка;
• подготовить работу с файлами;
• подготовить работу с сайтом;
• создать ресурсы, которые пользователь потом заполнит вручную;
• показать сообщение пользователю;
• сохранить полученный результат в ресурс или файл.

Что лучше не просить одним запросом

Слишком большую задачу лучше разбить на части.

Не стоит одним запросом просить:

• полностью автоматизировать большой бизнес-процесс без деталей;
• сделать сценарий сразу для нескольких разных сайтов;
• описывать десятки разных веток логики без примеров;
• использовать данные, которых нет в проекте и которые вы не готовы заполнить;
• выполнять действия с реальными важными данными без тестовой проверки.

Если задача большая, сначала попросите Copilot сделать основу сценария. Затем проверьте результат и добавьте недостающие части отдельными действиями в Studio.

Частые ситуации

Сообщение "Откройте проект робота в Studio Web."

Откройте проект робота в конструкторе Studio Web и повторите запрос.

Сообщение "Оставьте открытым один проект Studio Web."

Закройте лишние вкладки Studio Web. Должен остаться один проект, в который нужно добавить сценарий.

Сообщение "Не удалось определить проект робота из текущей вкладки."

Обновите страницу Studio Web. Если не помогло, закройте проект и откройте его заново из списка проектов.

Сообщение "Не удалось получить авторизацию Studio Web из текущей вкладки."

Проверьте, что вы вошли в Studio Web. Если сессия истекла, войдите снова и повторите запрос.

Сообщение "Сервис генерации вернул ошибку"

Повторите запрос позже. Если ошибка повторяется, передайте администратору:

• время ошибки;
• адрес стенда Studio Web;
• текст запроса;
• скриншот сообщения в Robin Copilot.

Не отправляйте пароли, коды доступа и другие секретные данные.

Сообщение "Не получилось подготовить сценарий по текущему описанию"

Сделайте описание конкретнее:

• укажите, с каким сайтом, файлом или приложением нужно работать;
• перечислите основные шаги;
• напишите, какие данные берутся из ресурсов;
• напишите, что должно получиться в конце.

Появился блок "Заполните ресурсы в Studio"

Откройте блок ресурсов в Studio Web и заполните значения, которые Copilot пометил для ручного заполнения.

Схема подготовлена, но работает не так, как ожидалось

Проверьте схему в Studio Web:

1. Убедитесь, что порядок действий правильный.
2. Проверьте заполненные ресурсы.
3. Проверьте выбранные локаторы.
4. Запустите сценарий на тестовых данных.
5. Исправьте схему вручную или создайте новый запрос с более точным описанием.

Ограничения

Robin Copilot помогает быстрее собрать сценарий, но не заменяет проверку пользователем.

Пользователь отвечает за то, чтобы:

• проверить схему перед запуском;
• заполнить нужные ресурсы;
• проверить сценарий на тестовых данных;
• не передавать в запрос пароли, ключи доступа и другие секреты;
• не запускать непроверенный сценарий на важных данных.

Памятка перед запуском сценария

Перед запуском убедитесь, что схема проверена, нужные ресурсы заполнены, а первый запуск выполняется на тестовых данных.