Partager via

Examples - Batch

  • Référence
Service:
Azure AI Services
Version d'API:
2.0

Ajoute un lot d’exemples d’énoncés étiquetés à une version de l’application.

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

Paramètres URI

Nom Dans Obligatoire Type Description
appId
 path True

string (uuid)

ID d’application.
Endpoint
 path True

string

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).
versionId
 path True

string

ID de version.

En-tête de la demande

Nom Obligatoire Type Description
Ocp-Apim-Subscription-Key True

string

Corps de la demande

Nom Type Description
exampleLabelObjectArray

ExampleLabelObject[]

Tableau d’exemples d’énoncés.

Réponses

Nom Type Description
201 Created

BatchLabelExample[]

Tableau de chaînes déterminant les exemples d’énoncés étiquetés qui ont été ajoutés avec succès.
Other Status Codes

BatchLabelExample[]

Indique que la demande a été partiellement réussie. La réponse contient un tableau de chaînes indiquant l’état de chacun des exemples d’énoncés étiquetés ajoutés.
Other Status Codes

ErrorResponse

Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Successful Batch Add Labels request

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
BatchLabelExample

Réponse lors de l’ajout d’un lot d’exemples d’énoncés étiquetés.
EntityLabelObject

Définit le type d’entité et la position de l’entité extraite dans l’exemple.
ErrorResponse

Réponse d’erreur lors de l’appel d’une opération sur l’API.
ExampleLabelObject

Exemple d’énoncé étiqueté.
LabelExampleResponse

Réponse lors de l’ajout d’un exemple d’énoncé étiqueté.
OperationStatus

Réponse d’un état d’opération.
OperationStatusType

Code d’état.

BatchLabelExample

Object

Réponse lors de l’ajout d’un lot d’exemples d’énoncés étiquetés.

Nom Type Description
error

OperationStatus

Réponse d’un état d’opération.
hasError

boolean

value

LabelExampleResponse

Réponse lors de l’ajout d’un exemple d’énoncé étiqueté.

EntityLabelObject

Object

Définit le type d’entité et la position de l’entité extraite dans l’exemple.

Nom Type Description
endCharIndex

integer

Index dans l’énoncé où se termine l’entité extraite.
entityName

string

Type d’entité.
role

string

Rôle de l’entité dans l’énoncé.
startCharIndex

integer

Index dans l’énoncé où l’entité extraite démarre.

ErrorResponse

Object

Réponse d’erreur lors de l’appel d’une opération sur l’API.

Nom Type Description
errorType

string

ExampleLabelObject

Object

Exemple d’énoncé étiqueté.

Nom Type Description
entityLabels

EntityLabelObject[]

Entités identifiées dans l’exemple d’énoncé.
intentName

string

Intention identifiée représentant l’exemple d’énoncé.
text

string

Exemple d’énoncé.

LabelExampleResponse

Object

Réponse lors de l’ajout d’un exemple d’énoncé étiqueté.

Nom Type Description
ExampleId

integer (int64)

L’ID d’exemple nouvellement créé.
UtteranceText

string

Exemple d’énoncé.

OperationStatus

Object

Réponse d’un état d’opération.

Nom Type Description
code

OperationStatusType

Code d’état.
message

string

Détails de l’état.

OperationStatusType

Énumération

Code d’état.

Valeur Description
FAILED
Failed
Success