Урок 1. С чем можно работать вместе с агентом

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

В прошлом уроке хватало вымышленной задачи в чате. Дальше агент будет читать файлы и предлагать изменения. Перед первым запуском посмотри на папку его глазами: всё, что в ней лежит, может попасть в контекст разговора, включая комментарии в коде, журналы и настройки.

С чего начать

Для общего упражнения возьми Demo83. Исходники и примеры следующих уроков рассчитаны на неё, и тебе не придётся искать учебную задачу в рабочем проекте.

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

Не знаешь, кому принадлежат исходники или что в них осталось от клиентов? Пока работай на Demo83. Вернуться к собственной задаче можно после выяснения доступа. Это решение относится к текущей задаче: разрешение на чтение кода не даёт разрешения открыть базу или менять рабочую конфигурацию.

Перед тем как открыть папку

Ответь себе на три простых вопроса:

1. Что увидит агент? Просмотри состав папки: нет ли там выгрузок данных, секретов, журналов, настоящих документов и скриншотов с клиентами. Ответы инструментов тоже попадают в разговор.
2. Что он сможет сделать? Для первого исследования хватит чтения. Запись файлов, запуск команд, доступ к сети и загрузка в 1С понадобятся позже и будут отдельными шагами.
3. Где будешь проверять результат? Нужна учебная база, которую можно восстановить. Рабочая база и случайно сделанная её копия для упражнений не подходят.

Файл AGENTS.md помогает объяснить агенту правила проекта, но сам по себе не ограничивает доступ и не очищает данные.

А если задача зависит от данных моей базы?

Допустим, тебе нужен отчёт по заказам из своей УНФ. Сначала можно исследовать разрешённые метаданные и код. Проверить запрос и цифры — на синтетических данных в отдельной учебной базе. Копию рабочей базы готовят лишь тогда, когда без её структуры или поведения задачу действительно не проверить.

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

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

Дальше

Для урока 2 выбери Demo83 или разрешённые исходники своей задачи. Никакую карточку решения заполнять не нужно. Перед открытием workspace ещё раз посмотри, какие файлы в него попали.