Как создать ИИ-агента: пошаговая инструкция без программирования

Что такое ИИ-агент простыми словами

В Anthropic агентами называют системы, в которых языковая модель сама направляет ход работы и выбирает инструменты, сохраняя контроль над тем, как выполнить задачу. Проще говоря: вы ставите цель, а агент планирует шаги, выполняет их и показывает результат.

Основа любого агента — модель, дополненная поиском информации, инструментами и памятью. Инструменты — это то, что агент умеет делать в реальном мире: читать и создавать файлы, запускать команды, обращаться к другим сервисам.

Чем агент отличается от чат-бота

Чат-бот отвечает текстом, а дальше вы всё делаете сами: копируете ответ, переносите данные, проверяете. Агент работает с вашими файлами и инструментами напрямую. Например, Claude Code читает файлы проекта, редактирует их и выполняет команды. Поэтому агенту нужны не только хорошие инструкции, но и границы: что ему можно делать без вашего подтверждения, а что нельзя.

Из чего состоит ИИ-агент

Часть агента	Что это	Как это выглядит в Claude Code
Модель	Языковая модель, которая понимает задачу и планирует шаги	Модель Claude, её можно выбрать для агента
Инструкции	Описание роли, задачи, правил и формата результата	Файл агента или CLAUDE.md с постоянными инструкциями
Инструменты	Действия, доступные агенту: чтение файлов, команды, внешние сервисы	Поле tools в файле агента, подключения через MCP
Контекст	Данные, с которыми работает агент	Папка проекта, файлы, которые вы даёте агенту
Проверки	Правила, по которым агент и человек оценивают результат	Чек-лист в инструкциях и ваша проверка

Агент в Claude Code описывается обычным текстовым файлом: в начале — название, описание и список инструментов, ниже — инструкции. Постоянные правила проекта хранятся в файле CLAUDE.md: Claude Code читает его в начале каждой сессии.

Когда агент нужен, а когда хватит простого сценария

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

Хорошие задачи для первого агента:

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

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

Примеры ИИ-агентов для бизнеса

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

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

Как создать ИИ-агента: пошагово

Шаг 1. Выберите одну повторяющуюся задачу

Начните с задачи, которую вы уже делаете руками по понятным правилам. Опишите её в двух-трёх предложениях: что на входе, что нужно сделать, что должно получиться.

Шаг 2. Опишите результат так, чтобы его можно было проверить

Вместо «сделай отчёт» — «таблица с колонками „дата“, „контрагент“, „сумма“, по строке на документ; документы без суммы — в отдельный список». Чем конкретнее результат, тем проще и агенту, и вам понять, что задача выполнена.

Шаг 3. Подготовьте тестовые данные

Сделайте копию нескольких документов или придумайте учебные примеры, включая пару «неудобных» случаев: пустое поле, необычный формат. Первые запуски — только на тестовых данных.

Шаг 4. Установите Claude Code

Claude Code устанавливается одной командой в терминале; для работы нужна платная подписка Claude или аккаунт Claude Console. Подробно установка и первый запуск разобраны в отдельной статье — как пользоваться Claude Code.

Шаг 5. Напишите инструкции агента

Создайте в папке проекта файл .claude/agents/<имя>.md. Агенты из этой папки доступны в текущем проекте; личные агенты для всех проектов хранятся в ~/.claude/agents/. Обязательны два поля: name — имя агента и description — когда его вызывать. По описанию Claude Code решает, когда передать задачу агенту.

Можно не писать файл вручную: попросите Claude Code создать агента, описав задачу словами, — он сам подготовит файл с нужными полями.

Шаг 6. Ограничьте инструменты и разрешения

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

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

Шаг 7. Запустите на тестовых данных и проверьте

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

Шаг 8. Исправьте инструкции и повторите

Каждую найденную ошибку превращайте в правило в инструкциях: «если сумма не найдена — не придумывай её, внеси документ в список пропусков». Повторяйте запуск, пока результат на тестовых данных не станет стабильным. Только после этого переходите к настоящим документам.

Пример: агент, который собирает таблицу из документов

Так может выглядеть файл агента .claude/agents/doc-table.md:

---
name: doc-table
description: Собирает сводную таблицу из документов в папке и отчёт о пропусках. Вызывать, когда нужно обработать папку с документами.
tools: Read, Glob, Grep, Write
---

Ты обрабатываешь документы из папки, которую укажет пользователь.

Для каждого документа найди: дату, название контрагента, сумму.
Запиши результат в файл result.csv: одна строка — один документ.

Правила:
- Не придумывай данные. Если поле не найдено, оставь ячейку пустой.
- Документы с пустыми полями перечисли в файле missing.md с причиной.
- В конце напиши, сколько документов обработано и сколько с пропусками.

Запуск — обычной просьбой в сессии Claude Code: «обработай папку test-docs агентом doc-table». Агента также можно вызвать явно, упомянув его через @.

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

Как превратить агента в автоматизацию

Когда агент стабильно работает по команде, его можно сделать частью повторяющегося процесса:

• Навык (skill). Повторяющуюся процедуру удобно оформить как навык — файл SKILL.md с инструкциями. Claude Code применяет навык, когда задача ему соответствует, а вызвать его можно и вручную командой с его именем.
• Запуск из командной строки. Claude Code можно запускать из скриптов и цепочек команд, например передавать ему данные и задачу одной командой.
• Запуск по расписанию или событию. Задачи можно запускать по расписанию: облачные «рутины» работают, даже когда компьютер выключен, и умеют запускаться по событиям; есть и локальные запланированные задачи.
• Хуки. Хуки выполняют команды до или после действий Claude Code — например, проверку результата после каждого изменения файла.

Автоматический запуск не отменяет проверку. Чем реже вы смотрите на результат вручную, тем важнее, чтобы проверки были встроены в сам сценарий.

Безопасность: что проверить до запуска

• Агент работает только с той папкой, которая нужна для задачи.
• Список инструментов агента минимален.
• Первые запуски прошли на тестовых данных, а не на рабочих документах.
• Действия, которые нельзя отменить (удаление, отправка, оплата), агент не выполняет без подтверждения человека.
• В инструкциях есть правило не придумывать данные и сообщать о пропусках.
• Внешние сервисы подключены только проверенные: документация предупреждает, что серверы MCP, которые получают внешний контент, могут подвергнуть вас риску атак через внедрение инструкций.
• Вы понимаете, что содержимое файлов обрабатывает модель, и правила вашей компании это допускают.

В Anthropic подчёркивают, что агентов нужно тщательно тестировать в изолированной среде и ставить ограничения, потому что ошибки агента могут накапливаться.

Частые ошибки

• Слишком большая первая задача. «Автоматизировать всю бухгалтерию» — не задача для первого агента. Одна папка, один тип документов, один формат результата.
• Расплывчатый результат. Если вы не можете проверить результат за пару минут, агент тоже не поймёт, когда задача выполнена.
• Нет правила на случай неизвестности. Без явного запрета агент может заполнить пустое поле правдоподобным, но выдуманным значением.
• Проверка только итога. Ошибки часто видны в ходе работы: агент открыл не тот файл или пропустил часть документов.
• Сразу рабочие данные. Ошибку на копии исправить просто, на рабочих документах — дорого.

Частые вопросы

Можно ли создать ИИ-агента бесплатно?

В Claude Code — нет: для работы нужна подписка Claude Pro, Max, Team или Enterprise либо аккаунт Claude Console; бесплатный тариф claude.ai доступ к Claude Code не включает.

Нужно ли уметь программировать?

Нет. Агент в Claude Code описывается текстом: задача, правила, формат результата. Понадобится работать с терминалом по инструкции и внимательно проверять результат.

Будет ли агент работать без моего участия?

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

Можно ли подключить агента к другим сервисам?

Да, Claude Code подключается к внешним инструментам и данным через протокол MCP. Подключайте только те сервисы, которым доверяете, и только с теми правами, которые нужны для задачи.