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

Статья
11/21/2024

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

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

Необходимые компоненты

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

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

Создание ресурса Языковой службы

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

Примечание.

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

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

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

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

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

Создание ресурса Языка из Студии Языка

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

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

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

Внимание

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

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

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

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

Language Studio
REST API;

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

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

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

Отправьте запрос 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, означающий успешное выполнение (развертывание удалено).

Next Steps

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

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

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

Необходимые компоненты

Создание ресурса Языковой службы

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

Создание ресурса Языка из Студии Языка

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

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

Заголовки

Текст

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

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

Заголовки

Текст

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

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

Заголовки

Получение сведений о проекте оркестрации

Заголовки

Текст ответа

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

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

Заголовки

Next Steps

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

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

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

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

Необходимые компоненты

Создание ресурса Языковой службы

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

Создание ресурса Языка из Студии Языка

Вход в Language Studio

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

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

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

Получение сведений о проекте оркестрации

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

Next Steps

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

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