다음을 통해 공유


대화형 언어 이해 통합을 위한 엔터티 등록

이 문서에서는 Copilot Studio 에이전트에 대화형 언어 이해(CLU) 엔터티를 추가하는 방법에 대해 설명합니다. 대부분의 경우 프로젝트에 Copilot Studio 미리 빌드된 엔터티 를 사용할 수 있습니다. CLU 엔터티를 사용하려면 다음을 수행합니다.

  • 다음 데이터 형식의 CLU 엔터티를 미리 빌드된 해당 엔터티에 직접 매핑할 수 있습니다.

    • BooleanDatatype: Choice.Boolean
    • StringDatatype: Geography.Location, Regex, List, General.Event, General.Organization, IP Address, Person.Name, Phone Number, URL
    • NumberDatatype: Number

    노트

    복합 엔터티(여러 구성 요소가 있는 엔터티)는 StringDatatype에 매핑됩니다.

  • 사용자 지정 JSON 확인을 사용하는 CLU 엔터티의 경우 샘플 JSON 코드를 사용하여 이러한 외부 엔터티 를 에이전트에 등록할 수 있습니다. 이러한 엔터티는 복잡한 데이터 유형으로 변환됩니다. 관련 엔터티에 대해 이 문서의 JSON 코드 블록을 복사하여 붙여넣어 CLU 엔터티를 Copilot Studio 데이터 형식에 수동으로 매핑할 수 있습니다.

자세한 내용은 Power Fx 설명서의 데이터 형식 및 Azure AI 언어 설명서에서 미리 빌드된 지원되는 엔터티 구성 요소를 참조하세요.

나이

{
    "unit": "Year",
    "value": 10
}

통화

{
    "unit": "Egyptian pound",
    "ISO4217": "EGP",
    "value": 30
}

Temperature

{
    "unit": "Fahrenheit",
    "value": 88
}

서수

{
    "offset": "3",
    "relativeTo": "Start",
    "value": "3"
}

차원

{
    "unit": "KilometersPerHour",
    "value": 24
}

날짜 및 시간 엔터티 형식

Datetime 는 사용자 입력에 따라 반환된 해상도를 변경하는 특수 엔터티 형식입니다.

다음 예제에서는 다양한 형식의 날짜 및 시간 발화에 대한 엔터티를 정의하는 방법을 보여 줍니다. 에이전트 사용자가 예상하는 입력 유형에 따라 이러한 예제에 따라 고유한 매핑을 만들 수 있습니다.

Date

입력 예: 1995년 1월 1일

{
    "dateTimeSubKind": "Date",
    "timex": "1995-01-01",
    "value": "1995-01-01"
}

날짜/시간(연)

입력 예: 4월 12일에 돌아올게요

{
    "dateTimeSubKind": "Date",
    "timex": "XXXX-04-12",
    "value": "2022-04-12"
}

DatetimeRange(기간)

입력 예: 9월 3일에서 12일 사이에 자리를 비웁니다

{
    "resolutionKind": "TemporalSpan",
    "timex": "(XXXX-09-03,XXXX-09-12,P9D)",
    "duration": "P9D",
    "begin": "2022-09-03",
    "end": "2022-09-12"
}

DatetimeRange(세트)

입력 예: 매주 화요일

{ 
    "resolutionKind": "DateTime",
    "dateTimeSubKind": "Set",
    "timex": "XXXX-WXX-2",
    "value": "not resolved"
}

날짜/시간(이후)

입력 예: 8월부터 자리를 비웁니다

{
    "resolutionKind": "TemporalSpan",
    "timex": "XXXX-08",
    "begin": "2022-08-01",
    "modifier": "Since"
}

시간

입력 예: 7시 반입니다

{
    "resolutionKind": "DateTime",
    "dateTimeSubKind": "Time",
    "timex": "T07:30",
    "value": "07:30:00"
}