Как читать этот сайт

Этот сайт — практический учебник о том, как IT-команда использует ИИ-агентов в повседневной работе. Здесь нет академической теории машинного обучения и нет обещаний, что «ИИ всё сделает за вас». Есть объяснение того, как агенты устроены, что они умеют, где ошибаются и как встроить их в рабочий процесс.

Для кого этот сайт

Учебник рассчитан на четыре роли:

• Программисты: от джуниора до тимлида. Агенты для написания кода, рефакторинга, работы с легаси.
• Аналитики: системные и бизнес-аналитики. Агенты для исследования требований, работы с документами, изучения кодовой базы без глубоких знаний программирования.
• Менеджеры: руководители команд и продуктов. Что реально ждать от агентов, как оценивать эффект, какие риски учитывать.
• Тестировщики: ручные и автоматизаторы. Агенты для генерации тестов, анализа багов, проверки покрытия.

Знаний машинного обучения не требуется. Всё, что нужно понимать про модели, объясняется по ходу, на уровне «как это влияет на мою работу», а не «как это устроено математически». Если вы умеете работать с текстовым редактором и терминалом хотя бы на базовом уровне, этого достаточно; для менеджеров и терминал не обязателен.

Полный маршрут: с нуля до практики

Если вы никуда не спешите, читайте разделы по порядку, они выстроены от фундамента к практике:

1. Основы: модели. Что такое большая языковая модель (LLM, large language model), какие бывают, что такое токены и контекстное окно. Начните с Что такое LLM.
2. Основы: агенты. Чем агент отличается от чата, что такое харнес (agent harness), инструменты, память. Начните с Что такое агент.
3. Практика. Как ставить задачи, управлять контекстом, проверять результаты и не наступать на типичные грабли. Начните с Промптинг.
4. Ваш трек по роли. Трек: программист, Трек: аналитик, Трек: менеджер или Трек: тестировщик.
5. Харнесы. Обзоры конкретных инструментов (Обзор харнесов) читайте по мере надобности: когда выбираете, что поставить, или хотите глубже разобраться в том, чем уже пользуетесь.

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

Короткие маршруты: если спешите

Каждый маршрут занимает 4–5 страниц, около часа чтения. Остальное можно добирать позже по ссылкам.

Программисту

1. Что такое агент: что такое агент и как он работает
2. Харнес: что такое харнес и почему он важнее модели
3. Рабочий цикл с агентом: рабочий цикл с агентом
4. Проверка результатов агента: как проверять результаты
5. Трек: программист: ваш трек

Аналитику

1. Зачем ИИ-агенты IT-команде: зачем это всё
2. Что такое агент: что такое агент
3. Токены и контекстное окно: главное ограничение при работе с документами
4. Промптинг: как формулировать задачи
5. Трек: аналитик: ваш трек

Менеджеру

1. Зачем ИИ-агенты IT-команде: что меняется и каковы честные ожидания
2. Что такое агент: что такое агент без технических деталей
3. Промптинг: как ставить задачи агенту
4. Проверка результатов агента: почему результаты нужно проверять
5. Трек: менеджер: ваш трек

Тестировщику

1. Что такое агент: что такое агент
2. Инструменты и их вызов: как агент запускает тесты и читает код
3. Проверка результатов агента: проверка результатов (для QA это профильная тема)
4. Типичные ошибки: типичные ошибки
5. Трек: тестировщик: ваш трек

Совет

Не знаете, с чего начать? Начните с Зачем ИИ-агенты IT-команде. Это следующая страница, и она отвечает на главный вопрос: зачем вообще тратить на это время.

Как устроены термины

В этой области почти вся терминология англоязычная, и в командах её часто используют без перевода. Поэтому правило такое: при первом упоминании на странице термин даётся по-русски с английским оригиналом в скобках, например «контекстное окно (context window)» или «харнес (agent harness)». Дальше по тексту используется только русский вариант. Так вы будете узнавать термины и в русских, и в английских материалах.

Все ключевые термины собраны в глоссарии: Глоссарий. Если встретили незнакомое слово, а страница его не объясняет, загляните туда.

Ещё два практических момента:

• Поиск по сайту — строка поиска вверху страницы. Работает по всем разделам; часто быстрее найти термин через неё, чем листать оглавление.
• Ссылки в тексте: страницы не пересказывают друг друга, а ссылаются. Если по ходу чтения что-то непонятно, скорее всего рядом есть ссылка на страницу, где это разобрано.

Заметка

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

Что дальше

• Зачем ИИ-агенты IT-команде: что реально меняется и каковы честные ожидания.