Partilhar via

Registo de entidade para integração de compreensão de linguagem conversacional

Este artigo aborda a adição de entidades de compreensão de linguagem conversacional (CLU) aos agentes do Copilot Studio. Na maioria dos casos, você pode usar entidades pré-criadas do Copilot Studio para seus projetos. Para usar entidades CLU:

  • Você pode mapear entidades CLU dos seguintes tipos de dados diretamente para as entidades pré-criadas correspondentes:

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

    Observação

    As entidades compostas (entidades com vários componentes) são mapeadas para StringDatatype.

  • Para entidades CLU com resoluções JSON personalizadas, você pode usar código JSON de exemplo para registrar essas entidades externas com seu agente. Estas entidades resolvem tipos de dados complexos. Você pode mapear manualmente entidades CLU para tipos de dados do Copilot Studio copiando e colando blocos de código JSON deste artigo para a entidade relevante.

Para obter mais informações, consulte Tipos de dados na documentação do Power Fx e Componentes de entidade pré-criados suportados na documentação da Linguagem Azure AI.

Antiguidade

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

Moeda

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

Temperatura

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

Ordinal

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

Dimensões

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

Tipos de entidade de data e hora

Datetime é um tipo de entidade especial que altera a resolução devolvida com base na entrada do utilizador.

Os exemplos a seguir mostram como definir entidades para diferentes tipos de declarações de data e hora. Dependendo do tipo de entrada que você espera dos usuários do seu agente, você pode criar seus próprios mapeamentos, com base nesses exemplos.

Date

Exemplo de entrada: 1 de janeiro de 1995

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

DateTime (ano)

Exemplo de entrada: Voltarei no dia 12 de abril

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

DatetimeRange (duração)

Exemplo de entrada: Estou fora entre 3 e 12 de setembro.

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

DatetimeRange (conjunto)

Exemplo de entrada: Todas as terças-feiras

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

Datetime (desde)

Exemplo de entrada: Estou fora desde agosto

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

Time

Exemplo de entrada: São sete e meia

{
    "resolutionKind": "DateTime",
    "dateTimeSubKind": "Time",
    "timex": "T07:30",
    "value": "07:30:00"
}
  • Last updated on