Из чего состоит
ваш агент
Агент — не чёрный ящик. Внутри четыре понятные детали: инструкции, база знаний, инструменты и память. Разберём каждую, проследим, как они складываются в один ответ, — и главное: что из этого можно дорабатывать без программистов. Финал модуля и мост к следующему.
🎯 После урока вы сможете: «разобрать» любого агента на четыре детали, по симптому определить, какая деталь требует внимания, — и знать, что дорабатываете вы сами, а что просите у разработчика.
Форматы дополняют друг друга: видео даёт живое объяснение, конспект — структуру для повторения.
Здесь будет видео урока. Плеер подключим, когда выберем хостинг: Kinescope, VK Видео или YouTube.
В уроке 13 мы дали формулу из пяти частей. Модель — «мозг» — вы не трогаете, её делают лаборатории. А вот остальные четыре детали — инструкции, база, инструменты, память — это и есть «ваш» агент. Понимая их, вы перестаёте быть пассажиром и становитесь тем, кто умеет этим управлять.
Деталь 1. Инструкции: характер и правила
Инструкции — это текст, написанный обычными словами, который агент «читает» перед каждым ответом. Как памятка новому сотруднику в первый день. Внутри обычно четыре слоя:
Кто он: «Ты — ассистент компании [X]. Компания занимается [Y], твоя зона — брони, вопросы гостей, сводки для команды».
Как отвечает: «Кратко, тепло, на "вы". Без канцелярита и смайликов в клиентских чатах».
Что должен: «На вопрос о цене — только из прайса в базе. Не нашёл — говори "уточню у коллег", не выдумывай».
Что запрещено: «Не обещай скидок и сроков. Не отправляй клиентам ничего без проверки человеком. На вопрос "ты бот?" отвечай честно».
Узнаёте? Это ваши уроки 5–6 (роль, формат) и 15 (прозрачность), записанные один раз и навсегда. А помните «регламент двойного применения» из урока 12? Его агентская половина живёт ровно здесь: правила компании, переведённые в инструкции агента.
Деталь 2. База знаний: что агент знает о вас
Модель знает мир, но не знает вашу компанию — мы выяснили это ещё в уроке 2 («эрудированный стажёр, первый день у вас»). База знаний закрывает этот пробел: прайсы · описания услуг · регламенты · ответы на частые вопросы · «таблица смыслов» — документ, где собрано всё главное о компании: чем занимаетесь, для кого, что обещаете, каким тоном говорите.
Два закона базы знаний, которые объясняют 80% проблем с агентами:
Не положили график праздничных дней — агент уверенно запишет клиента на 1 января. Это не глупость агента, это дыра в базе.
Подняли цены, а прайс в базе старый — агент будет называть старые. Каждое изменение в компании должно доезжать до базы — иначе агент живёт в прошлом.
Отсюда практическое правило команды: у каждого документа в базе есть хозяин — тот, кто вспоминает про агента, когда документ меняется. Прайс поменялся → новый прайс в базу. Это буквально одно сообщение — как положить файл в общую папку.
Деталь 2½. Как база растёт — и почему это стратегия
Два инсайта из практики внедрений, которые превращают базу знаний из «папки с файлами» в актив. Первый — база растёт из работы самого агента: удачные диалоги становятся правилами («вот так отвечаем на вопрос о доставке»), неудачные — запретами («так не отвечаем»). Через пару месяцев такой прополки агент отвечает не «как модель», а «как ваша компания» — этим займёмся в уроке 18.
Второй — стратегический, его стоит пересказать руководителю. Модели ИИ обновляются каждые несколько месяцев, и каждая новая — умнее. Компания с собранным датасетом при выходе новой модели получает скачок бесплатно: та же база, тот же агент — а результат резче, потому что «мозг» стал сильнее. Компания без датасета каждый раз стартует с нуля. Кормить базу сейчас — значит инвестировать в каждый будущий скачок моделей.
Деталь 3. Инструменты: руки агента
Инструменты — это подключённые к агенту системы: почта, календарь, таблицы, трекер задач, база броней. Каждый инструмент — отдельно выданный доступ, как ключ от конкретного кабинета. Именно инструменты отличают агента от чата: без них он может только говорить, с ними — делать.
Здесь же живёт безопасность из урока 11: минимум доступов под задачу. Агенту для сводок нужно чтение чатов — но не нужен доступ к платежам. Если задача требует нового инструмента («пусть агент сам публикует посты») — это решение владельца и работа разработчика, не самодеятельность. И у каждого опасного инструмента — подтверждение человеком: агент готовит, вы нажимаете.
Деталь 4. Память: что агент помнит
У памяти агента три слоя, и их важно различать:
Контекст чата — история текущего разговора: «а перенеси её на час позже» работает, потому что агент помнит, о ком речь. Живёт в рамках чата; из урока 14 вы знаете — в каждом чате свой.
Рабочие записи — журнал задач и фактов: какие поручения выполнены, что решили на планёрке. Это память «по делу», к ней агент возвращается.
Долгие заметки — то, что агенту велели запомнить насовсем: «клиент Иванов всегда просит стол у окна», «отчёты присылать по понедельникам к 9:00». Такие заметки — простейший способ доработки: сказали один раз — работает всегда.
Чего агент НЕ помнит: разговоров в чатах, где его нет, и того, что ему не сказали. «Я же говорил об этом Пете в личке» — агент этого не видел (урок 14) и знать не может.
Как четыре детали складываются в один ответ
Проследим запрос «поставь бронь Ивановым на пятницу 19:00, стол у окна» через весь механизм:
1. Инструкции говорят агенту, кто он и что брони — его зона, а подтверждение клиенту без человека не отправлять.
2. Память подсказывает: Ивановы — постоянные гости, в заметках есть «всегда у окна» (и вы могли даже не писать про окно).
3. База знаний знает схему зала и правила брони (максимум на месяц вперёд, депозит от 8 человек).
4. Инструменты позволяют открыть таблицу броней, проверить пятницу и записать.
Ответ: «Готово: Ивановы, пятница 19:00, стол №4 у окна. Депозит не нужен — их четверо. Черновик подтверждения для клиента подготовил, отправите?» — в одной реплике сработали все четыре детали. Теперь вы видите агента насквозь.
Диагностика по симптому: что чинить
Главная практическая ценность этой схемы — по симптому понимать, какая деталь просит внимания:
Кто что дорабатывает: карта ответственности
Финальная таблица модуля — она же анонс следующего:
Вы (любой сотрудник): пополняете базу свежими документами · добавляете долгие заметки («запомни: …») · даёте агенту обратную связь и сообщаете о симптомах.
Владелец агента в компании (обычно 1–2 человека): правит инструкции · следит за базой · решает, что эскалировать.
Разработчик (мы): инструменты и доступы · «мозг» и его обновления · всё, что глубже текста.
Заметьте пропорцию: большая часть доработок — это текст, а не код. Положить документ, добавить заметку, уточнить правило — доступно каждому, кто прошёл этот курс. Как именно это делать день за днём — весь следующий модуль.
«Агент — это конструктор из четырёх деталей, и три из них дорабатываются словами, а не кодом. Кто понимает устройство — тот и управляет».
Главная мысль урока — и всего модуляМодуль «Агент в Телеграме» пройден: что такое агент → как живёт в Телеграме → прозрачность → устройство. В копилке 16 артефактов. Впереди финальный модуль: ставим агенту задачи, дорабатываем его и принимаем работу — то, ради чего всё затевалось.
Разберите агента на четыре детали
Составьте «карту агента» для своей компании — реального, если он уже работает, или будущего, каким вы его видите.
- Инструкции: три главных правила (кто он, тон, что запрещено).
- База знаний: пять документов, которые агент обязан знать, — и хозяин каждого (кто обновляет).
- Инструменты: к чему у агента есть доступ — и одно «опасное» действие, требующее подтверждения.
- Память: две долгие заметки, которые вы бы дали агенту прямо сейчас («запомни: …»).
- Впишите карту в поле и нажмите «Проверить».
Карта агента салона красоты. Инструкции: 1) «Ты — ассистент салона N: запись, вопросы об услугах, напоминания мастерам» 2) «Тон тёплый, на "вы", коротко» 3) «Не обещать результат процедур и скидки; на "ты бот?" — честно да». База: прайс (хозяин — администратор Лена) · график мастеров (Лена) · описания процедур с противопоказаниями (управляющая) · правила отмены записи (управляющая) · таблица смыслов салона (управляющая). Инструменты: чтение/запись в журнал записи, чтение графика; опасное действие — сообщение клиенту о переносе записи: агент готовит, отправляет Лена. Заметки: 1) «запомни: клиентка Морозова — только к мастеру Ане» 2) «напоминание о записи клиентам — за день в 12:00, не вечером».
Проверьте у себя графу «хозяин» в базе: если у документа нет хозяина — через месяц он устареет, и агент начнёт ошибаться. Это самая частая причина «поломки» агентов — и её чинит один столбец в вашей карте.
Карта агента — шаблон
КАРТА НАШЕГО АГЕНТА — 4 ДЕТАЛИ 1. ИНСТРУКЦИИ (характер и правила — текст, читает перед каждым ответом) Кто он: _______________________________________________ Тон: __________________________________________________ Запрещено: ____________________________________________ (сюда же — агентская половина регламента из урока 12) 2. БАЗА ЗНАНИЙ (что знает о нас; агент знает то, что положили) Документ Хозяин (кто обновляет) прайс ______________ ____________________ ______________ ____________________ ______________ Закон: база стареет молча — изменение в компании должно доезжать до базы 3. ИНСТРУМЕНТЫ (руки: каждый — отдельный ключ) Доступы: ______________________________________________ Опасные действия через подтверждение: _________________ Новые доступы — решение владельца + разработчик 4. ПАМЯТЬ (три слоя) Контекст чата (свой в каждом чате) · рабочие записи · долгие заметки: «запомни: _____________________________» ДИАГНОСТИКА ПО СИМПТОМУ: не тот тон / обещания → инструкции старые или выдуманные факты → база «не могу это сделать» → инструменты забыл / путает → память КТО ЧТО ПРАВИТ: сотрудник — база и заметки · владелец агента — инструкции · разработчик — инструменты и глубже. Большая часть доработок — текст, а не код.✓ Скопировано