Examples - Add

Dienst:

Azure AI Services

API-Version:

2.0

Fügt eine beschriftete Beispiel-Äußerung in einer Version der Anwendung hinzu.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
appId	path	True	string (uuid)	Die Anwendungs-ID.
Endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	Die Versions-ID.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string

Anforderungstext

Name	Typ	Beschreibung
entityLabels	EntityLabelObject[]	Die identifizierten Entitäten innerhalb der Beispiel-Äußerung.
intentName	string	Die identifizierte Absicht, die die Beispiel-Äußerung darstellt.
text	string	Die Beispiel-Äußerung.

Antworten

Name	Typ	Beschreibung
201 Created	LabelExampleResponse	Die ID der erstellten Beispiel-Äußerung.
Other Status Codes	ErrorResponse	Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Successful Add Label request

Beispielanforderung

HTTP

POST {Endpoint}/luis/api/v2.0/apps/86226c53-b7a6-416f-876b-226b2b5ab07b/versions/0.1/example


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

Beispiel für eine Antwort

Statuscode:

201

{
  "UtteranceText": "whats the weather in buenos aires?",
  "ExampleId": -11
}

Definitionen

Name	Beschreibung
EntityLabelObject	Definiert den Entitätstyp und die Position der extrahierten Entität im Beispiel.
ErrorResponse	Fehlerantwort beim Aufrufen eines Vorgangs in der API.
ExampleLabelObject	Ein beschriftetes Beispiel für die Äußerung.
LabelExampleResponse	Antwort beim Hinzufügen einer beschrifteten Beispiel-Äußerung.

EntityLabelObject

Objekt

Definiert den Entitätstyp und die Position der extrahierten Entität im Beispiel.

Name	Typ	Beschreibung
endCharIndex	integer	Der Index innerhalb der Äußerung, in der die extrahierte Entität endet.
entityName	string	Der Entitätstyp.
role	string	Die Rolle der Entität innerhalb der Äußerung.
startCharIndex	integer	Der Index innerhalb der Äußerung, in der die extrahierte Entität beginnt.

ErrorResponse

Objekt

Fehlerantwort beim Aufrufen eines Vorgangs in der API.

Name	Typ	Beschreibung
errorType	string

ExampleLabelObject

Objekt

Ein beschriftetes Beispiel für die Äußerung.

Name	Typ	Beschreibung
entityLabels	EntityLabelObject[]	Die identifizierten Entitäten innerhalb der Beispiel-Äußerung.
intentName	string	Die identifizierte Absicht, die die Beispiel-Äußerung darstellt.
text	string	Die Beispiel-Äußerung.

LabelExampleResponse

Objekt

Antwort beim Hinzufügen einer beschrifteten Beispiel-Äußerung.

Name	Typ	Beschreibung
ExampleId	integer (int64)	Die neu erstellte Beispiel-ID.
UtteranceText	string	Die Beispiel-Äußerung.