Чат с ИИ-агентом

Чат с ИИ-агентом — это возможность спросить прямо в интерфейсе: «почему за вчера столько ошибок», «помоги настроить канал связи», «что показывает этот график». Отвечает не модель напрямую, а внешний Pastukhov Agent, подключённый к продукту. Разговор идёт там же, где данные, — не нужно переключаться на другое окно и копировать цифры.

Как подключить

Достаточно задать две переменные окружения на сервере:

  • AGENT_API_URL — адрес вашего Pastukhov Agent.
  • AGENT_API_KEY — его ключ доступа.

Обе переменные читаются один раз при запуске. Значит, после их изменения контейнер нужно перезапустить — просто сохранить в интерфейсе нельзя. Пока обе не заданы, чат считается не подключённым.

Что остаётся на сервере

Ключ агента никогда не попадает в браузер. Он хранится на сервере и подставляется только в обращения к агенту — из окна браузера его не видно ни в ответах, ни в живых обновлениях. Это важно, если в интерфейс заходят несколько человек: ключ агента остаётся вашим.

Как это выглядит

  • Панель чата — на широком экране это отдельная панель рядом с содержимым, на узком — выдвижная снизу. Одна и та же, просто в двух видах.
  • Список чатов и очередь сообщений — в боковой панели видно, какие чаты сейчас работают, а какие сообщения ждут своей очереди.
  • Живые обновления — ответ появляется по мере готовности, как в обычном чате; состояние «работает», счётчики и очередь обновляются сами.

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

Что умеет панель чата

  • Метки чатов — разговору можно присвоить метку и разложить их по темам или заказчикам. В списке чатов есть отбор: «С метками», «Без меток» и по любой выбранной метке («Фильтр по метке»); чат без метки отмечен как «Без метки».
  • Список задач — над перепиской закрепляется список задач, который агент ведёт по ходу работы. Видно, что уже сделано, что делается и что осталось, — не нужно переспрашивать.
  • Отправка сразу — ваше сообщение появляется в переписке мгновенно, не дожидаясь ответа сервера. Если что-то пойдёт не так, оно вернётся в поле ввода.
  • Возврат к последнему сообщению — в длинной переписке, если вы пролистали вверх, появляется кнопка «Прокрутить вниз».

Звуки и голосовой ввод

Новое сообщение можно услышать: звук уведомления срабатывает и для чатов, которые сейчас не открыты. Если он мешает, рядом есть кнопка «Отключить звук», а вернуть — «Включить звук».

Сообщение можно надиктовать голосом — кнопка «Начать запись голоса» в панели ввода. Как именно распознаётся речь, зависит от настроек:

  • Средствами браузера — речь распознаётся самим браузером, запись не уходит на ваш сервер. Но поддерживают это не все браузеры, и браузеру может понадобиться подключение к интернету.
  • С помощью подключённого агента — если выбран другой движок, записанный звук уходит на расшифровку в Pastukhov Agent. Без подключённого агента такой ввод не заработает.

Честно: если браузер не умеет распознавать речь, а агент не подключён, кнопка не поможет. И ещё браузеру нужно разрешение на доступ к микрофону — без него продукт подскажет проверить настройки устройства.

Сколько стоит ответ

Стоимость каждого ответа видна в переписке. Дешёвые ответы показываются с точностью до сотых долей цента — в виде $0.00xx, а совсем маленькие — как «меньше цента». Так видно, что дешёвая модель действительно дешёвая, а не «бесплатная» из-за округления.

Без подключения

Если агент не подключён, продукт работает полностью: модели, ключи, журналы, аналитика, скрытие секретов, прокси-служба — всё на месте. Просто панель чата не показывается. Ничего не ломается и не «ждёт настройки».

При этом нижний блок боковой панели — сводка активных чатов и кнопки «Промпты» и «Чаты» — показывается всегда: откройте его, и вы увидите, чего не хватает. Над кнопками появляется полоса-предупреждение с названиями нужных переменных (AGENT_API_URL и AGENT_API_KEY); как только связь заработает, полоса исчезает.

Честная оговорка

Чат — это отдельный продукт. Чтобы он заработал, Pastukhov Agent нужно поставить и настроить сам по себе; «Прокси-агент» лишь подключается к нему. Если агента у вас пока нет, эта возможность вам не нужна — остальное работает и без неё.

Дальше: как разместить продукт на сервере и где лежат данные — в разделе Размещение и данные.

← Оглавление документации