Обучите Juno своему продукту

Shayan TaslimОбновлено

Juno отвечает только на основе предоставленных вами сведений о продукте, поэтому никогда не выдумывает цены, ограничения, инструкции по настройке или ссылки. Добавьте Описание продукта непосредственно в разделе Настройки → Диалоги → Juno AI, а синхронизируемые материалы Справочного центра, сайты и загруженные файлы добавляйте и настраивайте в разделе Настройки → Диалоги → Juno AI → Управление знаниями.

Описание продукта

Кратко опишите, что делает ваш продукт и для кого он предназначен (до 4 000 символов, используя обычные абзацы, полужирный текст и маркированные списки) в карточке Продукт в разделе Настройки → Диалоги → Juno AI.

  • Автоматический первоначальный черновик: Когда вы впервые включаете раздел «Диалоги», UserJot один раз автоматически проверяет сайт регистрации вашего рабочего пространства (если вы ещё не написали описание) и составляет черновик Описания продукта. Система проверяет указанный домен и его поддомены (проверяя /llms.txt и /sitemap.xml, а также до 12 отрисованных веб-страниц, например главную страницу, страницы с ценами, документацией, информацией о продукте, безопасности и поддержке).

  • Ручные изменения сохраняются: Вы можете в любой момент изменить описание, нажав Изменить (или Написать самостоятельно; сохранение пустого описания удалит его). Во время выполнения проверки изменить описание нельзя. Автоматические запуски никогда не перезаписывают описание, которое вы отредактировали вручную, а при нажатии Создать заново система попросит подтвердить замену описания, созданного вручную.

  • Ограничения на создание описания по сайту: Между созданием или повторным созданием описания по сайту действует пауза в 10 минут, а также ограничение — 5 запусков за 24 часа (неудачные попытки постановки в очередь не учитываются). Зависшие проверки автоматически завершаются по тайм-ауту (ограничение на выполнение — 5 минут, проверка устаревших запусков — каждые 15 минут). Если сайт блокирует автоматизированные браузеры или истекает время ожидания, UserJot не меняет существующее описание и объясняет причину.

Из UserJot (синхронизация со Справочным центром)

  • Справочный центр (опубликован): После публикации вашего Справочного центра общедоступные опубликованные статьи автоматически синхронизируются с Juno и не учитываются в бета-лимите в 5 источников. Черновики, статьи без публичного доступа, доступные только команде, не размещённые и удалённые статьи не включаются в синхронизацию. Если отключить Справочный центр, синхронизированные статьи будут удалены из Juno. Отдельные статьи Справочного центра нельзя приостанавливать или удалять на странице «Знания».

  • Языки и автоматическая локализация ссылок: При синхронизации Справочного центра каждая статья индексируется на языке по умолчанию рабочего пространства (если перевода нет — на исходном языке статьи). Juno ищет сведения на этом языке и отвечает на языке клиента. UserJot автоматически преобразует цитируемые URL-адреса Справочного центра в URL на языке клиента, если перевод опубликован. Отрисованные статьи Справочного центра размером более 256 KiB обрезаются по границе блока, а в конце добавляется ссылка на полную статью.

  • Скоро: Автоматическая синхронизация записей журнала изменений и завершённых отзывов скоро появится в разделе От UserJot.

Добавление внешних источников

Откройте раздел Управление знаниями и нажмите Добавить источник, чтобы добавить до 5 внешних источников в период бета-тестирования. Удаляемые источники сразу освобождают место, а приостановленные источники по-прежнему учитываются в лимите в 5 источников:

  • Загрузить файл: файлы .md, .markdown, .txt, .html, .htm, .json, .yaml или .yml (непустой текст в кодировке UTF-8; бинарные файлы не принимаются) размером до 10 MB каждый. Имена файлов могут содержать до 255 символов, но не могут включать разделители путей или управляющие символы. HTML-файлы автоматически преобразуются в Markdown, а файлы размером более 192 KiB разбиваются на разделы для поиска. Если загрузить файл с уже существующим именем (без учёта регистра), появится запрос на замену файла новой версией; при замене приостановленного файла он обновится, но останется приостановленным.

  • Просканировать сайт: Укажите общедоступный URL или домен без протокола (например, docs.example.com, который будет приведён к виду https://; строки запроса, #fragments, localhost, частные IP-адреса и URL с учётными данными удаляются или отклоняются). Сканер обрабатывает страницы с JavaScript, соблюдает правила сканирования, удаляет повторяющиеся элементы навигации и нижние колонтитулы, а также переходит по общедоступным ссылкам под указанным путём (только на том же хосте; поддомены не сканируются). Лимиты для каждого сканирования: до 500 страниц, 50 MB собранного содержимого и 12 часов. Нельзя одновременно добавлять пересекающиеся корневые пути сканирования (например, docs.example.com и docs.example.com/api). Если сканируется домен, на котором размещён опубликованный Справочный центр UserJot, URL-адреса Справочного центра автоматически пропускаются, чтобы страницы не дублировались. Сайты не пересканируются автоматически по расписанию: нажмите Пересканировать, чтобы обновить данные, или Отменить сканирование, пока сканирование выполняется.

Публикация, поиск, цитирование и актуальность источников

Когда вы добавляете, заменяете или повторно сканируете источник, UserJot в фоновом режиме создаёт новый пакет знаний (Обновление Juno… → Знания опубликованы). Пока новый пакет не будет готов, Juno продолжает отвечать на основе предыдущего опубликованного пакета, поэтому текущие чаты не прерываются. Приостановка или удаление источника вступает в силу сразу при следующем ответе Juno (ещё до завершения фонового обновления).

Juno находит ответы с помощью гибридного поиска (полнотекстового и семантического векторного поиска с повторным ранжированием) и перед ответом напрямую читает найденные разделы. При цитировании ссылки Juno использует только проверенные URL из вашего Справочного центра или просканированных источников (включая якоря #section, если они доступны) и никогда не выдумывает ссылки.

В меню строки любого внешнего источника доступны действия:

  • Заменить файл…: Загрузите обновлённую версию файла (доступно даже при достижении лимита в 5 источников, кроме случаев, когда другая версия этого файла ещё обрабатывается).

  • Пересканировать: Обновить данные источника-сайта. Для любого источника-сайта, в котором сохранено не менее 10 файлов, если при повторном сканировании удаляется более 20% файлов или изменяется более 80% файлов, UserJot приостанавливает обновление со статусом Большие изменения приостановлены для проверки. Вы сможете проверить изменения и выбрать Опубликовать или Отменить, чтобы система не удалила важную документацию без предупреждения.

  • Приостановить: Немедленно исключить источник из Juno, не удаляя его (он по-прежнему учитывается в лимите в 5 источников).

  • Удалить сайт… / Удалить файл…: Безвозвратно удалить источник и сразу освободить его место.

Устранение пробелов в знаниях

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

Эта статья ответила на ваш вопрос?