Связаться с намиПодключиться

Работа с диалогами

Статья создана
Обновлена 29 апреля 2025 г.

В диалоге вы можете получить подробную информацию о диалоге, прослушать аудиозапись разговора и посмотреть переписку клиента с оператором или ботом.

Посмотреть список диалогов

  1. Откройте главную страницу SpeechSense.
  2. Перейдите в нужное пространство, затем выберите нужный проект.

По умолчанию на вкладке Диалоги отображаются 100 последних диалогов. Чтобы увидеть предыдущие, нажмите кнопку Показать ещё в конце списка.

Найти диалоги

Для поиска диалогов вы можете использовать:

Чтобы получить больше информации о каждом диалоге, настройте отображение колонок.

Фильтры

Чтобы применить фильтр к диалогам:

  1. Откройте главную страницу SpeechSense.
  2. Перейдите в нужное пространство, затем выберите нужный проект.
  3. На вкладке Диалоги нажмите кнопку Добавить фильтр.
  4. Выберите нужный фильтр и введите его значение.
  5. Нажмите кнопку Применить.

Вы можете добавить несколько фильтров. Они будут объединены логической операцией «И». В результате будут найдены диалоги, которые удовлетворяют всем заданным условиям.

Полнотекстовый поиск

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

Чтобы выполнить поиск:

  1. Откройте главную страницу SpeechSense.
  2. Перейдите в нужное пространство, затем выберите нужный проект.
  3. Перейдите на вкладку Диалоги.
  4. В выпадающем списке над поисковой строкой выберите Текстовый.
  5. Введите в поисковой строке искомый фрагмент текста.
  6. (Опционально) Чтобы уточнить результаты поиска, под поисковой строкой выберите из выпадающего списка канал, в котором нужно выполнить поиск: Все участники, Оператор или Клиент.
  7. Нажмите кнопку Поиск.

Словарный поиск позволяет найти диалоги, содержащие одну или несколько заданных ключевых фраз.

Чтобы выполнить поиск:

  1. Откройте главную страницу SpeechSense.

  2. Перейдите в нужное пространство, затем выберите нужный проект.

  3. Перейдите на вкладку Диалоги.

  4. В выпадающем списке над поисковой строкой выберите Словарный.

  5. Введите в поисковой строке ключевую фразу или фразы. Каждая фраза вводится с новой строки.

  6. (Опционально) Чтобы уточнить результаты поиска:

    • Выберите из выпадающего списка канал, в котором нужно выполнить поиск: Все участники, Оператор или Клиент.
    • Выберите допустимую дистанцию между словами в ключевой фразе.
    • Включите опцию Точное совпадение ключевых фраз.

  7. Нажмите кнопку Поиск.

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

Чтобы выполнить поиск:

  1. Откройте главную страницу SpeechSense.

  2. Перейдите в нужное пространство, затем выберите нужный проект.

  3. Перейдите на вкладку Диалоги.

  4. В выпадающем списке над поисковой строкой выберите Смысловой.

  5. Выберите из выпадающего списка один из смысловых атрибутов.

  6. В поисковой строке выберите поисковый запрос из автоматически сгенерированных подсказок или введите его вручную.

    Если в проекте более 1000 диалогов, при подготовке подсказок SpeechSense проанализирует только 1000 диалогов случайным образом. Если автоматически сгенерированные подсказки вам не подходят, вы можете нажать кнопку Обновить. SpeechSense снова выберет 1000 диалогов случайным образом, проанализирует их и сгенерирует новые подсказки.

  7. Нажмите кнопку Поиск.

Настроить отображение колонок

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

Чтобы настроить отображение колонок:

  1. Откройте главную страницу SpeechSense.

  2. Перейдите в нужное пространство, затем выберите нужный проект.

  3. В строке заголовков для списка диалогов нажмите . Откроется список всех колонок.

  4. Выполните в списке колонок нужные действия:

    • Чтобы отобразить дополнительные колонки, отметьте их.
    • Чтобы скрыть ненужные колонки, снимите для них отметки. Некоторые колонки нельзя скрыть, в них снятие отметки недоступно.
    • Чтобы изменить порядок колонок, слева от названия колонки нажмите и перетяните колонку на нужную позицию в списке.

  5. Нажмите кнопку Применить.

Просмотреть диалог

  1. Откройте главную страницу SpeechSense.

  2. Перейдите в нужное пространство, затем выберите нужный проект.

  3. Найдите нужный диалог.

  4. Откройте диалог одним из способов:

    • Чтобы открыть превью диалога, нажмите на строку диалога.
    • Чтобы открыть диалог в новом окне, нажмите в строке диалога справа .

На странице диалога отображается следующая информация:

  • Метаданные, например, имена оператора и клиента, дата звонка или сообщения, язык диалога.
  • Аудиозапись разговора (только для аудио).
  • Содержимое разговора на вкладке Диалог.
  • Смысловой анализ разговора на вкладке Анализ от YandexGPT.
  • Присвоенные диалогу теги.

Подробнее см. в разделе Детальная информация о диалоге.

Изменить метаданные диалога

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

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

Изменить метаданные диалога можно с помощью gRPC API Yandex Cloud. Для этого:

  1. Получите идентификатор диалога.
  2. Подготовьте инфраструктуру для работы с gRPC API Yandex Cloud.
  3. Получите информацию о диалоге.
  4. Измените метаданные диалога.

Получите идентификатор диалога

Найдите нужный диалог и скопируйте его идентификатор:

  1. Откройте главную страницу SpeechSense.
  2. Перейдите в нужное пространство, затем выберите нужный проект.
  3. На вкладке Диалоги найдите нужный диалог и перейдите в него.
  4. Скопируйте идентификатор диалога, находящийся в левом верхнем углу.

Подготовьте инфраструктуру для работы с gRPC API Yandex Cloud

Для работы с API Yandex Cloud потребуется Git, Python 3.6 или старше и пакет grpcio-tools. Узнайте, как установить Python.

  1. В консоли управления создайте сервисный аккаунт.

  2. Добавьте сервисный аккаунт в пространство с ролью Data editor. Это позволит сервисному аккаунту загружать данные в SpeechSense.

  3. Чтобы аутентифицироваться в API Yandex Cloud, создайте API-ключ или IAM-токен для сервисного аккаунта.

  4. Склонируйте репозиторий API Yandex Cloud:

    git clone https://github.com/yandex-cloud/cloudapi

  5. Установите пакет grpcio-tools с помощью менеджера пакетов pip:

    pip install grpcio-tools

Получите информацию о диалоге

Воспользуйтесь вызовом TalkService/Get и выполните запрос, например, с помощью gRPCurl.

В примерах используются демонстрационные данные.

Запрос:

grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/yandex/cloud/speechsense/v1/talk_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "space_id": "f3fuc***************",
          "project_id": "eagpe***************",
          "talk_ids": [
            "aud78***************"
          ]
        }' \
    api.speechsense.yandexcloud.net:443 \
    yandex.cloud.api.speechsense.v1.TalkService.Get

Ответ:

{
  "talk": [
    {
      "id": "aud78***************",
      "organizationId": "yc.organization-manager.example",
      "spaceId": "f3fuc***************",
      "connectionId": "eagjj***************",
      "projectIds": [
        "eagpe***************"
      ],
      "createdBy": "ajegr***************",
      "createdAt": "2025-04-24T14:35:19.882Z",
      "modifiedBy": "CLASSIFIER",
      "modifiedAt": "2025-04-24T14:35:24.470980Z",
      "talkFields": [
        {
          "name": "operator_name",
          "value": "Иван",
          "type": "FIELD_TYPE_STRING"
        },
        {
          "name": "operator_id",
          "value": "11111",
          "type": "FIELD_TYPE_STRING"
        },
        {
          "name": "client_name",
          "value": "Александр",
          "type": "FIELD_TYPE_STRING"
        },
        {
          "name": "client_id",
          "value": "22222",
          "type": "FIELD_TYPE_STRING"
        },
        {
          "name": "date",
          "value": "2025-04-24T14:34:19Z",
          "type": "FIELD_TYPE_DATE"
        },
        {
          "name": "direction_outgoing",
          "value": "true",
          "type": "FIELD_TYPE_BOOLEAN"
        },
        {
          "name": "language",
          "value": "ru-ru",
          "type": "FIELD_TYPE_STRING"
        },
        {
          "name": "score_main",
          "type": "FIELD_TYPE_STRING"
        }
      ],
    // ...
    }
  ]
}

В ответе, в поле talkFields, содержатся метаданные диалога:

  • operator_name — имя оператора.

  • operator_id — идентификатор оператора.

  • client_name — имя клиента.

  • client_id — идентификатор клиента.

  • date — дата и время начала диалога в формате YYYY-MM-DDTHH:MM:SSSZ.

    Даты указываются в формате ISO 8601 UTC с нулевым смещением времени. Если необходимо указать московское время, добавьте +03:00 вместо Z в конец строки: 2025-04-24T14:34:19+03:00.

  • direction_outgoing — направление диалога (входящий или исходящий).

  • language — язык диалога.

  • score_main — оценка диалога. Дополнительный ключ, значение будет добавлено при изменении метаданных.

Измените метаданные диалога

Примечание

При изменении метаданных диалога необходимо передавать все ключи, иначе их значения будут удалены.

Воспользуйтесь вызовом TalkService/Upload и выполните запрос, например, с помощью gRPCurl.

В примере используются демонстрационные данные.

Запрос:

В запросе добавляется новое значение ключа score_main, остальные значения ключей передаются без изменений.

grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/speechsense/v1/talk_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "talkId": "aud78***************",
          "metadata": {
            "connectionId": "eagjj***************",
            "fields": {
              "date": "2025-04-24T14:34:19Z",
              "direction_outgoing": "true",
              "language": "ru-ru",
              "operator_name": "Иван",
              "operator_id": "11111",
              "client_name": "Александр",
              "client_id": "22222",
              "score_main": "4"
            }
          }
        }' \
    api.speechsense.yandexcloud.net:443 \
    yandex.cloud.speechsense.v1.TalkService.Upload

Пример поиска диалогов по периоду и фрагменту текста

Условия поиска:

  • За период 10.11.2023 - 16.11.2023.
  • Содержит фразу клиента хорошее обслуживание.

Выполните действия:

  1. Откройте главную страницу SpeechSense.
  2. Перейдите в нужное пространство, затем выберите нужный проект.
  3. На вкладке Диалоги в строке поиска введите хорошее обслуживание.
  4. Справа от строки поиска выберите из выпадающего списка канал Клиент.
  5. Нажмите кнопку Добавить фильтр.
  6. В группе Общие метаданные выберите фильтр Дата начала. В качестве значения фильтра укажите диапазон дат 10.11.2023 - 16.11.2023.
  7. Нажмите кнопку Применить.

В результате отобразятся отфильтрованные диалоги.

Пример ранжирования диалогов в зависимости от найденных фрагментов текста:

№ п/п

Дата диалога

Фрагмент диалога

1

16.11.2023

спасибо за хорошее обслуживание

2

13.11.2023

хорошее оборудование и сервисное обслуживание

3

15.11.2023

полное обслуживание системы
Предыдущая
Получение информации о диалоге в REST API
Следующая
Просмотр связанных диалогов