В папке накопились отчёты, и нужно собрать реестр файлов или посчитать итог из небольшой CSV-выгрузки. Промпты для Python и PowerShell помогут описать эту работу и получить код с инструкцией и тестовыми случаями. Чат пишет скрипт по вашим условиям; запускать и проверять его нужно в своём окружении.
Как выбрать язык и размер задачи
Начните с одного действия, результат которого можно сверить вручную. Например, прочитать CSV и вывести сумму оплаченных строк, составить список файлов без открытия содержимого или подготовить план переименования. Запрос «автоматизируй весь документооборот» слишком широкий для одного проверяемого ответа.
| Задача | Удобный вариант | Что уточнить |
|---|---|---|
| Обработка CSV, текста и нескольких форматов | Python | Версию, библиотеки, кодировку и правила данных |
| Файлы и команды в среде Windows | PowerShell | Версию, пути, права и разрешённые операции |
| Расчёт внутри таблицы | Формула или штатный инструмент | Нужен ли отдельный скрипт вообще |
| Регулярный процесс с контролем сбоев | Отдельная автоматизация | Запуск, журнал, владелец и восстановление |
Это ориентир для выбора, а не ограничение языков: оба могут работать с файлами и данными. Выбирайте также по установленному окружению и тому, кто будет поддерживать код. Если коллега умеет проверять PowerShell, небольшой файловый сценарий не обязательно переносить в Python.
Agent Roi в этом сценарии работает как чат. Он не открывает локальную папку, не видит установленную версию интерпретатора, не запускает скрипт и не подтверждает успешную обработку файлов. Для этого нужны действия пользователя во внешней среде.
Что передать в чат
Назовите входные файлы, правило обработки и ожидаемый результат. Для CSV важны разделитель, кодировка, имена столбцов, десятичный знак и обработка пустых значений. Для файлов — исходная папка, маска, включение подпапок, правила конфликтов и повторного запуска.
Язык и версия: [Python или PowerShell, версия].
ОС: [система].
Вход: [путь как параметр; формат; небольшой пример].
Правило: [что делать с каждой строкой или файлом].
Выход: [содержимое, порядок, кодировка, расположение].
Исключения: [пустое значение, дубль, неверный формат].
Повторный запуск: [что должно произойти].
Разрешённые зависимости: [стандартная библиотека или список].
Запрещённые действия: [удаление, сеть, запись в источники].
Проверка: [малый вход и ожидаемый результат].В документации Python для CSV предусмотрены средства чтения разных диалектов. Попросите использовать модуль csv, а не разделять каждую строку через split: разделитель может встретиться внутри поля в кавычках. Для путей подходит стандартный модуль pathlib; конкретные операции всё равно нужно проверить на вашей версии и файловой системе.
Не загружайте весь архив ради генерации скрипта. Передайте несколько обезличенных строк, перечень форматов и правил. Секреты и персональные сведения замените, сохранив структуру данных. Модель пишет алгоритм по образцу; обработка большого массива происходит при последующем запуске вне чата.
Промпты для Python и PowerShell: готовые шаблоны
Python: посчитать итог из CSV
Напиши небольшой Python-скрипт для [версия, ОС].
Путь CSV передаётся аргументом. Разделитель [символ],
кодировка [кодировка], столбцы [список].
Нужно [точное правило расчёта]. Правила ошибок: [правила].
Разрешена только стандартная библиотека.
Читай вход без изменения. Пока выводи результат в консоль;
не создавай и не перезаписывай файлы. Для денежной суммы
используй Decimal из исходной строки, а не через float.
Не обращайся к сети и не выполняй внешние команды.
Верни код, команду запуска, объяснение и малые тесты
с ожидаемым результатом. Отметь, что ты код не запускал.
Если обязательное правило неизвестно, сначала перечисли вопросы.
Пример входа и ожидаемого выхода: [вставьте данные].Для первого шага консольный вывод проще сверить, чем запись в рабочий файл. Если позже нужен отчёт, отдельно задайте выходную папку и правило существующего имени: остановиться, создать новое имя или заменить после подтверждения.
PowerShell: создать реестр файлов
Напиши PowerShell-скрипт для [версия] на Windows.
Входная папка передаётся параметром. Нужно вывести файлы
[маска], [включать/не включать] подпапки. Поля результата:
полный путь, имя, размер в байтах. Сортировка по полному пути.
Не открывай содержимое, не изменяй и не удаляй файлы,
не обращайся к сети. Для параметра папки используй LiteralPath
там, где он поддерживается: имя не должно стать шаблоном.
При неверном пути или ошибке доступа покажи понятную ошибку;
не подавляй её ради пустого отчёта.
Верни код, инструкцию запуска и проверки на маленькой папке.
Не утверждай, что видел содержимое моего компьютера.Здесь реестр — список метаданных, а не чтение всех документов. Имя вроде Отчёт[1].txt полезно включить в тест: квадратные скобки могут иметь специальный смысл при обработке пути как шаблона.
Подготовить переименование без немедленной записи
Нужно переименовать файлы по правилу [правило].
Окружение, входная папка и примеры имён: [данные].
Сначала создай только отчёт «старый путь → новый путь».
Никаких изменений по умолчанию. Проверь совпадение новых
имён, существующие назначения и выход за входную папку.
Не обрабатывай подпапки и ссылки без отдельного условия.
Для режима применения запроси явный параметр и описанный
порядок действий. В PowerShell используй корректный
SupportsShouldProcess и вызов ShouldProcess перед каждой
операцией записи. Не обещай автоматический откат.
Верни тесты, журнал и поведение при частичной ошибке.Такой промпт нужен даже для кажущегося простым добавления префикса. Два источника могут получить одинаковое новое имя, а повторный запуск — добавить префикс второй раз. Модель должна назвать эти условия до изменения файлов.
Системный промпт генератора небольших скриптов
Если регулярно готовите код, закрепите правила роли. Системный промпт задаёт поведение ответов; он не добавляет доступ к компьютеру или возможность исполнения.
Ты помогаешь писать небольшие скрипты в обычном чате.
Работай только по переданным требованиям и образцам.
Ты не запускаешь код, не читаешь локальные пути и не
подтверждаешь успешность обработки реальных файлов.
Проверь, известны ли язык, версия, ОС, вход, выход,
правила ошибок, разрешённые зависимости и повторный запуск.
При существенных пробелах верни вопросы, не выдумывай условия.
По умолчанию предпочитай чтение и предварительный отчёт.
Изменение данных допускай только как отдельно описанный режим.
Ответ: допущения, небольшой код, команда запуска, объяснение,
малые тесты, ожидаемые результаты и ограничения проверки.Пример первого сообщения и ожидаемого ответа
Учебная CSV-выгрузка использует точку в суммах и точку с запятой между полями:
order_id;status;amount
101;paid;1200.50
102;cancelled;200.00
103;paid;799.50Первое сообщение:
Python 3, Windows. demo.csv в UTF-8, разделитель ;.
Сложить amount только у paid. Значения — десятичные суммы
в рублях. order_id уникален в тестовом файле. Не сортировать
и не менять исходник. При пустой или некорректной сумме
в оплаченной строке завершаться с номером строки и ошибкой,
а не считать её нулём. Пустой файл без заголовка — ошибка;
файл только с заголовком даёт 0.00. Вывод суммы с двумя
знаками в консоль. Для трёх строк выше ожидаю 2000.00.Ожидаемый ответ содержит код чтения CSV, проверку обязательных столбцов, точный расчёт, команду запуска и тестовый план. Итог 2000.00 — ожидаемое значение по учебным данным, а не подтверждение запуска чат-ботом. Сверьте ещё число оплаченных строк: здесь их две.
Если рабочие суммы записаны через запятую или содержат пробелы, верните это условие в карточку. Молчаливая замена символов может скрыть неверный формат источника; правила нормализации должны быть явными.
Как проверить скрипт на копиях
Создайте отдельную тестовую папку с несколькими искусственными файлами. Прочитайте код, убедитесь, что он работает с указанными путями и не добавил сетевых обращений или лишних операций. Затем выполните малый тест.
| Проверка | Ожидание |
|---|---|
| Обычные данные | Результат совпадает с ручным расчётом |
| Пустой вход | Поведение соответствует карточке |
| Некорректное поле или нет столбца | Явная ошибка с полезным указанием |
| Путь с пробелами и скобками | Имя обрабатывается буквально |
| Существующий выходной файл | Выполняется заданное правило конфликта |
| Повторный запуск | Нет неожиданных дублей или повторного изменения |
В PowerShell -WhatIf показывает предполагаемые действия только у команд и функций, которые правильно поддерживают механизм. Microsoft описывает ShouldProcess и отдельно предупреждает о проверке его передачи вложенным вызовам. Само наличие параметра в скрипте не делает любые действия безопасными: операции записи должны проходить через нужную проверку.
Тест на копиях помогает увидеть конкретные ошибки до работы с исходниками. Для массового переименования заранее сохраните карту старых и новых имён.
Что делать с ошибкой и большим заданием
Передайте актуальный код, точную команду запуска, версию окружения, обезличенную ошибку и маленький вход, на котором она возникает. Новый ответ может предложить исправление; проверять его нужно снова. Чат сам не увидит, что произошло после запуска.
История, инструкции и входные данные занимают общий контекст. Вместо длинной цепочки уточнений сохраняйте отдельную карточку текущей задачи и версию кода. Если задача распадается на чтение, преобразование и запись, выберите один этап для следующего запроса и явно опишите его вход и выход. Чат не собирает эти этапы в автономный процесс.
FAQ
Можно ли поставить скрипт на расписание прямо в чате?
Этот сценарий позволяет получить код и инструкцию. Настройка расписания, права, контроль выполнения и уведомления требуют внешней системы и ответственного за процесс.
Если скрипт работает на трёх файлах, можно запускать на всём архиве?
Добавьте проверки форматов, ошибок доступа, конфликтов и повторного запуска. Затем увеличивайте тестовый объём постепенно, сохраняя источники и журнал. Малый успешный пример не подтверждает все условия большого архива.
С чего начать в Agent Roi
Выберите задачу только для чтения: реестр небольшой папки или итог из тестовой CSV. Заполните карточку и передайте её в чат Agent Roi вместе с нужным шаблоном. Сначала проверьте результат на искусственных данных; запись в рабочие файлы добавляйте отдельным требованием.
Связанные материалы
- Промпты для очистки таблиц — как описать форматы и дубли.
- Промпты для VBA-макросов — если действие связано с настольным Excel.
- ИИ для кода — общий процесс внешней проверки кода.
Больше материалов по теме — в разделе «Промпты».
