# Q\&A

## Назначение и общая информация

Слот Q\&A предназначен для генерации ответа Агента на Реплика Собеседника, руководствуясь выбранной в Слоте Data source.Слот принимает Реплика в client\_message и отправляет ее на сервис генерации ответа (FAQ сервис) с учетом выбранной Data source, получает ответ от сервиса и записывает его в Системная контекстная переменная faq\_result.Слот Q\&A содержит в настройках Ресурсы Компании — Data source (Q\&A Datasource).

Используемая в FAQ сервисе LLM модель: **Llama3.**

\\

<figure><img src="https://2534152668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB6Qr9YeV8fDCt0YBfsvE%2Fuploads%2FEVaqKuC4j18mQfWycRW5%2FScreenshot%202025-02-12%20at%2017.49.27.png?alt=media&#x26;token=02c2b2b1-e7a5-4045-ac4a-cabd57d87108" alt=""><figcaption></figcaption></figure>

## Создание и настройки слота

### Атрибуты слота

![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-azxPqEyrti/9f295d77562f9a387ec8e969ba0e2b35b4240737c180f25bdc221d60aaafcbd829906972d99278fb4905849fe5413b7421421842d64fc8fbbf7ecbffa57866578d37179bd2a7b2b801db2fdc34d097fc525592407543d633eeafac97322c06aad05c1e60)![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-xsGd-Q2Cuk/7f908bde437751464daef45ccfc79c523fdd70dfe1a31a9ebaab4efce92610de774d97961a9564a4e9b5b0519961c42ba517c8f4ab850f95272b5a4ccfe5ec8115dc7de9f3f265ee165275522ec2720d4bdca6c2dc346a117e559218f25ba2e747a79c4f)

1. Name — название Слота, которое будет отображено в Дерево сценария. Максимальная длина значения поля — 40 символов. Если название не введено, Платформа автоматически копирует название выбранной Data source из поля Datasource в поле Name.
2. 1. Валидация: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании Слота) проверяется количество символов в поле:
   2. 1. при количестве символов более 40 в поле выводится ошибка Name must contain no more than 40 characters
      2. ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-L91IGP8zan/3c0df271afad89ab53b6d2c7fff7c3f357a8429e5c63f6bd7bb4c163edeff23f9ab58410ecd6ebfc5b35cb17ed0d9ef48f9293f9bc74f5e23db825aa80a37944e72f3b49c71063774ed006690868fb6f8c39a6f5971bd08968cff444083f88774940f9a0)
3. Data Source\* — Data source (Datasource), которая служит источником для поиска ответа на Реплика
4. 1. Валидация: по нажатию кнопки CREATE (при создании Слота) или SAVE (при редактировании Слота) проверяется наличие выбранной Data source в поле:
   2. 1. при отсутствии выбранной Data source в поле выводится ошибка  Please choose datasource\
         ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-dc442mXNig/9a4b07f36287767a3eafe255a15e63e2176dabb1ac833b284b6729929c16cacd5381546ee3b1bdb3414c9a523b3cb0ea7ce860c9cc06a41b064def507b0f53c9e8e438612df1d383856de2295b11e150fbf3c8d9838d635bda68d4ddc9d4d78d80bbc72e)
      2. при импорте конфига (Экспорт, импорт, замена сценария агента) может возникнуть ситуация, когда поле Data Source будет пустым, если открыть такой Слот, то его нельзя будет сохранить, пока не выберешь Data source (закрыть окно редактирования Слота без сохранения можно).
5. Send answer to channel — опция, которая отвечает за поведение Слота: отправлять ли ответ в канал (см. Работа слота), включена по дефолту
6. Chunk size\* — максимальный размер одного текстового сообщения с ответом от Слота. Поле появляется при включенной опции Send answer to channel. Лимиты на значение поля — от 100 до 1000000 символов.
7. 1. Валидация: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании слота) проверяется количество символов в поле:
   2. 1. при количестве символов менее 100 или более 1000000 в поле выводится ошибка Chunk size has to be between 100 and 1000000 characters
      2. ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-Ovq74PRyYK/6276cece665052deac2c680f34880e1396bb3035ca47933a15b9bc6f6693558b96a9c287309c10c095b9a5537999808a3ba5301bd743c6e315654d0d516533595500746e71aa30c2c97938706ea1d4d351f979e7e5ee534eb74b4159290e183b15774d8b)
   3. Текстовые сообщения отправляются в канал следующим образом:![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-X8BLJlC6gt/5348e003447daccb55c6c0b474a2cf9f766048a38d370ba703e48a289a1dbc0d949d59ad0d2c4ac9f06aedc0fec33efb5552dc1b214b0cd463aba0feff520bcb026df8a8c3f30e54e8f5e1fb44e10ffcc189ef944019efe15aa864a76ea47f0803b72b34)
   4. 1. FAQ-сервис отдает ответ в Слот постепенно частями, Слот принимает ответ от FAQ-сервиса так же частями и подсчитывает сумму их длин;
      2. С момента, как сумма длин частей достигает минимального размера (минимальный размер одного текстового сообщения считается по формуле Chunk size - 50 символов) и до момента, когда она становится равна Chunk size - 30 символов, система ищет в тексте ответа сепаратор — разделительный знак препинания (., ?, !, :, ;)
      3. 1. Если на данном промежутке находится сепаратор:
         2. 1. останавливается накопление сообщения, сообщение обрезается по сепаратору и отправляется в канал
            2. начинается накопление нового сообщения и повторяются операции, начиная с пункта 4.b.ii.
         3. Если на данном промежутке не найден сепаратор, то накопление ответа продолжается до момента, когда сумма длин частей становится равна Chunk size. На данном промежутке текста система ищет сепаратор или пробел.
         4. 1. Если на данном промежутке находится сепаратор или пробел:
            2. 1. останавливается накопление сообщения, сообщение обрезается по сепаратору или пробелу и отправляется в канал
               2. начинается накопление нового сообщения и повторяются операции, начиная с пункта 4.b.ii.
            3. Если на данном промежутке не найден сепаратор или пробел:
            4. 1. останавливается накопление сообщения, сообщение обрезается ровно по количеству символов Chunk size и отправляется в канал.
               2. начинается накопление нового сообщения и повторяются операции, начиная с пункта 4.b.ii.
      4. Таким образом в канал может уйти несколько сообщений, пока не будет отправлен весь ответ от FAQ-сервиса;
      5. После получения всех частей ответа Слот записывает весь текст ответа в Контекстная переменная faq\_result
      6. > Пример: значение поля Chunk size — 500 символов, на промежутке с 450 до 470 символов система ищет сепаратор (., ?, !, :, ;). Был найден сепаратор — ., сообщение было обрезано по нему и отправлено в канал. Началось накопление нового сообщения, на промежутке с 450 до 470 система не нашла сепаратор, накопление сообщения продолжилось, пока не был найден пробел на промежутке с 470 до 500 символов. Сообщение было обрезано по пробелу, отправлено в канал, началось накопление нового сообщения, которое содержало всего 466 символов. Оно было отправлено в канал, весь ответ был записан в Контекстная переменная faq\_result.
8. Include slot history to prompt (steps count) — количество шагов истории общения со Слотом, которое необходимо использовать в качестве контекста в момент запроса к FAQ-сервису:
9. 1. в Платформа хранится история общения в 6 шагов (один шаг это один запрос + полный ответ) для каждого Слота Q\&A и LLM  в каждом Чате;
   2. > Проблема: на данный момент хранится история общения в 3 шага, а не 6 🐞В слоте Q\&A количество пар вопрос-ответ в Include slot history to prompt steps count не совпадает с требуемым
   3. один шаг хранится 2 недели, затем удаляется из истории общения;
   4. по умолчанию значение поля равно 0;
   5. при отсутствии значения в поле после сохранения Слота в поле подставляется значение 0;
   6. в поле допустимо использование Выражение;
   7. если в поле содержится невалидное значение — не число; число не в диапазоне от 0 до 6; Выражение, дающее результат не в формате числа либо числа не в диапазоне от 0 до 6 — то при работе Слота будет подставлено значение 0.
10. Custom prompt — пользовательская подсказка (промпт), содержащая инструкции по генерации ответа Слотом. Максимальное значение поля — 1500 символов.
11. 1. Валидация: по нажатию кнопки CREATE (при создании слота) или SAVE (при редактировании слота) проверяется количество символов в поле:
    2. 1. при количестве символов более 1500 в поле выводится ошибка Prompt size should not exceed 1500 characters\
          ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-4xZDtf0cz3/06f160839a6a465c988efa2a7bc1c312bcd049733bcddb5715b2b27cea73321ea19294111a2a4435a458e42dfa23842d82801ec04d266f9ecf91cd379afbe09544106c726b7b2cc5e5befbac9ec67d5f060a47b4417f175340744dad5737952754aaada1)
    3. В поле допустимо использование Выражение и Выражение с управляющей конструкцией. Значение Выражение будет вычислено и подставлено в качестве пользовательского промпта.
    4. Характеристики, которые можно указать с помощью дополнительных инструкций:
    5. 1. Имя модели;
       2. Тон ответа;
       3. Формат ответа;
       4. Длина ответа.
    6. Ограничения и специфика:
    7. 1. Нет гарантий, что дополнительные инструкции будут 100% случаях выполняться;
       2. Дополнительные инструкции можно описывать на целевом языке Q\&A модели;
       3. Не стоит повторять в дополнительных инструкциях инструкции системного промпта Q\&A модели
    8. Стабильнее и разнообразнее инструкции поддерживает английский язык (англоязычный агент с англоязычным промптом)
12. Кнопка SHOW DATASOURCE IN NEW TAB — по нажатию кнопки выбранная в поле Data Source Data source открывается в соседней вкладке браузера.

### Использование синтаксиса в Слоте Q\&A

В Слоте Q\&A допустимо использование Выражение в поле Include slot history to prompt (steps count) и Выражение и Выражение с управляющей конструкцией в поле Custom prompt. Подробнее: Синтаксис

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

При генерации ответа Слот Q\&A ориентируется в первую очередь на инструкции системного (встроенного) промпта:

1. Задача — ответить на вопрос по контексту (контекст — часть Data source, наиболее вероятно содержащая ответ на вопрос);
2. Ответ должен быть прямым, без додумок, только по контексту;
3. Ответ должен быть только на заданном языке;
4. Если вопрос не релевантен контексту, ответить, что невозможно ответить;
5. Если контекста недостаточно, чтобы дать ответ на вопрос, ответить, что невозможно ответить;
6. Не упоминать контекст.

## Data Source

О создании Data source: Q\&A Data Sources

## Особенности валидации сценария со слотом Q\&A

1. При импорте только конфигурационного файла без файлов Data source Слоты Q\&A в Сценарий агента будут созданы с пустыми Data source (Data source будут созданы, но не будут содержать в себе файлов).\
   ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-qaJhf7_Moi/859cc224f15fdf7f382cb1a7a57c89ab118fa6aa68ff81b295718813b5c81643d0955ff81d6dbcb9d474fe60949b3acb28835e0886b62bfe30c14af8bb1522cae032b3b092bc1f999e32a8fdcf312948e8f65f95a7af94b7eca7191640f2bfba5295cb46)
2. 1. При попытке обучить такого Агента будет выведена ошибка валидации и Агент не обучится.\
      ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-KGMV92Ntqs/d04e9d15ffde8c5ff04130af2fe6527d70977bdde212edf3b6d125950b2658bbe0c41c90749203bab2a68fc22acae41a84bd1d5f99c4e71bca5de41fadccaf9f2a3266a545e7a12d997d3ba853abca65090c94bc91262d2b5a855d2e6eccefd45f257e9f)
3. Максимальная продолжительность обучения Агента не более 10 минут на один Слоты Q\&A с уникальным значением в  Data Source.
4. Не допускается использование Слота Q\&A в цикле Repeat без Блокирующий слот в Ветка сценария Repeat Next, при Обучение Агента будет выведена ошибка валидации: To use Q\&A slot in loop you need blocking slot (Wait for  Reaction, Button Menu etc) in Repeat Next branch (не реализовано)

## Работа слота

1. Слот Q\&A принимает на вход Контекстная переменная client\_message (в т.ч предварительно модифицированную, например, в Слоте Memory).
2. Слот Q\&A вычисляет содержимое поля Custom prompt, если оно заполнено
3. Слот Q\&A вычисляет содержимое поля Include slot history to prompt (steps count):
4. 1. если в поле содержится невалидное значение — не число; число не в диапазоне от 0 до 6; Выражение, дающее результат не в формате числа либо числа не в диапазоне от 0 до 6 — то будет подставлено значение 0.
5. Слот отправляет в FAQ-сервис запрос формата:
6. {   "model\_id": <числовой идентификатор модели>,   "question": <текст вопроса (client\_message)>,   "options": {  <-- Опциональный объект     "additional\_instructions": <содержимое поля Custom prompt>   }, "history": {   "messages": \[ <-- шаги истории общения для контекста     {       "type": "client" (or "agent"),       "content": "some question for q\&a"     }   ] }}
7. FAQ-сервис производит генерацию ответа на текст из client\_message на основании информации в выбранной Data source в поле Data Source в настройках Слота, истории общения (если значение поля  Include slot history to prompt (steps count) валидно и больше 0), системного промпта и пользовательского промпта (при его наличии). Ответ отправляется FAQ-сервисом в Слот.
8. 1. Существует Лимит на длину ответа от FAQ-сервиса равный 1024 токена (токен — это минимальная единица текста, на которую модель (Llama3) разбивает текст для обработки). Ответ от FAQ-сервиса никогда не превышает данный лимит. Среднее количество символов на токен — 4 символа, соответственно, примерная максимальная длина полного ответа от FAQ-сервиса — 4096 символов.
   2. Для голосового канала Voice box API ответ всегда будет отдаваться стримингом по предложениям
9. Слот отправляет текст ответа в канал, как описано в п.4.b раздела Атрибуты слота, если в настройках Слота включена опция Send answer to channel.
10. После получения всех частей ответа, Слот записывает текстовый результат (ответ) в переменную faq\_result
11. 1. если операция была прервана по таймауту в faq\_result попадает текст error: timeout
    2. faq\_result — Системная контекстная переменная, не подлежит изменению пользователем

\\

## Аналитика работы слота и отчеты

Информация о работе Слота отражается в следующих отчетах:

1. Chat context — переменная faq\_result\
   ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-1c2b0TNYCS/d392188d033f3debe77186f4b764b11a59cf20a52fa59827d5ae714654104b0c38fba78305a65bd6446f91d895d2835f10f0bb1fa6b4529a0d493a8b3d7f673e51b9853761fa829261009844e7ef2467c5b5ebbfd02900a9a7a6c0032fd7a50c750a7478)
2. Project usage — количество попаданий в Слот.\
   ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-SzSYvkd-i9/e44580ffe0415b9022221aff1f71a888061bfd238120b51ab91d0e6c54d30f229348a2843e52dc22222e454f5875fbcb81b809e609532c27fa993170cc51563aa4b395719a5aacc352d932eeca6a63c35851d6836f4208ad85c078fa2432d3c31456c682)
3. Slot stats — отмечается прохождение Слота (в т. ч. в случае прерывания операции по таймауту).\
   ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-F6fzDfjpFr/07951cb0839f4b924b0491441229502fb1132bf2b2e602801db20246e1d488ccb9ae8c2be170d9cb15bb79e27d5990500deab9ccc4173eb61824a9961d6d3103bf728d7759e774b6868d9f5f6ddc05bcce8a30f390207246ad0450f5802b4fcc233af73c)
4. Chat History — если включена опция отправки ответа в канал, то сообщения от Агента отражаются в отчете и отмечаются как текстовые сообщения.\
   ![image.png](https://codahosted.io/docs/QZi0KPCnEG/blobs/bl-1pZIMrQA_-/9e6f5b841bb8f806ada9badf4c45ca4d825f7217ad7b9f64fb6430256c2fecaf3c7d9a999ac08910d47c7f34976de84b37330f9905563832f6e8c403c54393a561d118f62705f7baec7e50e4b2524fa5dd20c47bfa140e234314abe4e318893cda75d3f2)

## Планируемая аналитика работы слота и отчеты

1. Chat History — записывается результат выполнения слота в следующем формате - создаются 2 или 3 записи в таблице:
2. 1. Начало обработки сообщения FAQ сервисом (всегда)
   2. 1. Author - System
      2. тип Q\&A processing start
      3. контент:
      4. 1. slot id
         2. входная фраза
         3. Datasource name
         4. 1. сейчас допустимо текущее  на момент выгрузки имя датасорса
            2. в новом отчете нужно будет выводить имя датасорса на момент общения - из опубликованной версии
   3. Полный текст ответа,
   4. 1. Author - Agent
      2. тип: Q\&A reply
      3. контент - текст сообщения
   5. Окончание обработки сообщения FAQ сервисом (всегда)
   6. 1. Author - System
      2. тип Q\&A processing end
      3. контент:
      4. 1. slot id
         2. признак answer sent (“отправлен ли ответ в канал” )
         3. chunk size
         4. chunk number
         5. скорость выполнения генерации ответа (от поступления задачи в FAQ сервис, до выдачи им ответа в сценарий)![](https://2534152668-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB6Qr9YeV8fDCt0YBfsvE%2Fuploads%2F6UidzTHZjq4Yt6LImstv%2FScreenshot%202025-02-12%20at%2017.46.44.png?alt=media\&token=7b51e5a0-0a7f-473a-8cc2-68afa97b2abe)
