Examples - Batch

Serviço:

Azure AI Services

Versão da API:

2.0

Adiciona um lote de expressões de exemplo rotuladas a uma versão do aplicativo.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
appId	path	True	string (uuid)	O ID do aplicativo.
Endpoint	path	True	string	Pontos de extremidade de Serviços Cognitivos suportados (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	O ID da versão.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Corpo do Pedido

Name	Tipo	Description
exampleLabelObjectArray	ExampleLabelObject[]	Matriz de enunciados de exemplo.

Respostas

Name	Tipo	Description
201 Created	BatchLabelExample[]	Uma matriz de cadeia de caracteres determinando quais expressões de exemplo rotuladas foram adicionadas 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

Pedido de amostra

HTTP

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 da amostra

Código de estado:

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 estado:

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

Name	Description
BatchLabelExample	Resposta ao adicionar um lote de expressões de exemplo rotuladas.
EntityLabelObject	Define o tipo de entidade e a posição da entidade extraída dentro do 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

Object

Resposta ao adicionar um lote de expressões de exemplo rotuladas.

Name	Tipo	Description
error	OperationStatus	Resposta de um status de operação.
hasError	boolean
value	LabelExampleResponse	Resposta ao adicionar um enunciado de exemplo rotulado.

EntityLabelObject

Object

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

Name	Tipo	Description
endCharIndex	integer	O índice dentro do enunciado onde termina a entidade extraída.
entityName	string	O tipo de entidade.
role	string	O papel da entidade dentro do enunciado.
startCharIndex	integer	O índice dentro do enunciado onde a entidade extraída começa.

ErrorResponse

Object

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

Name	Tipo	Description
errorType	string

ExampleLabelObject

Object

Um enunciado de exemplo rotulado.

Name	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 enunciado do exemplo.

LabelExampleResponse

Object

Resposta ao adicionar um enunciado de exemplo rotulado.

Name	Tipo	Description
ExampleId	integer (int64)	O ID de exemplo recém-criado.
UtteranceText	string	O enunciado do exemplo.

OperationStatus

Object

Resposta de um status de operação.

Name	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