Partilhar via

Examples - Batch

  • Referência
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

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