Compartir a través de

Examples - Batch

  • Referencia
Servicio:
Azure AI Services
Versión de la API:
2.0

Agrega un lote de expresiones de ejemplo etiquetadas a una versión de la aplicación.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
appId
 path True

string (uuid)

Identificador de la aplicación.
Endpoint
 path True

string

Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).
versionId
 path True

string

Identificador de versión.

Encabezado de la solicitud

Nombre Requerido Tipo Description
Ocp-Apim-Subscription-Key True

string

Cuerpo de la solicitud

Nombre Tipo Description
exampleLabelObjectArray

ExampleLabelObject[]

Matriz de expresiones de ejemplo.

Respuestas

Nombre Tipo Description
201 Created

BatchLabelExample[]

Matriz de cadenas que determina qué expresiones de ejemplo etiquetadas se agregaron correctamente.
Other Status Codes

BatchLabelExample[]

Indica que la solicitud se realizó correctamente parcialmente. La respuesta contiene una matriz de cadenas que indica el estado de cada una de las expresiones de ejemplo etiquetadas agregadas.
Other Status Codes

ErrorResponse

Respuesta de error.

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ejemplos

Successful Batch Add Labels request

Solicitud de ejemplo

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"
  }
]

Respuesta de muestra

status code:
201 
[
  {
    "value": {
      "UtteranceText": "whats the weather in seattle?",
      "ExampleId": -728104
    },
    "hasError": false
  },
  {
    "value": {
      "UtteranceText": "whats the weather in buenos aires?",
      "ExampleId": -5313943
    },
    "hasError": false
  }
]
status code:
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
  }
]

Definiciones

Nombre Description
BatchLabelExample

Respuesta al agregar un lote de expresiones de ejemplo etiquetadas.
EntityLabelObject

Define el tipo de entidad y la posición de la entidad extraída en el ejemplo.
ErrorResponse

Respuesta de error al invocar una operación en la API.
ExampleLabelObject

Expresión de ejemplo etiquetada.
LabelExampleResponse

Respuesta al agregar una expresión de ejemplo etiquetada.
OperationStatus

Respuesta de un estado de operación.
OperationStatusType

Código de estado.

BatchLabelExample

Object

Respuesta al agregar un lote de expresiones de ejemplo etiquetadas.

Nombre Tipo Description
error

OperationStatus

Respuesta de un estado de operación.
hasError

boolean

value

LabelExampleResponse

Respuesta al agregar una expresión de ejemplo etiquetada.

EntityLabelObject

Object

Define el tipo de entidad y la posición de la entidad extraída en el ejemplo.

Nombre Tipo Description
endCharIndex

integer

Índice dentro de la expresión donde finaliza la entidad extraída.
entityName

string

Tipo de entidad.
role

string

Rol de la entidad dentro de la expresión.
startCharIndex

integer

Índice dentro de la expresión donde se inicia la entidad extraída.

ErrorResponse

Object

Respuesta de error al invocar una operación en la API.

Nombre Tipo Description
errorType

string

ExampleLabelObject

Object

Expresión de ejemplo etiquetada.

Nombre Tipo Description
entityLabels

EntityLabelObject[]

Las entidades identificadas dentro de la expresión de ejemplo.
intentName

string

Intención identificada que representa la expresión de ejemplo.
text

string

Expresión de ejemplo.

LabelExampleResponse

Object

Respuesta al agregar una expresión de ejemplo etiquetada.

Nombre Tipo Description
ExampleId

integer (int64)

Identificador de ejemplo recién creado.
UtteranceText

string

Expresión de ejemplo.

OperationStatus

Object

Respuesta de un estado de operación.

Nombre Tipo Description
code

OperationStatusType

Código de estado.
message

string

Detalles del estado.

OperationStatusType

Enumeración

Código de estado.

Valor Description
FAILED
Failed
Success