Веб-платформа для не-технарей
Бот в мессенджере хорошо отвечает на быстрые вопросы, но длинные задачи в треде делать неудобно, а продактам, проджектам, аналитикам и врачам терминал не нужен вовсе. Поэтому мы сделали веб-платформу - по сути тот же харнес, что у бота, только в браузере, плюс база знаний компании и права доступа к её разделам. Без базы знаний и прав это был бы просто ещё один чат с моделью, которых и так полно.
Как устроено
Каждый разговор - это отдельный процесс Claude Code (через Agent SDK) в своём контейнере. Интерфейс сам агента не запускает, а просит сессию у ядра и показывает поток событий, так что движок при желании можно поменять, не трогая интерфейс.
Пара практических советов:
- Транскрипты не переживают перезапуск контейнера, так что их надо сохранять отдельно
- Перед тем как задавать лимиты ресурсов на сессию, замерьте реальное потребление
- Если свободных мест нет, человек должен увидеть понятное сообщение, а не бесконечное «запускаю»
Права на разделы базы
При старте разговора мы монтируем в контейнер только те разделы вики, которые доступны этому человеку, и только на чтение. Других разделов в контейнере просто нет, поэтому никакой промпт до них не доберётся. В начале разговора агент пишет, какие разделы ему видны, чтобы человек понимал, на что можно рассчитывать.
Если будете добавлять поисковый индекс, фильтровать по правам нужно на сервере до поиска, а не в интерфейсе.
Разрешения
Сначала агент спрашивал разрешение на любое действие, вплоть до ls в своей же папке. Человек без технического бэкграунда не понимает, что ему предлагают, поэтому либо жмёт «разрешить» не читая, либо бросает работу. Так что сейчас по умолчанию включён авто-режим, а ограничения задаёт сам контейнер: файлы только на чтение, ключей внутри нет, наружу можно ходить только на разрешённые адреса. Режим «спрашивать» человек может включить сам для конкретного разговора.
MCP подключает администратор сразу для группы людей. Инструменты на чтение одобряются автоматически, а всё, что что-то меняет, требует подтверждения.
Публикация в базу знаний
Новые документы попадают в базу только через публикацию. Перед публикацией агент показывает таблицу: какой документ, в какую папку и кто его увидит. Подозрительное (персональные данные, зарплаты, кадровые вопросы) показывается первым. Документ нельзя положить в папку, которую видит больше людей, чем исходный источник, - и проверяет это код, а не агент.
Ссылки на источники
Когда агент отвечает по базе знаний, он ставит ссылку на документ. Код проверяет, что агент этот документ действительно читал, и неподтверждённые ссылки убирает. А если агент ничего не нашёл, он сообщает об этом явно - так такие случаи проще посчитать.
Изоляция сессий
Каждую сессию надо изолировать: свой конфиг и рабочая папка, без авто-памяти, без ключей в окружении (настоящий токен подставляет шлюз), исходящий трафик только по белому списку. В Agent SDK здесь хватает неочевидного - например, отключение пользовательских настроек заодно отключает и все CLAUDE.md, а пустой системный промпт оставляет агента без понимания, где он вообще работает. Так что изоляцию стоит проверять руками, а не верить, что всё выключилось.
Что не стали делать
- Форкать готовые чат-интерфейсы вроде Open WebUI и LibreChat. Они сделаны под поток текста от модели, а у агента поток событий
- Поддерживать много моделей и перепродавать доступ к ним
- Векторный поиск - на пилоте агенту хватило
grep - Согласование публикаций
- Показывать людям рассуждения агента и ленту шагов с путями к файлам. Для не-технаря это выглядит как инструмент для инженеров
Метрики
Пилот у нас пока небольшой, так что это скорее методика, чем результат:
- Активация - доля мест, где за неделю была хотя бы одна сессия
- Пополнение базы людьми (без того, что коннекторы приносят автоматически)
- Доля ответов по базе знаний со ссылкой на источник. Считать её надо от ответов, которые реально опирались на базу, а не от всех подряд - иначе получается в разы меньше, и метрика ничего не говорит
- Время до первой пользы
И противометрики: документы, к которым никто не обращается, упор в лимиты, нарушения границ доступа (должно быть ноль) и доля честных «не нашёл». Если последняя падает до нуля, то, скорее всего, агент начал выдумывать.
Что помогло при раскатке
- Номер разговора на экране и кнопки «хороший ответ / плохой ответ / написать администратору» - так проще разбирать проблемы
- Остаток лимитов на экране
- Еженедельная сводка руководителю: где база не ответила и каких документов не хватает. Сигналы для неё стоит откалибровать в первую же неделю, иначе сводка утонет в шуме
- Права раздаются группам из личных учёток. Общие учётки «на отдел» ломают всю модель прав
Следующая: Оценка скиллов и агентов
Предыдущая: Начало работы с Claude Code