Создание проектов в рабочем процессе оркестрации

Статья
04/04/2025

Рабочий процесс оркестрации позволяет создавать проекты, которые обеспечивают подключение ваших приложений к следующим:

Пользовательское распознавание речи
Ответы на вопросы
LUIS

Предварительные условия

Прежде чем приступить к использованию рабочего процесса оркестрации, необходимо подготовить следующее:

Подписка Azure — создайте бесплатную учетную запись.
Ресурс языка ИИ Azure

Создание языкового ресурса

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

Примечание.

Чтобы создать ресурс Языка, требуется роль владельца, назначенная группе ресурсов.
Если вы планируете использовать функцию ответа на вопрос, вам необходимо включить эту функцию при создании ресурса.

Создание ресурса на портале Azure

Перейдите к портал Azure, чтобы создать новый ресурс языка искусственного интеллекта Azure.
Нажмите кнопку "Продолжить", чтобы создать ресурс

Создайте языковой ресурс с приведенными ниже сведениями.

Сведения об экземпляре	Обязательное значение
Область/регион	Один из поддерживаемых регионов.
Имя.	Имя языкового ресурса.
Ценовая категория	Одна из поддерживаемых ценовых категорий.

Создание нового языкового ресурса из Студии языка

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

Создайте языковой ресурс с приведенными ниже сведениями.

Сведения об экземпляре	Обязательное значение
Подписка Azure.	Ваша подписка Azure
Группа ресурсов Azure	Группа ресурсов Azure
Имя ресурса Azure	Имя ресурса Azure
Расположение	См. дополнительные сведения о поддерживаемых регионах.
Ценовая категория	См. дополнительные сведения о поддерживаемых ценовых категориях.

Внимание

Обязательно включите управляемое удостоверение при создании языкового ресурса.
Чтение и подтверждение уведомления об ответственном ИИ

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

Создать проект рабочего процесса оркестрации

Создав языковой ресурс, создайте проект оркестровки.

Language Studio
REST API;

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

значение	Описание
Имя.	Имя проекта.
Описание	Необязательное описание проекта.
Основной язык высказываний	Основной язык проекта. Данные обучения должны быть преимущественно на этом языке.

Когда все будет готово, нажмите Далее и проверьте подробные сведения. Чтобы завершить процесс, выберите Создать проект. Теперь вы должны увидеть экран Сборка схемы в вашем проекте.

Отправьте запрос PATCH, используя следующий URL-адрес, заголовки и текст JSON, чтобы создать проект.

Запросить URL-адрес

При создании запроса API используйте следующий URL-адрес. Замените значения заполнителей ниже собственными значениями.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Заполнитель	значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение чувствительно к регистру.	`myProject`
`{API-VERSION}`	Версия вызываемого API.	`2023-04-01`

Заголовки

Используйте следующий заголовок для проверки подлинности запроса.

Ключ	значение
`Ocp-Apim-Subscription-Key`	Ключ к вашему ресурсу. Используется для проверки подлинности запросов API.

Содержимое

Используйте следующий пример JSON в качестве тела.

{
  "projectName": "{PROJECT-NAME}",
  "language": "{LANGUAGE-CODE}",
  "projectKind": "Orchestration",
  "description": "Project description"
 }

Ключ	Заполнитель	значение	Пример
`projectName`	`{PROJECT-NAME}`	Имя проекта. Значение чувствительно к регистру.	`EmailApp`
`language`	`{LANGUAGE-CODE}`	Строка, указывающая код языка для речевых фрагментов, используемых в проекте. Если проект является многоязычным, выберите код языка большинства речевых фрагментов.	`en-us`

Импорт проекта рабочего процесса оркестрации

Language Studio
REST API;

Вы всегда можете экспортировать проект рабочего процесса оркестрации в виде JSON-файла. Для этого перейдите на страницу проектов рабочих процессов оркестрации, выберите проект и в верхнем меню нажмите кнопку Экспорт.

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

Чтобы импортировать проект, нажмите кнопку со стрелкой рядом с кнопкой "Создать проект " и нажмите кнопку "Импорт", а затем выберите JSON-файл.

Вы можете импортировать JSON-файл рабочего процесса оркестрации в службу.

Отправьте запрос POST, используя указанный ниже URL-адрес, заголовки и текст JSON, чтобы импортировать проект.

Запросить URL-адрес

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:import?api-version={API-VERSION}

Заполнитель	значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение учитывает регистр.	`myProject`
`{API-VERSION}`	Версия вызываемого API.	`2023-04-01`

Заголовки

Используйте следующий заголовок для проверки подлинности запроса.

Ключ	значение
`Ocp-Apim-Subscription-Key`	Ключ к вашему ресурсу. Используется для проверки подлинности запросов API.

Содержание

Примечание.

Каждое намерение должно быть только одного типа (CLU, LUIS и qna)

Используйте следующий пример JSON в качестве тела запроса.

{
  "projectFileVersion": "{API-VERSION}",
  "stringIndexType": "Utf16CodeUnit",
  "metadata": {
    "projectKind": "Orchestration",
    "settings": {
      "confidenceThreshold": 0
    },
    "projectName": "{PROJECT-NAME}",
    "description": "Project description",
    "language": "{LANGUAGE-CODE}"
  },
  "assets": {
    "projectKind": "Orchestration",
    "intents": [
      {
        "category": "string",
        "orchestration": {
          "kind": "luis",
          "luisOrchestration": {
            "appId": "00001111-aaaa-2222-bbbb-3333cccc4444",
            "appVersion": "string",
            "slotName": "string"
          },
          "cluOrchestration": {
            "projectName": "string",
            "deploymentName": "string"
          },
          "qnaOrchestration": {
            "projectName": "string"
          }
        }
      }
    ],
    "utterances": [
      {
        "text": "Trying orchestration",
        "language": "{LANGUAGE-CODE}",
        "intent": "string"
      }
    ]
  }
}

Ключ	Заполнитель	значение	Пример
`api-version`	`{API-VERSION}`	Версия вызываемого API. Используемая здесь версия должна совпадать с версией API в URL-адресе.	`2022-03-01-preview`
`projectName`	`{PROJECT-NAME}`	Имя проекта. Это значение чувствительно к регистру.	`EmailApp`
`language`	`{LANGUAGE-CODE}`	Строка, указывающая код языка для речевых фрагментов, используемых в проекте. Если проект является многоязычным, выберите код языка большинства речевых фрагментов.	`en-us`

Вы всегда можете экспортировать проект рабочего процесса оркестрации в виде JSON-файла.

Создайте запрос POST, используя следующий URL-адрес, заголовки и текст JSON, чтобы экспортировать проект.

Запросить URL-адрес

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/:export?stringIndexType=Utf16CodeUnit&api-version={API-VERSION}

Заполнитель	значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение является чувствительным к регистру.	`EmailApp`
`{API-VERSION}`	Версия вызываемого API.	`2023-04-01`

Заголовки

Используйте следующий заголовок для проверки подлинности запроса.

Ключ	значение
`Ocp-Apim-Subscription-Key`	Ключ к вашему ресурсу. Используется для проверки подлинности запросов API.

После отправки запроса API вы получите ответ 202, указывающий на успешное выполнение. Извлеките значение operation-location из заголовков ответа. Оно будет иметь следующий формат:

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

JOB-ID используется для идентификации запроса, так как эта операция является асинхронной. Используйте этот URL-адрес для получения кода JSON экспортированного проекта с применением того же способа проверки подлинности.

Получите информацию о проекте оркестрации

Language Studio
REST API;

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

Чтобы получить сведения о проекте рабочего процесса оркестрации, отправьте запрос GET, используя следующие URL-адрес и заголовки. Замените значения заполнителей собственными значениями.

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Заполнитель	значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение чувствительно к регистру.	`myProject`
`{API-VERSION}`	Версия вызываемого API.	`2023-04-01`

Заголовки

Используйте следующий заголовок для проверки подлинности запроса.

Ключ	значение
`Ocp-Apim-Subscription-Key`	Ключ к вашему ресурсу. Используется для проверки подлинности запросов API.

Содержимое ответа

После отправки запроса вы получите следующий ответ.

{
  "createdDateTime": "2022-04-18T13:53:03Z",
  "lastModifiedDateTime": "2022-04-18T13:53:03Z",
  "lastTrainedDateTime": "2022-04-18T14:14:28Z",
  "lastDeployedDateTime": "2022-04-18T14:49:01Z",
  "projectKind": "Orchestration",
  "projectName": "{PROJECT-NAME}",
  "description": "This is a sample orchestration project.",
  "language": "{LANGUAGE-CODE}"
}

После отправки запроса API вы получите ответ 200, указывающий на успешное выполнение, и текст ответа в формате JSON с подробными сведениями о проекте.

Удаление проекта

Language Studio
REST API;

Если проект вам больше не нужен, вы можете удалить его с помощью Студии Языка. Выберите "Проекты " в меню навигации слева, выберите проект, который нужно удалить, а затем выберите "Удалить " в верхнем меню.

Если проект вам больше не нужен, вы можете удалить его с помощью интерфейсов API.

Создайте запрос DELETE, используя следующий URL-адрес, заголовки и текст JSON, чтобы удалить проект по распознаванию устной речи.

Запросить URL-адрес

{ENDPOINT}/language/authoring/analyze-conversations/projects/{PROJECT-NAME}?api-version={API-VERSION}

Заполнитель	значение	Пример
`{ENDPOINT}`	Конечная точка для проверки подлинности запроса API.	`https://<your-custom-subdomain>.cognitiveservices.azure.com`
`{PROJECT-NAME}`	Имя проекта. Это значение учитывает регистр.	`myProject`
`{API-VERSION}`	Версия вызываемого API.	`2023-04-01`

Заголовки

Используйте следующий заголовок для проверки подлинности запроса.

Ключ	значение
`Ocp-Apim-Subscription-Key`	Ключ к вашему ресурсу. Используется для проверки подлинности запросов API.

После отправки запроса API вы получите ответ 202, подтверждающий успешное выполнение, что означает удаление вашего проекта.

Следующие шаги

Создание схемы

Поделиться через

Создание проектов в рабочем процессе оркестрации

Предварительные условия

Создание языкового ресурса

Создание ресурса на портале Azure

Создание нового языкового ресурса из Студии языка

Создать проект рабочего процесса оркестрации

Запросить URL-адрес

Заголовки

Содержимое

Импорт проекта рабочего процесса оркестрации

Запросить URL-адрес

Заголовки

Содержание

Экспорт проекта

Запросить URL-адрес

Заголовки

Получите информацию о проекте оркестрации

Заголовки

Содержимое ответа

Удаление проекта

Запросить URL-адрес

Заголовки

Следующие шаги

Обратная связь

Дополнительные ресурсы

Поделиться через

Создание проектов в рабочем процессе оркестрации

Предварительные условия

Создание языкового ресурса

Создание ресурса на портале Azure

Создание нового языкового ресурса из Студии языка

Вход в Language Studio

Создать проект рабочего процесса оркестрации

Импорт проекта рабочего процесса оркестрации

Экспорт проекта

Получите информацию о проекте оркестрации

Удаление проекта

Следующие шаги

Обратная связь

Дополнительные ресурсы