Отправка наборов данных для обучения и тестирования для пользовательской речи

Чтобы отправить собственные наборы данных в Speech Studio, выполните следующие действия:

1. Войдите в службу Speech Studio.

2. Выберите "Настраиваемая речь" Для набора>данных ">Речь" для имени >проекта передаются данные.

3. Выберите вкладку Данные для обучения или Данные для тестирования.

4. Выберите тип набора данных и нажмите Далее.

5. Укажите расположение набора данных и нажмите Далее. Вы можете выбрать локальный файл или ввести удаленное расположение, например URL-адрес BLOB-объектов Azure. Если вы выбираете удаленное расположение и не используете механизм безопасности доверенных служб Azure, удаленное расположение должно быть URL-адресом, который можно получить с помощью простого анонимного запроса GET. Например, URL-адрес SAS или общедоступный URL-адрес. URL-адреса, требующие дополнительной авторизации или ожидающие, что взаимодействие с пользователем не поддерживается.

   Примечание.

   При использовании URL-адреса BLOB-объектов Azure можно обеспечить максимальную безопасность файлов набора данных с помощью доверенного механизма безопасности служб Azure. Вы будете использовать те же методы, что и для URL-адресов записей хранения пакетной службы и URL-адреса учетных записей хранения для файлов набора данных. Дополнительные сведения см. здесь.

6. Введите имя и описание набора данных и нажмите Далее.

7. Проверьте параметры, а затем выберите Сохранить и закрыть.

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

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

При том, что вы не указываете, предназначен ли набор данных для тестирования или обучения, необходимо указать тип набора данных. Тип набора данных используется для определения типа создаваемого набора данных. В некоторых случаях тип набора данных используется только для тестирования или обучения, но полагаться на это не следует. Значения kind интерфейса командной строки речевой службы и REST API соответствуют параметрам в Speech Studio, как описано в следующей таблице:

Чтобы создать набор данных и подключить его к существующему проекту, используйте команду spx csr dataset create. Создайте параметры запроса в соответствии со следующими инструкциями:

• В качестве значения параметра project укажите идентификатор существующего проекта. Этот параметр рекомендуется, чтобы вы также могли просматривать набор данных и управлять ими в Speech Studio. Для получения доступных проектов выполните команду spx csr project list.

• Задайте обязательный параметр kind. Возможный набор значений для типа набора данных обучения: Acoustic, AudioFiles, Language, LanguageMarkdown и Произношение.

• Задайте обязательный параметр contentUrl. Этот параметр является расположением набора данных. Если вы не используете доверенный механизм безопасности служб Azure (см. следующее примечание), contentUrl параметр должен быть URL-адресом, который можно получить с помощью простого анонимного запроса GET. Например, URL-адрес SAS или общедоступный URL-адрес. URL-адреса, требующие дополнительной авторизации или ожидающие, что взаимодействие с пользователем не поддерживается.

  Примечание.

  При использовании URL-адреса BLOB-объектов Azure можно обеспечить максимальную безопасность файлов набора данных с помощью доверенного механизма безопасности служб Azure. Вы будете использовать те же методы, что и для URL-адресов записей хранения пакетной службы и URL-адреса учетных записей хранения для файлов набора данных. Дополнительные сведения см. здесь.

• Задайте обязательный параметр language. Языковой стандарт набора данных должен соответствовать языковому стандарту проекта. Языковой стандарт нельзя будет изменить позже. Параметр language интерфейса командной строки речевой службы соответствует свойству locale в запросе и ответе JSON.

• Задайте обязательный параметр name. Этот параметр — это имя, отображаемое в Speech Studio. Параметр name интерфейса командной строки речевой службы соответствует свойству displayName в запросе и ответе JSON.

Ниже приведен пример команды интерфейса командной строки речевой службы, которая создает набор данных и подключает его к существующему проекту:

spx csr dataset create --api-version v3.2 --kind "Acoustic" --name "My Acoustic Dataset" --description "My Acoustic Dataset Description" --project YourProjectId --content YourContentUrl --language "en-US"

Вы должны получить ответ в следующем формате:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/datasets/23b6554d-21f9-4df1-89cb-f84510ac8d23",
  "kind": "Acoustic",
  "links": {
    "files": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/datasets/23b6554d-21f9-4df1-89cb-f84510ac8d23/files"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "textNormalizationKind": "Default",
    "acceptedLineCount": 2,
    "rejectedLineCount": 0,
    "duration": "PT59S"
  },
  "lastActionDateTime": "2024-07-14T17:36:30Z",
  "status": "Succeeded",
  "createdDateTime": "2024-07-14T17:36:14Z",
  "locale": "en-US",
  "displayName": "My Acoustic Dataset",
  "description": "My Acoustic Dataset Description",
  "customProperties": {
    "PortalAPIVersion": "3"
  }
}

Свойство верхнего уровня self в теле ответа представляет собой URI набора данных. Используйте этот URI для получения сведений о проекте и файлах набора данных. Тот же URI используйте для обновления или удаления набора данных.

Для получения справки интерфейса командной строки речевой службы по работе с наборами данных выполните следующую команду:

spx help csr dataset

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

При том, что вы не указываете, предназначен ли набор данных для тестирования или обучения, необходимо указать тип набора данных. Тип набора данных используется для определения типа создаваемого набора данных. В некоторых случаях тип набора данных используется только для тестирования или обучения, но полагаться на это не следует. Значения kind интерфейса командной строки речевой службы и REST API соответствуют параметрам в Speech Studio, как описано в следующей таблице:

Чтобы создать набор данных и подключить его к существующему проекту, используйте Datasets_Create операцию преобразования речи в текстовый REST API. Создайте текст запроса в соответствии со следующими инструкциями:

• Задайте для свойства project значение URI существующего проекта. Это свойство рекомендуется, чтобы вы также могли просматривать набор данных и управлять ими в Speech Studio. Вы можете сделать запрос Projects_List для получения доступных проектов.

• Задайте обязательное свойство kind. Возможный набор значений для типа набора данных обучения: Acoustic, AudioFiles, Language, LanguageMarkdown и Произношение.

• Задайте обязательное свойство contentUrl. Это свойство является расположением набора данных. Если вы не используете доверенный механизм безопасности служб Azure (см. следующее примечание), contentUrl параметр должен быть URL-адресом, который можно получить с помощью простого анонимного запроса GET. Например, URL-адрес SAS или общедоступный URL-адрес. URL-адреса, требующие дополнительной авторизации или ожидающие, что взаимодействие с пользователем не поддерживается.

  Примечание.

  При использовании URL-адреса BLOB-объектов Azure можно обеспечить максимальную безопасность файлов набора данных с помощью доверенного механизма безопасности служб Azure. Вы будете использовать те же методы, что и для URL-адресов записей хранения пакетной службы и URL-адреса учетных записей хранения для файлов набора данных. Дополнительные сведения см. здесь.

• Задайте обязательное свойство locale. Языковой стандарт набора данных должен соответствовать языковому стандарту проекта. Языковой стандарт нельзя будет изменить позже.

• Задайте обязательное свойство displayName. Это свойство — это имя, отображаемое в Speech Studio.

Выполните HTTP-запрос POST, используя URI, как показано в следующем примере. Замените YourSubscriptionKey ключом ресурса службы "Речь" и YourServiceRegion регионом ресурса службы "Речь", а также задайте свойства текста запроса, как описано выше.

curl -v -X POST -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "kind": "Acoustic",
  "displayName": "My Acoustic Dataset",
  "description": "My Acoustic Dataset Description",
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "contentUrl": "https://contoso.com/mydatasetlocation",
  "locale": "en-US",
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/datasets"

Вы должны получить ответ в следующем формате:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/datasets/23b6554d-21f9-4df1-89cb-f84510ac8d23",
  "kind": "Acoustic",
  "links": {
    "files": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/datasets/23b6554d-21f9-4df1-89cb-f84510ac8d23/files"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "textNormalizationKind": "Default",
    "acceptedLineCount": 2,
    "rejectedLineCount": 0,
    "duration": "PT59S"
  },
  "lastActionDateTime": "2024-07-14T17:36:30Z",
  "status": "Succeeded",
  "createdDateTime": "2024-07-14T17:36:14Z",
  "locale": "en-US",
  "displayName": "My Acoustic Dataset",
  "description": "My Acoustic Dataset Description",
  "customProperties": {
    "PortalAPIVersion": "3"
  }
}

Свойство верхнего уровня self в теле ответа представляет собой URI набора данных. Используйте этот URI для получения сведений о проекте и файлах набора данных. Этот URI также используется для обновления или удаления набора данных.