1 / 8
или Space для навигации
Гайд для команды

Как создавать AI-агентов
в Claude Code

Полный обзор: концепция, процесс создания, типы агентов и ошибки, которых стоит избегать.

Агенда
  1. 01.Концепция — что такое агент и как он работает
  2. 02.Процесс создания нового агента
  3. 03.Два типа агентов
  4. 04.Типичные ошибки
Часть 1

Что такое агент

Агент — это отдельный экземпляр Claude, которому дана конкретная роль, набор инструментов и системный промпт. Это тот же Claude, но запущенный с определёнными ограничениями и инструкциями.
Обычный чат Агент
Отвечает на любые вопросы Ограничен конкретной зоной ответственности
Без роли и контекста Имеет чёткую роль и знает свои задачи
Не работает с файлами автоматически Самостоятельно читает данные, пишет файлы, запускает скрипты
Интерактивный Запускается автоматически, работает до конца задачи
Помнит сессию только в чате Помнит контекст проекта между запросами (через memory)
Часть 1 · Термины

Ключевые термины

01
Системный промпт
Должностная инструкция агента: кто он, что умеет, где искать данные. Пользователь не видит.
02
Инструменты Tools
Что агент умеет: читать/писать файлы, терминал, веб, Drive. Разрешаются явно.
03
Бриф
Задание агенту. Первое сообщение, должно содержать весь контекст.
04
Ход Turn
Один цикл: подумал → вызвал инструмент → получил результат. maxTurns: 30 = лимит циклов.
05
Скилл Skill
Отдельный файл со сценарием. Подгружается через Read только когда нужен.
06
Self-critique
Агент сам оценивает свой результат, ставит балл, при необходимости переделывает.
07
jobs.jsonl
Лог задач: что делали, для кого, результат. Для отслеживания истории и качества.
08
Таймаут
Лимит времени работы агента в секундах. По истечении процесс останавливается.
09
Memory
Память агента. memory: project = помнит контекст проекта между сообщениями сессии.
Часть 2

Процесс создания агента

Главный flow

1 Идея
2 Claude составляет план
3 Вы утверждаете план
4 Пошаговая реализация
Готовый агент

Шаг 1. Шаблон промпта

Мне нужен агент [название].
Он должен [что делает], чтобы [зачем / какая цель].
На входе получает [что подаётся].
На выходе возвращает [что должно получиться].

Агент должен включать в себя:
- prompt.md         ← роль агента и инструкции
- output/jobs.jsonl ← лог выполненных задач
- скиллы            ← если есть типовые сценарии

Составь план из чего будет состоять агент,
какие инструменты нужны, какую модель
использовать — и жди моего утверждения
перед реализацией.
Часть 2 · Шаги 2–4

План, утверждение, реализация

Шаг 2. План от Claude

agents/analyst/
├── prompt.md
├── skills/
│   ├── vk-scan.md
│   ├── tg-scan.md
│   └── offer-analysis.md
└── output/jobs.jsonl

Инструменты: WebSearch, WebFetch, Read/Glob.

projects/context.txt — общая база, держите актуальной.

Шаг 3. Чек-лист утверждения

  • Правильно ли определена роль?
  • Нет ли лишних инструментов?
  • Правильная ли модель?
  • Понятен ли выход агента?

Шаг 4. Пошаговая реализация

  1. Создаю структуру папок
  2. Пишу файл агента
  3. Создаю скиллы
  4. Тестирую агента
  5. Регистрирую агента
Каждый шаг — с вашим подтверждением.
Часть 3

Два типа агентов

Тип 1. Координатор (Teamlead)

Главный агент. Декомпозирует задачу, вызывает исполнителей, проверяет результат.

Каждый ход = одно действие + показать + спросить.
Пользователь: «Пост с баннером для ВК»
       ↓
Teamlead: план (Copywriter → Creator)
       ↓ «Запускаю шаг 1?»
Copywriter → текст → «Идём к баннеру?»
       ↓
Creator → баннер → «Правки нужны?»

Тип 2. Исполнитель (Субагент)

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

Агент Делает Не делает
SMM контент-планы, посты, аналитика лендинги, видео
Copywriter статьи, сценарии, ВК, email баннеры, контент-планы
Creator баннеры, видео, визуалы тексты, аналитику
Один агент = одна зона ответственности
Часть 4

Типичные ошибки

Ошибка 01
Агент делает слишком много
× Пишет, генерит, публикует, анализирует — всё в одном.
Один агент = одна зона. Несколько агентов под координатором.
Ошибка 02
Устаревший context.txt
× Контент по старым данным: несуществующие программы, изменившаяся ЦА.
Обновляйте при любых значимых изменениях.
Ошибка 03
Агент решает за пользователя
× Сам выбирает, публикует, удаляет без подтверждения.
Агент предлагает варианты → пользователь выбирает → агент делает.
Ошибка 04
Слабый бриф субагенту
× «Напиши пост про набор» — без контекста.
Бриф = проект + ЦА + tone of voice + задача + ограничения.
Ошибка 05
Неправильный таймаут
× 480 сек на текст или 60 сек на баннер.
Таймаут под тип задачи.
Ошибка 06
Нет логирования в jobs.jsonl
× Агент работает, но не записывает.
Каждая задача → запись в jobs.jsonl.
Финал

Что запомнить

01
Один агент = одна зона ответственности
02
Держите context.txt в projects/ актуальным
03
Пользователь утверждает — агент делает
04
Логируйте всё в jobs.jsonl
Готовы создать своего агента?