SpeechSense resource hierarchy
To manage dialogs in SpeechSense, you can use spaces, connections, and projects. The chart below provides the resource hierarchy overview in SpeechSense:
Each project and connection belongs to a single space. There are no projects and connections outside of a space.
Spaces are owned by organizations, and organizations do not interact with one another. The resources of one organization cannot interact with the resources of another one. Organizations are managed by Yandex Cloud Organization.
You can set up access in SpeechSense at the space or project level. By default, a new organization member has no access to resources within the organization. Permissions must be granted to new members explicitly.
SpeechSense resources
Space
A space is an isolated SpeechSense entity within which you can create connections and projects. In the Yandex Cloud resource hierarchy, SpeechSense spaces are at the same level with DataSphere communities and clouds.
A billing account is linked to each space. You can use one account to pay for resources in multiple spaces or link a separate account to each space.
Connection
A connection is a SpeechSense entity that contains:
-
Record types: audio or text messages.
-
Record metadata received from PBX, CRM systems, or other sources.
Metadata includes parameters such as names and IDs of the agent and customer, conversation date, and conversation language. You can use metadata to generate reports for analyzing a dialog or a group of dialogs.
If groups of dialogs have different metadata sets or record types, you can create a separate connection for each group.
Project
A project is an isolated SpeechSense entity within which you can manage dialogs. For example, in a project, you can view a dialog or build a report. In the Yandex Cloud resource hierarchy, SpeechSense projects are on the same level as DataSphere projects and folders.
A project can be viewed as a cross-section of data uploaded to a connection. When creating a project, you select a connection and set up filters for dialogs. As a result, filtered dialogs from the connection are added to the project.
Use multiple projects to group dialogs. For example, you can designate a separate project for each of your company's customers or products.
Inheritance of access rights
When a user performs an operation in SpeechSense, Yandex Identity and Access Management checks the user's access rights. These rights are inherited:
- Rights to an organization extend to the organization's resources, including spaces, connections, and projects.
- Rights to a space extend to all connections and projects within that space.
- Rights to a project extend to all dialogs and reports within that project.
No access rights are granted to connections. Connections are subject to space rights. To learn more about the roles available in the service, see Access management in SpeechSense.
Examples:
- A user with the
speech-sense.spaces.creator
role at the organization level can create a space.- A user with the
speech-sense.viewer
(Viewer
in SpeechSense) role at the space level can view data for a space, as well as its nested connections and projects.- A user with the
speech-sense.admin
(Admin
in SpeechSense) at the project level can perform any action within this project alone.
A user will not be able to access a space without space or organization level rights.