Заглянем агенту через плечо: что он делает на каждом шаге, к чему может прикасаться и почему результат так сильно зависит от того, как вы объяснили задачу.
В прошлом уроке цикл агента уместился в пять слов: цель, план, действия, проверка, вопрос к вам. Теперь пройдем его медленно, на одной задаче, как будто смотрим агенту через плечо: что он делает, что в этот момент видит и где может споткнуться.
Вы продакт приложения для изучения языков. В октябре команда поменяла экран подписки, и вам важно понять, как это приняли пользователи. Вы все это знаете. Агент получил одну строчку. (Если вы маркетолог, подставьте свою задачу, например «сводка по рассылкам за октябрь»: шаги у агента будут те же.)
Читает ваше сообщение и файл с правилами проекта, если он есть. Смотрит, какие инструменты у него под рукой.
«Подготовь сводку по отзывам за октябрь»
и больше ничего: ни зачем, ни для кого
Додумывает пробелы сам. Решит, что нужна сводка на три страницы, а вам нужно пять пунктов к пятничному созвону.
Раскладывает задачу на шаги. Хорошие агенты показывают план до начала работы, а если нет, его можно попросить.
План:
1. найти файлы с отзывами
2. разложить по темам
3. посчитать, что чаще
4. написать сводку
План выглядит логично, но про обращения в поддержку в нем ни слова. Агент про них просто не знает.
Ищет файлы в папке, открывает выгрузку, если нужно, идет в интернет. Каждое такое действие и есть работа инструментом.
→ ищу «отзывы» в папке
reviews_sep.csv
reviews_oct.csv
app_store_export.txt
→ открываю reviews_oct.csv
Берет лишнее или не то. Например, в app_store_export.txt отзывы за полгода, и если не проверить даты, в сводку попадет лето.
Читает, что вернул инструмент: строки файла, текст страницы или ошибку. И решает, что дальше: открыть следующий файл, пересчитать, поискать еще.
дата; оценка; текст
02.10; 1; «Где отменить подписку?»
02.10; 5; «Уроки огонь»
…и еще несколько сотен строк
Молча обходит проблему. Файл не открылся, а агент тихо работает с тем, что есть, и не говорит вам.
Останавливается, когда сам развилку не решит или собирается что-то изменить: сохранить файл, отправить сообщение.
app_store_export.txt: отзывы с мая по октябрь, у части нет даты
→ вопрос вам: брать только октябрь или все?
Спрашивает слишком мало, когда уверен в своей догадке. Или засыпает вопросами, когда задача совсем размытая.
Сверяет результат с задачей и показывает вам: сводку и коротко, что именно сделал.
задача: сводка по отзывам за октябрь
результат: 3 страницы, 7 тем
критерий «готово»: не указан
Останавливается слишком рано (три общие фразы) или слишком поздно (отчет на десять страниц, который никто не прочитает).
Заметили, откуда растут почти все ошибки? Агент видит только то, что лежит перед ним: ваше сообщение, файлы, которые он открыл, и ответы инструментов. Все, что у вас в голове, но не попало в задачу, для него просто не существует. Это и есть контекст. Ниже разберем, как его дать, а сначала про то, чем агент вообще действует.
Сама модель умеет только читать и писать текст (помните первый урок?). Все остальное ей дают инструменты, по сути руки агента. А разрешения решают, чем из этого он пользуется без вас.
Читает, создает и меняет файлы в той папке, которую вы ему открыли.
Откроет выгрузку отзывов и сохранит сводку рядом
Ищет и читает открытые страницы.
Посмотрит, на что жалуются в отзывах у конкурентов
Считает, группирует, строит графики. Часто для этого сам пишет маленькую программу и запускает ее. Читать ее вам не обязательно.
Посчитает, какая жалоба встречается чаще всего
Открывает сайты и нажимает кнопки почти как человек. Медленнее остальных инструментов, но выручает, когда по-другому никак.
Зайдет в админку и скачает свежую выгрузку, если вы его туда пустите
Notion, Jira, Slack, Google Drive и другие. MCP это общий стандарт, по которому сервисы подключают к агентам. Что-то вроде универсальной розетки: подключили один раз, и агент умеет с сервисом работать.
Заберет обращения из поддержки и положит сводку в Notion
Главное тут простое: чего нет в инструментах, того агент не сделает. Если обращения в поддержку живут в сервисе, к которому он не подключен, он их просто не увидит. Хороший агент так и скажет: «У меня нет доступа к поддержке, выгрузите файл или подключите сервис». Хуже, если он молча соберет сводку по тому, что нашел, и не упомянет, чего не хватило. Поэтому в задаче полезно сразу написать, где лежат данные.
Хороший агент умеет спрашивать, прежде чем что-то изменить или запустить. Насколько часто он спрашивает, зависит от режима разрешений. В режиме Manual Claude Code сам читает файлы, а перед тем как изменить файл или запустить команду, останавливается и ждет вашего ответа. По умолчанию в терминале сейчас стоит другой режим, auto, где вопросов гораздо меньше, поэтому на первые недели Manual лучше включить самим (как, расскажу в уроке 5). Вопрос выглядит примерно так:
Второй вариант удобен для безопасных действий, например, сохранять черновики в папку с результатами. А третий вообще не страшный: агент остановится, вы объясните, как надо, и он продолжит. Я бы делила действия на три группы:
Открывать и искать файлы в папке задачи. Ничего не меняется, но помните: все прочитанное видит модель в облаке.
Прочитать все выгрузки отзывов
Удалять файлы, запускать программы и расчеты, ходить в интернет, писать в Slack и почту, публиковать, заводить задачи. Все, что сложно отменить, что увидят другие люди или через что могут уйти данные.
Отправить сводку в общий канал команды
Платежи, пароли, рабочая почта целиком, права администратора в общих сервисах. Даже если агент давно ведет себя хорошо, это лучше оставить за собой.
Оплатить подписку на сервис аналитики
Тут важно выдохнуть: агент не получает доступы сам. Какие инструменты подключить и что разрешить, решаете вы. Ответ «нет» его не ломает (и не обижает, честно): он остановится и спросит, как сделать иначе. И начинать с режима «спрашивай про все» абсолютно нормально. По-моему, это самый мягкий способ привыкнуть. Если агент начал делать что-то не то, его можно остановить: в Claude Code клавиша Esc, в приложениях кнопка остановки. А последние правки там же можно откатить командой /rewind, правда, только в тех файлах, которые агент менял сам, а не через запущенные программы. Поэтому давайте агенту копии файлов, а не оригиналы.
Представьте, что в команду вышел толковый новичок. Умный, быстрый, но у него первый день. Вы же не скажете ему «сделай сводку по отзывам» и не убежите на созвон? (Хотя, будем честны, иногда мы так и делаем.) Агенту нужно ровно то же, что новичку.
Все, что агент знает о задаче, называют контекстом: ваше сообщение, файлы, примеры, правила проекта. Хорошая постановка задачи, она же бриф, собирает этот контекст в одном месте. Вот шесть вещей, которые я бы в него положила:
Не «сводка по отзывам», а «хочу понять, что пользователи думают про новый экран подписки». От цели зависит, что агент сочтет главным.
Кто будет читать и что с этим сделает. «Для пятничного созвона, читать будут разработчики и дизайнер, у них пять минут».
Что нельзя или не нужно. «Только 1–31 октября, только отзывы о приложении. Исходные файлы не меняй».
Конкретные файлы, папки и сервисы. «Выгрузки лежат в папке reviews, обращения в поддержку в папке support».
Прошлая сводка, которая понравилась, или пара строк образца. Один пример объясняет формат лучше абзаца описаний.
Критерий, по которому вы примете работу. «Готово, когда у каждой проблемы есть число упоминаний и 2–3 цитаты со ссылкой на файл».
Часть контекста одинаковая для любой задачи: что за продукт, кто пользователи, в каком тоне писать, что трогать нельзя. Повторять это в каждом брифе утомительно, поэтому это пишут один раз в специальный файл в папке проекта. Агент читает его в начале каждой работы.
В Claude Code такой файл называется CLAUDE.md, в Codex и многих других агентах AGENTS.md. Внутри обычный текст простыми словами, никакого кода. Буквы .md значат Markdown: это текст, где перед заголовком ставят решетку, а перед пунктом списка дефис. Например, так:
# Приложение для изучения языков Мы делаем мобильное приложение с подпиской. Пользователи: взрослые, которые учат английский в дороге и перед сном. ## Как работать - Пиши по-русски, коротко и без канцелярита. - Отзывы лежат в папке reviews, обращения в поддержку в папке support. - У каждой цифры и цитаты указывай файл, откуда она. - Исходные файлы не меняй, результат сохраняй в папку results. - Ничего не отправляй и не удаляй без моего подтверждения. - Если не уверен, спроси, а не додумывай.
Мне кажется, это самый недооцененный файл. Пишется за вечер, а пользу приносит в каждой следующей задаче. И его можно дописывать: агент ошибся, вы добавили одну строчку правила, и в следующий раз он, скорее всего, так уже не сделает. Только помните: это просьба, а не замок. Агент старается следовать файлу, но запрещает действия режим разрешений, а не текст в файле.
Одна и та же задача в двух постановках. Переключайте вкладки и смотрите, что сделает агент. Пример придуманный, но очень жизненный.
Подготовь сводку по отзывам за октябрь
Выглядит прилично, но на созвоне от нее мало пользы, и вы садитесь переделывать. Агент тут не виноват: он честно сделал сводку. Просто не ту.
Цель: понять, на что жалуются пользователи после нового экрана подписки (запустили 1 октября).
Для кого: пятничный созвон с командой. Читать будут разработчики и дизайнер, у них 5 минут.
Данные: в папке reviews файлы reviews_oct.csv и app_store_export.txt, в папке support файл support_oct.xlsx. Только 1–31 октября.
Ограничения: исходные файлы не меняй, результат сохрани в папку results. Отзывы на английском тоже учитывай.
Пример: как сводка за сентябрь в файле svodka_sep.md.
Готово, когда: есть 5 главных проблем, у каждой число упоминаний и 2–3 цитаты со ссылкой на файл. Если что-то непонятно, спроси.
Сводка, которую можно сразу показать на созвоне. И проверить ее легко: у каждой цифры есть источник.
Хороший бриф не обязан быть длинным. Даже три пункта из шести уже сильно меняют результат. А чего не хватает, хороший агент спросит сам, особенно если прямо написать ему: «если что-то непонятно, спроси».
Да, агенты ошибаются, и это нормально. Причин обычно четыре, и почти все мы уже встретили в этом уроке.
Агент работал с тем, что нашел, а нашел не то: старую выгрузку, черновик вместо финальной версии, файл за другой месяц.
«За месяц», «коротко», «главные проблемы» каждый понимает по-своему. Агент выбирает одно толкование и не всегда говорит, какое.
Нет доступа к сервису, сайт не открылся, файл слишком большой и прочитан не целиком. Хороший агент об этом скажет, но не всегда.
Когда данных не хватает, модель может заполнить пробел правдоподобным текстом: цитатой, которой не было, или цифрой с потолка. Это называют галлюцинацией, подробнее про нее было в первом уроке.
Попросите показать, откуда каждая цифра и цитата: файл, строка, ссылка. Потом откройте две-три наугад.
«Для каждой цитаты укажи файл и строку»
Попросите сделать задачу на кусочке, который вы проверите глазами за пару минут. Если там все честно, запускайте на весь объем.
«Сначала сделай сводку только по первой неделе октября»
Сравните с тем, что знаете сами. Если вы точно знаете, что главная боль в оплате, а в топе ее нет, это повод спросить «почему».
«Почему жалоб на оплату нет в топе? Покажи, как ты их считал»
Проверять агента не значит ему не доверять. Новичку вы же тоже первые недели перечитываете отчеты (и правильно делаете). Со временем станет понятно, где на него можно положиться, а где нужен ваш глаз.
Возьмите задачу, которую давно хочется кому-нибудь отдать. Заполните прямо здесь то, что уже знаете, пустые поля можно оставить. Ниже соберется текст: скопируйте его в ChatGPT или Claude, и он поможет превратить задачу в хороший бриф.
То, что вы пишете в полях, никуда не отправляется и не сохраняется: текст живет только на этой странице, пока она открыта. А если задача рабочая, не вставляйте в чат секретные данные компании. Для брифа хватит описания словами.
Если на созвоне прозвучит одно из них, вы точно поймете, о чем речь. Нажмите на слово, чтобы открыть его в словаре из второго урока.
Круг, по которому агент идет к цели: сделать шаг инструментом, посмотреть на результат, решить, что дальше. Повторяется, пока задача не готова.
Он застрял в цикле: третий раз открывает один и тот же файлВ словаре →
То, чем агент действует: файлы, поиск, таблицы, браузер, сервисы через MCP. Чего нет в инструментах, того он не сделает.
Подключи ему Notion, иначе он не увидит базу клиентовВ словаре →
Что агенту можно делать без вашего подтверждения. Читать обычно можно сразу, а удалять и отправлять лучше подтверждать.
Файлы в папке я ему разрешила, а в Slack он пишет только через меняВ словаре →
Все, что агент знает о задаче: ваш бриф, файлы, которые он открыл, ответы инструментов, правила проекта. Чего нет в контексте, того для него не существует.
Он не знал про новую оплату, этого не было в контекстеВ словаре →
Файл с правилами проекта, который Claude Code читает в начале каждой работы. В Codex и многих других агентах такой файл называется AGENTS.md.
Допиши в CLAUDE.md, что исходные файлы трогать нельзяВ словаре →
Три вопроса по уроку. Засчитывается первый ответ, а пояснение откроется у любого варианта. На сертификат это не влияет, это для себя.
Теперь вы знаете, как агент идет к цели, что ему можно и как поставить ему задачу, чтобы не переделывать. В следующем уроке знакомимся с Claude Code и Codex, агентами, которые работают прямо на вашем компьютере: что это и с какой задачи начать.
Хотите попробовать агентов на настоящих задачах? Для этого есть курсы-симуляторы: вы работаете в выдуманной компании и решаете ее задачи вместе с Claude Code или Codex.