Документация · ✨ Спросите Pommy

Ассистент в поле поиска

Найдите страницу, поищите в документации или задайте вопрос — всё в одном поле.

Кнопка Search вверху панели — ⌘K на Mac, Ctrl K на остальных системах — открывает одно поле, которое умеет три вещи: переходить на страницу панели, искать по этой документации и отвечать на вопросы. Отдельного экрана чата нет. Одно и то же поле превращается в разговор и обратно.

Поле поиска открыто поверх панели: подходящие страницы, подходящие страницы документации и строка Ask Pommy внизу
Режим поиска: сначала страницы, затем документация, а внизу — «Ask Pommy» с тем, что вы ввели.

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

  • Pages (страницы) — до шести страниц панели, у каждой указана группа меню. Здесь появляются только страницы, которые вы действительно можете открыть. Поиск учитывает и внутреннее английское название страницы, поэтому widget найдёт её, на каком бы языке ни была ваша панель — английском или турецком.
  • Documentation (документация) — до четырёх страниц этого руководства с кратким описанием и разделом.
  • Ask Pommy — всегда последняя строка, в ней ровно то, что вы ввели. Она есть, даже если больше ничего не нашлось.

Стрелками можно перемещаться по строкам, Enter открывает выбранную, Esc закрывает поле. Если ничего не найдено, вы увидите одну строку — *No page or document matches that — You can still ask Pommy* («подходящих страниц и документов нет, но можно спросить Pommy»).

В пустом поле показываются Quick jump (быстрый переход) — шесть часто используемых страниц — и Try asking (попробуйте спросить) — три примера вопросов: *How do I add the widget to my site?*, *How do I train my AI agent?*, *How do I connect WhatsApp?* Нажатие на пример сразу задаёт этот вопрос.

Как задать вопрос#

Начать разговор можно тремя способами: выбрать строку Ask Pommy, нажать на один из примеров в Try asking или нажать на одну из подсказок маскота на главной странице панели — они открывают это же поле с уже отправленным вопросом; подробнее в разделе Маскот панели.

То же поле в режиме чата: вопрос вверху, короткий ответ под ним и список Sources со ссылками на две страницы документации
Режим чата: короткий ответ, а под ним — страницы документации, на которых он основан.

Заголовок меняется на Ask Pommy, в основной части появляется разговор, а поле ввода опускается вниз. Пока ассистент работает, вы видите *Reading the docs…* («читаю документацию…»); затем приходит ответ, а за ним — Sources (источники).

  • Sources — это страницы документации, из которых взят ответ. Нажмите на любую — поле закроется, и вы попадёте на эту страницу.
  • Задавайте уточняющие вопросы в поле внизу. В рамках одного разговора ассистент помнит последние несколько реплик, так что повторять контекст не нужно. Длина сообщения — до 500 символов.
  • Назад к поиску — стрелка в левом верхнем углу возвращает к списку результатов. Esc полностью закрывает поле.
  • Каждое открытие начинается с чистого листа. Разговор не сохраняется; откройте поле снова — и начнётся новый.

Строка под полем ввода говорит то же, что и эта страница: *Answers come from Pommy's documentation. If it isn't there, it won't invent it.* («Ответы берутся из документации Pommy. Если там этого нет, ассистент не станет выдумывать.»)

Откуда берутся ответы#

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

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

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

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

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

Ваши собственные цифры#

Только один вопрос приходит с живыми данными — подсказка маскота Analyze this page на главной странице панели. Она передаёт ассистенту те же сводные показатели за последние 24 часа, что показывает вам панель:

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

Это цифры, которые уже есть на вашем экране: панель передаёт их текстом, а не пересчитывает заново, поэтому ассистент и страница никогда не назовут вам разные значения. Для этого вопроса поиск по документации не выполняется, поэтому под ответом нет списка Sources. Ассистенту велено использовать цифры точно в том виде, в каком они переданы, и ничего не придумывать.

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

Языки#

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

Если что-то не работает#

Он говорит, что ничего не нашёл в документации.
Ни одна страница не совпала с вашей формулировкой, и вместо того чтобы гадать, он остановился. Используйте термин, который есть в самой панели, — «Knowledge Base», а не «данные для обучения», — или сократите вопрос до двух-трёх ключевых слов.
Он пишет, что нужные страницы ниже, но ответа нет.
Страницы нашлись, но сам ответ сформировать не удалось — обычно из-за того, что это заняло слишком много времени. Источники всё равно показаны, так что страницу можно прочитать напрямую, а повторный вопрос часто срабатывает.
Он говорит, что я спрашиваю слишком быстро.
Для каждого аккаунта есть ограничение на частоту вопросов. Подождите немного и спросите снова.
Ответ короче, чем мне хотелось бы.
Так задумано: он отвечает в нескольких предложениях и отправляет вас на страницу. Откройте источник под ответом, чтобы прочитать полную версию.
Он ничего не знает о моих товарах или клиентах.
Он читает документацию, а не содержимое вашего проекта. Для вопросов о собственных данных используйте страницы панели — или подсказку маскота «Analyze this page» для сводки на главной странице.
Мой предыдущий разговор пропал.
Разговоры не сохраняются. Закрытие поля завершает разговор, а при следующем открытии начинается новый, пустой.