오케스트레이션 워크플로에서 프로젝트를 만드는 방법

오케스트레이션 워크플로를 사용하면 애플리케이션을 다음 항목에 연결하는 프로젝트를 만들 수 있습니다.

• 사용자 지정 Language Understanding
• 질문 답변
• LUIS

필수 조건

오케스트레이션 워크플로 사용을 시작하기 전에 다음과 같은 몇 가지 기능이 있어야 합니다.

• Azure 구독 – 체험 구독을 만듭니다.
• Foundry Tools 리소스의 Azure 언어

언어 리소스 만들기

오케스트레이션 워크플로 사용을 시작하기 전에 언어 리소스가 필요합니다.

Azure Portal에서 새 리소스 만들기

1. Azure Portal로 이동하여 Foundry Tools 리소스에서 새 Azure 언어를 만듭니다.

2. 계속하여 리소스 만들기 선택

3. 다음 세부 정보를 사용하여 언어 리소스를 만듭니다.

   인스턴스 세부 정보	필수 값
   지역	지원되는 지역 중 하나입니다.
   이름	언어 리소스의 이름입니다.
   가격 책정 계층	지원되는 가격 책정 계층 중 하나입니다.

오케스트레이션 워크플로 프로젝트 만들기(REST API)

일단 언어 리소스가 생성되면 오케스트레이션 워크플로 프로젝트를 만듭니다.

다음 URL, 헤더 및 JSON 본문을 사용하여 PATCH 요청을 제출하여 새 프로젝트를 만듭니다.

요청 URL

API 요청을 만들 때 다음 URL을 사용합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

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

헤더

다음 헤더를 사용하여 요청을 인증합니다.

본문

다음 샘플 JSON을 본문으로 사용합니다.

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

오케스트레이션 워크플로 프로젝트 가져오기(REST API)

오케스트레이션 워크플로 JSON을 서비스로 가져올 수 있습니다.

다음 URL, 헤더 및 JSON 본문을 사용하여 POST 요청을 제출하여 프로젝트를 가져옵니다.

요청 URL

API 요청을 만들 때 다음 URL을 사용합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

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

헤더

다음 헤더를 사용하여 요청을 인증합니다.

본문

다음 샘플 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"
      }
    ]
  }
}

프로젝트 내보내기(REST API)

언제든지 오케스트레이션 워크플로 프로젝트를 JSON 파일로 내보낼 수 있습니다.

다음 URL, 헤더, JSON 본문을 사용하여 POST 요청을 만들어 프로젝트를 내보냅니다.

요청 URL

API 요청을 만들 때 다음 URL을 사용합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

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

헤더

다음 헤더를 사용하여 요청을 인증합니다.

API 요청을 보내면 성공을 나타내는 응답을 받게 됩니다 202 . 응답 헤더에서 다음과 같이 형식이 operation-location 지정된 값을 추출합니다.

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

이 작업은 비동기식이므로 JOB-ID은 요청을 식별하는 데 사용됩니다. 이 URL을 사용하여 동일한 인증 방법을 사용하여 내보낸 프로젝트 JSON을 가져옵니다.

오케스트레이션 프로젝트 세부 정보 가져오기(REST API)

오케스트레이션 워크플로 프로젝트의 세부 정보를 가져오려면 다음 URL 및 헤더를 사용하여 GET 요청을 제출합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

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

헤더

다음 헤더를 사용하여 요청을 인증합니다.

응답 본문

요청을 보내면 다음 응답이 표시됩니다.

{
  "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 요청을 보내면 프로젝트 세부 정보가 포함된 성공 및 JSON 응답 본문을 나타내는 응답을 받게 됩니다 200 .

프로젝트 삭제(REST API)

프로젝트가 더 이상 필요하지 않은 경우 API를 사용하여 프로젝트를 삭제할 수 있습니다.

다음 URL, 헤더 및 JSON 본문을 사용하여 DELETE 요청을 만들어 대화형 언어 이해 프로젝트를 삭제합니다.

요청 URL

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

헤더

다음 헤더를 사용하여 요청을 인증합니다.

API 요청을 보내면 성공을 나타내는 응답을 받게 202 됩니다. 즉, 프로젝트가 삭제됩니다.

다음 단계

스키마 빌드