Городской помощник

Городской помощник — справочник по городу и навигатор по его службам. Он отвечает жителям и гостям на вопросы о транспорте и тарифах, режиме работы городских сервисов и учреждений, событиях и афише, парках и музеях, государственных и бытовых услугах и экстренных службах.

Быстрый старт

  1. Подключите базу знаний со справочником города: транспорт и тарифы, режим работы учреждений и сервисов, парки, музеи и события, государственные и бытовые услуги, экстренные телефоны, контакты служб (название, телефон, адрес, часы работы, сайт). Это основной источник ответов агента.

  2. Стартовые вопросы в приветствии — примеры, перепишите их под свой город. Остальную инструкцию можно оставить шаблонной. «Яндекс поиск» и «Sber Salute Speech» уже подключены и работают без авторизации.

  3. Проверьте ответы на типовые вопросы жителей и гостей в режиме тестирования и при необходимости дополните базу знаний.

  4. Опубликуйте агента: поделитесь ссылкой, встройте его на сайт или подключите к Telegram или MAX.

База знаний

База знаний — основной и приоритетный источник: агент проверяет её первой. Если ответа там нет, ищет в интернете через «Яндекс поиск» и помечает сведения как внешние. Сведения, которые со временем меняются (афиша и события, расписания и режим работы, перекрытия и изменения движения, цены билетов и тарифы, погода), агент сверяет с интернетом, даже если значение есть в базе знаний. Если данные расходятся, он назовёт оба значения и посоветует уточнить на официальном сайте или по телефону службы.

Что умеет агент

Задача

Как это работает

Ответы по справочнику

Тарифы, правила проезда, режим работы, порядок получения услуг, телефоны — кратко, с нужными деталями

Контакты служб

Карточка: название, телефон, адрес, часы работы, сайт (только те поля, что есть в источнике). Если службы нет в справочнике, агент ищет её контакты только на официальных сайтах города, ведомств и организаций

Актуальные сведения

Сверка изменчивых данных с интернетом, внешние источники помечены, ссылки приведены

Как добраться

Виды транспорта, пересадки, ориентировочное время в пути, ссылка на маршрут в картах (если нашлась в поиске); если не понятно, откуда ехать, агент спросит

Ближайшее

Аптека, МФЦ, парк, кафе: агент спросит район, станцию метро или остановку, если вы их не назвали

План дня или выходных

Агент уточнит, с кем вы и что вам интересно, учтёт погоду (в дождь — крытые места) и предложит программу

Экстренная ситуация

При происшествии агент первым ответом даст номер экстренной службы и порядок действий

Голосовые сообщения

Голосовое из Telegram или MAX и приложенное аудио агент распознаёт и отвечает на него как на обычный вопрос

Фото и документы

Объявление, билет, схема, табло, квитанция, программа мероприятия: агент разбирает приложенное и отвечает с учётом справочника

Если запрос неясен (какое место, дата или услуга), агент задаст один уточняющий вопрос.

Что вы получите

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

Ответ файлом (памятка, план в PDF) агент оформляет по явной просьбе: pdf, docx, xlsx, pptx или другой формат. В веб-чате файл приходит вложением, в Telegram, MAX и по API — ссылкой.

Ограничения

  • Форматы: документы — csv, doc, docx, pdf, ppt, pptx, txt, xls, xlsx, до 50 МБ; изображения — jpg, jpeg, png, gif, webp, svg, до 10 МБ, аудио — mp3, wav, ogg, opus, flac, m4a, aac, до 150 МБ (голосовые сообщения — наравне с аудио), видео — mp4, mov, mkv, webm, avi, до 200 МБ: агент получает только звуковую дорожку. До 20 файлов за один раз. Архивы не принимаются.

    В Telegram любой файл — не больше 20 МБ, за раз можно отправить не больше 10 файлов. Это ограничения мессенджера.

  • Агент не отправляет письма, не передаёт обращения и не подаёт заявки: он даёт контакты службы, а обращаетесь вы сами.

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

  • Агент не покупает билеты, не записывает к врачу и не оплачивает услуги — только описывает порядок действий и даёт ссылки на официальные сервисы.

  • Контакты с агрегаторов и непроверенных сайтов агент не даёт — только из справочника и с официальных сайтов.

  • Агент не даёт юридических консультаций и политических оценок работы городских служб.

  • Статус вашей заявки агент не видит: он объяснит общий порядок и даст контакты службы, где уточнить.

  • Агент не запрашивает и не хранит паспортные и платёжные данные, номера лицевых счетов.

  • Отвечает только текстом; ответы голосом не поддерживаются.

Если что-то пошло не так

Что увидите

Что это значит

Агент сообщает, что не смог проверить информацию в интернете, и отвечает по справочнику

«Яндекс поиск» недоступен; сведения не сверены

Агент просит повторить сообщение голосом или написать текстом

Голосовое не распознано (тишина, шум, неподдерживаемый формат)

«Можно загрузить не более 20 файлов»

Превышен лимит файлов за один раз