Иерархия ресурсов SpeechSense

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

Каждый проект и подключение принадлежат одному пространству. Не существует проектов и подключений вне пространства.

Пространства принадлежат организациям, при этом организации не взаимодействуют друг с другом. Ресурсы одной организации не могут взаимодействовать с ресурсами другой. Организациями управляет сервис Yandex Cloud Organization.

Настроить доступ в SpeechSense можно на уровне пространства или проекта. По умолчанию новый участник организации не имеет доступа к ресурсам внутри организации. Права доступа ему выдаются явно.

Ресурсы SpeechSenseРесурсы SpeechSense

ПространствоПространство

Пространство — это изолированная сущность SpeechSense, в рамках которой создаются подключения и проекты. В иерархии ресурсов Yandex Cloud пространства SpeechSense находятся на одном уровне с сообществами DataSphere и облаками.

К каждому пространству привязывается платежный аккаунт. Вы можете использовать один аккаунт для оплаты ресурсов в нескольких пространствах или к каждому пространству привязать отдельный аккаунт.

ПодключениеПодключение

Подключение — это сущность SpeechSense, которая содержит:

• Загруженные аудиозаписи разговоров или переписки из чатов.

• Тип каждой записи: аудио или текстовые сообщения.

• Метаданные записей, полученные из АТС, чатов, CRM-систем или других источников.

  Метаданные представляют такие параметры, как имена и идентификаторы оператора, клиента и бота (последний — только для чатов), дату и язык диалога. По метаданным можно проанализировать отдельный диалог или группу диалогов с помощью отчетов.

  Метаданные могут быть следующих типов:

  • дата (в формате YYYY-MM-DDTHH:MM:SSZ);

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

  • строка;

  • число;

  • дробное число;

  • логическое значение;

  • JSON;

  • URL (ссылка на CRM-систему).

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

ПроектПроект

Проект — это изолированная сущность SpeechSense, в рамках которой ведется работа с диалогами. Например, в проекте можно посмотреть диалог или построить отчет. В иерархии ресурсов Yandex Cloud проекты SpeechSense находятся на одном уровне с проектами DataSphere и каталогами.

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

Используйте несколько проектов для группировки диалогов. Например, можно выделить отдельный проект для каждого клиента или продукта вашей компании.

Наследование прав доступаНаследование прав доступа

Когда пользователь выполняет какую-либо операцию в SpeechSense, сервис Yandex Identity and Access Management проверяет права доступа пользователя. Эти права наследуются:

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

На подключения не выдаются права доступа. Для работы с подключениями применяются права на пространство. Подробнее о ролях, которые действуют в сервисе, см. в разделе Управление доступом в SpeechSense.

Примеры:

• Если пользователю выдать роль speech-sense.spaces.creator на уровне организации, он сможет создать пространство.
• Если пользователю выдать роль speech-sense.viewer (Viewer в SpeechSense) на уровне пространства, он сможет просматривать данные пространства, а также вложенных в него подключений и проектов.
• Если пользователю выдать роль speech-sense.admin (Admin в SpeechSense) на уровне проекта, пользователь сможет выполнять любые действия только в рамках этого проекта.

У пользователя не будет доступа к пространству, если не предоставить права на уровне пространства или организации.