Документация ›Ваш AI-агент

Личность агента

Как агент получает вводные

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

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

Начните с заготовки

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

Замените текст в квадратных скобках своим. Держать все разделы не обязательно — лишние удалите. Если вы уже что-то написали, мы спросим перед заменой.

Последний раздел необязательный и важен в некоторых странах: если закон требует сообщать, что человек говорит с машиной, напишите там эту инструкцию своими словами.

Заполнить с вашего сайта

В разделе «О вашем бизнесе» вставьте адрес сайта и нажмите Прочитать сайт. Мы прочитаем страницу и составим описание за вас. Это только черновик — прочитайте, поправьте неточности и нажмите «Сохранить». До сохранения агент ничего из этого не увидит.

Черновик не лучше самой страницы: если цен или часов на сайте нет, они и не появятся — допишите руками.

Системный промпт

Инструкции, определяющие кто агент и как он должен себя вести. Это невидимо для клиентов, но формирует каждый ответ.

У промпта есть предел длины, и превышение не обрезается, а отклоняется: промпт не сохраняется, прежний остаётся на месте, а в баннере видно, на сколько вы вышли за лимит. Ваш тариф может задавать предел ниже максимального — тот же, что API отдаёт в limits. Молча не срезается ничего: в конце промпта обычно и стоят самые важные правила.

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

Пусть сначала посмотрит. Переключатель в Настройках. В WhatsApp, Telegram и Instagram агент никому не отвечает: сообщения по-прежнему приходят в дашборд, в CRM и в группу операторов — ровно как сейчас, — а отвечает ваша команда. На звонки и в чате на вашем сайте агент отвечает как обычно. Пригодится в первые дни, пока вы наполняете знания агента и сами его проверяете (см. «Тестирование агента»), прежде чем он начнёт отвечать клиентам в чатах. Выключите, когда будете готовы.

Язык ваших клиентов. В Настройках, в блоке «Как отвечает агент». По умолчанию агент работает на языке, на котором написано описание бизнеса. Если ваши клиенты говорят на другом — клиника в Дубае, описанная по-русски, практика в Нью-Йорке, описанная по-китайски, — выберите там их основной язык и до трёх дополнительных, если клиенты переходят с одного на другой. Тогда на звонках агент настраивается слышать эти языки, а служебные фразы платформы (запасной ответ, «к вам подключился оператор») идут на основном; такие фразы есть на русском, английском и испанском, для остальных языков — на английском. Отвечает агент всё равно на том языке, на котором говорит клиент. Уведомления вашей команде — на своём, отдельно настроенном языке.

Включите:

  • Имя и роль агента
  • Название компании
  • Язык ответов
  • Тон (формальный, дружелюбный, профессиональный)
  • Чего НЕ делать (не выдумывать цены, не обещать сроки)

Как написать блок о бизнесе для телефонной линии

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

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

Всё, что человеку придётся произнести вслух, пишите словами. Сокращение, название метода, продукт: поставьте рядом с написанием произносимую форму, и агент скажет её слово в слово, а не соберёт заново — «SPF — произносить: эс-пи-эф». Часы, адреса, телефоны и цены — исключение: они живут в поле «Произносить дословно» ниже, а не здесь. Записанные дважды, они расходятся, а агент однажды прочитал клиенту вслух саму служебную пометку.

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

Длинные прайсы — в Базу знаний, а не в промпт, отдельными небольшими документами по разделам. В промпте оставьте то, что нужно на большинстве звонков.

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

Голос и темп. В Настройках → Голос выберите marin или cedar — самые новые голоса, самое естественное произношение и акцент; старые остаются для тех, кто их выбрал. Темп речи — множитель к естественной скорости: 1.1–1.2, если агент по телефону «растягивает слова», 0.9, если просят говорить медленнее. Пусто = естественный. Произношение терминов задаётся в промпте, а не здесь: один раз напишите, как слово звучит («SPF — произноси эс-пи-эф»), и агент так и скажет.

Агент сам говорит, чего он не знал. Под этим полем есть ссылка: «О чём спрашивают, а агент не знает?». Она читает задачи за последний месяц, родившиеся из звонков, называет факт, которого не хватило в каждой, и показывает те, что повторялись — «×7 цена консультации — Центр». Нажмите «Добавить строку» — место и вопрос попадут в поле, а что говорить, впишете вы. Ответ никогда не придумывается: мы знаем, о чём спросили, а цены знаете только вы, и уверенно произнесённое выдуманное число — единственная ошибка, которой мы не станем рисковать. Незаконченная строка просто игнорируется, пока вы её не допишете.

Рядом с вопросом видно, сколько из этих клиентов ещё ждут перезвона. Допишите строку и сохраните: с этого момента агент отвечает сам, а в каждую из этих открытых задач «перезвонить» ответ добавляется в заметку дословно — тот, кто будет перезванивать, уже знает, что сказать. Никому автоматически не звоним и не пишем. Раз в неделю главные вопросы появляются и на главной странице — «Агент не знал», со ссылкой прямо на этот список.

«Произносить дословно» (Настройки → Агент, под описанием бизнеса). Часы, адреса, телефоны и основные цены — это то, что клиент записывает и по чему потом действует, и у них есть ровно одна верная формулировка. Перечислите их здесь по одной в строке — место | что это | что именно произнести — и агент произнесёт строку как написано, а не соберёт её заново: без пересчёта времени, без превращения слов в свои цифры, без путаницы между двумя филиалами на одной улице. Числа пишите так, как они должны звучать («сто одиннадцать», а не «111»). Цены — так же, по строке на цену, названной так, как её спрашивают («цена консультации», «цена доставки», «цена установки»); если формулировка звонящего ни с чем точно не совпала, агент получает список имеющихся строк и выбирает нужную, а не придумывает сумму. Оставите пустым — ничего не изменится: агент ответит по описанию, как и раньше.

Второй язык. Припишите язык в скобках после названия строки — Центр | часы (en) | … — и звонящий на этом языке услышит вашу формулировку, а не перевод, сделанный на ходу. Один и тот же факт пишется дважды, по строке на язык; чего нет — берётся строка без пометки, так что ничего не ломается, пока вы её заполняете. Короткие служебные реплики агента — просьба повторить, передача человеку при плохой связи — тоже звучат на языке звонящего (русский, английский, испанский, казахский).

Ответы, одинаковые для всех филиалов. Напишите Все | что это | … для короткого ответа, который не зависит от филиала — как оформить заказ, как подготовиться к визиту, что бесплатно, — и агент произнесёт вашу строку, а не будет каждый раз объяснять своими словами. Город для таких ответов не спрашивается; если у филиала есть своя строка про то же самое, звучит она. Держите каждую строку в одно-два коротких предложения: её произносят по телефону.

Несколько филиалов в одном городе. Запишите их адреса в одну строку, по предложению на филиал — Центр | адрес | Центральная, двадцать два. Есть ещё один — Парковая, шесть. Кто ещё не выбрал, услышит оба; кто уже назвал улицу — только этот филиал, а не оба адреса заново.

Часы, разные по дням. Пишите по предложению на группу дней — Центр | часы | с понедельника по пятницу, с восьми до пяти; в субботу с девяти до часу; в воскресенье выходной. Кто спросил про один день — «завтра работаете?», «в субботу?», — услышит часы этого дня, посчитанные по вашему часовому поясу, а не всю неделю.

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

Приветственное сообщение

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

Голос

Голос, используемый для телефонных звонков и голосовых демо.

marin, cedar — рекомендуем: самые естественные по телефону

alloy, ash, ballad, coral, echo, sage, shimmer, verse — другие голоса, можно попробовать

Максимум токенов ответа

Это жёсткий обрыв, а не цель. Если ответ выйдет за лимит, его срежет на полуслове — клиент услышит, как фраза оборвалась. Держите лимит с запасом: длину ответа платформа подбирает сама.

1024: Рекомендуем. Оставляет запас на нормальный ответ.

Короче ответы этим лимитом не сделать — он только обрывает ответ на полуслове.

Блоки только для переписки

Один промпт обслуживает и звонки, и чаты, но правила про фото или «можно ответить в несколько строк» имеют смысл только в чате. Оберните такие части в [[ТОЛЬКО-ТЕКСТ]] … [[/ТОЛЬКО-ТЕКСТ]] (или [[TEXT-ONLY]] … [[/TEXT-ONLY]]): телефонные звонки их пропускают, WhatsApp, Telegram, Instagram и виджет — оставляют. У каждого открывающего маркера должен быть закрывающий — при непарных маркерах промпт остаётся как есть.

Есть и зеркальный маркер: части, которые имеют смысл только на звонке — «скажи, что не расслышал», произносимые формы чисел, «прочитайте с упаковки вслух» — оберните в [[ТОЛЬКО-ГОЛОС]] … [[/ТОЛЬКО-ГОЛОС]] (или [[VOICE-ONLY]] … [[/VOICE-ONLY]]). Звонки их оставляют, чаты пропускают. Карточка «Произносить дословно» и так доходит до чатов сама, цифрами, поэтому часы и адреса дублировать не нужно.