Compartilhar via

Examples - Batch

  • Referência
Serviço:
Azure AI Services
Versão da API:
2.0

Adiciona um lote de enunciados de exemplo rotulados a uma versão do aplicativo.

POST {Endpoint}/luis/api/v2.0/apps/{appId}/versions/{versionId}/examples

Parâmetros de URI

Nome Em Obrigatório Tipo Description
appId
 path True

string (uuid)

A ID do aplicativo.
Endpoint
 path True

string

Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).
versionId
 path True

string

A ID da versão.

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
Ocp-Apim-Subscription-Key True

string

Corpo da solicitação

Nome Tipo Description
exampleLabelObjectArray

ExampleLabelObject[]

Matriz de enunciados de exemplo.

Respostas

Nome Tipo Description
201 Created

BatchLabelExample[]

Uma matriz de cadeia de caracteres determinando quais enunciados de exemplo rotulados foram adicionados com êxito.
Other Status Codes

BatchLabelExample[]

Indica que a solicitação foi parcialmente bem-sucedida. A resposta contém uma matriz de cadeia de caracteres que indica o status de cada um dos enunciados de exemplo rotulados adicionados.
Other Status Codes

ErrorResponse

Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Successful Batch Add Labels request

Solicitação de exemplo

POST {Endpoint}/luis/api/v2.0/apps/2370fb9d-7dbc-4898-a361-a742cf290766/versions/0.1/examples


[
  {
    "text": "whats the weather in seattle?",
    "entityLabels": [
      {
        "entityName": "Place",
        "startCharIndex": 21,
        "endCharIndex": 29
      }
    ],
    "intentName": "WeatherInPlace"
  },
  {
    "text": "whats the weather in buenos aires?",
    "entityLabels": [
      {
        "entityName": "Place",
        "startCharIndex": 21,
        "endCharIndex": 34
      }
    ],
    "intentName": "WeatherInPlace"
  }
]

Resposta de exemplo

Código de status:
201 
[
  {
    "value": {
      "UtteranceText": "whats the weather in seattle?",
      "ExampleId": -728104
    },
    "hasError": false
  },
  {
    "value": {
      "UtteranceText": "whats the weather in buenos aires?",
      "ExampleId": -5313943
    },
    "hasError": false
  }
]
Código de status:
207 
[
  {
    "hasError": true,
    "error": {
      "code": "FAILED",
      "message": "whats the weather in seattle?. Error: The intent classifier InvalidIntent does not exist in the selected application"
    }
  },
  {
    "value": {
      "UtteranceText": "whats the weather in buenos aires?",
      "ExampleId": -5313943
    },
    "hasError": false
  }
]

Definições

Nome Description
BatchLabelExample

Resposta ao adicionar um lote de enunciados de exemplo rotulados.
EntityLabelObject

Define o tipo de entidade e a posição da entidade extraída no exemplo.
ErrorResponse

Resposta de erro ao invocar uma operação na API.
ExampleLabelObject

Um enunciado de exemplo rotulado.
LabelExampleResponse

Resposta ao adicionar um enunciado de exemplo rotulado.
OperationStatus

Resposta de um status de operação.
OperationStatusType

Código de status.

BatchLabelExample

Objeto

Resposta ao adicionar um lote de enunciados de exemplo rotulados.

Nome Tipo Description
error

OperationStatus

Resposta de um status de operação.
hasError

boolean

value

LabelExampleResponse

Resposta ao adicionar um enunciado de exemplo rotulado.

EntityLabelObject

Objeto

Define o tipo de entidade e a posição da entidade extraída no exemplo.

Nome Tipo Description
endCharIndex

integer

O índice dentro do enunciado em que a entidade extraída termina.
entityName

string

O tipo de entidade.
role

string

A função da entidade dentro do enunciado.
startCharIndex

integer

O índice dentro do enunciado em que a entidade extraída é iniciada.

ErrorResponse

Objeto

Resposta de erro ao invocar uma operação na API.

Nome Tipo Description
errorType

string

ExampleLabelObject

Objeto

Um enunciado de exemplo rotulado.

Nome Tipo Description
entityLabels

EntityLabelObject[]

As entidades identificadas no enunciado de exemplo.
intentName

string

A intenção identificada que representa o enunciado de exemplo.
text

string

O exemplo de enunciado.

LabelExampleResponse

Objeto

Resposta ao adicionar um enunciado de exemplo rotulado.

Nome Tipo Description
ExampleId

integer (int64)

A ID de exemplo recém-criada.
UtteranceText

string

O exemplo de enunciado.

OperationStatus

Objeto

Resposta de um status de operação.

Nome Tipo Description
code

OperationStatusType

Código de status.
message

string

Detalhes do status.

OperationStatusType

Enumeração

Código de status.

Valor Description
FAILED
Failed
Success