Versions - Import

Dienst:: Azure AI Services

API-Version:: 2.0

Importiert eine neue Version in eine LUIS-Anwendung.

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

Mit optionalen Parametern:

POST {Endpoint}/luis/api/v2.0/apps/{appId}/versions/import?versionId={versionId}

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	query		string	Die neue versionId, die importiert werden soll. Wenn nicht angegeben, wird die versionId aus dem importierten Objekt gelesen.

Anforderungsheader

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

Anforderungstext

Name	Typ	Beschreibung
closedLists	ClosedList[]	Liste der Listenentitäten.
composites	HierarchicalModel[]	Liste der zusammengesetzten Entitäten.
culture	string	Die Kultur der Anwendung. Z.B.: en-us.
desc	string	Die Beschreibung der Anwendung.
entities	HierarchicalModel[]	Liste der Entitäten.
intents	HierarchicalModel[]	Liste der Absichten.
model_features	JSONModelFeature[]	Liste der Modellfeatures.
name	string	Der Name der Anwendung.
patternAnyEntities	PatternAny[]	Liste der "Pattern.Any"-Entitäten.
patterns	PatternRule[]	Liste der Muster.
prebuiltEntities	PrebuiltEntity[]	Liste der vordefinierten Entitäten.
regex_entities	RegexEntity[]	Liste der Entitäten regulärer Ausdrücke.
regex_features	JSONRegexFeature[]	Liste der Musterfeatures.
utterances	JSONUtterance[]	Liste der Beispiel-Äußerungen.
versionId	string	Die Versions-ID der Anwendung, die exportiert wurde.

Antworten

Name	Typ	Beschreibung
201 Created	string	Die erstellte Anwendungsversion.
Other Status Codes	ErrorResponse	Fehlerantwort.

Sicherheit

Ocp-Apim-Subscription-Key

Typ: apiKey
In: header

Beispiele

Successful Import Application

Beispielanforderung

HTTP

POST {Endpoint}/luis/api/v2.0/apps/bd72e8d7-62b8-48f5-9dcb-e3b0588b803a/versions/import?versionId=0.2


{
  "luis_schema_version": "3.0.0",
  "versionId": "0.1",
  "name": "LuisBot",
  "desc": "",
  "culture": "en-us",
  "intents": [
    {
      "name": "HomeAutomation.TurnOff",
      "inherits": {
        "domain_name": "HomeAutomation",
        "model_name": "TurnOff"
      }
    },
    {
      "name": "dateintent"
    },
    {
      "name": "Help"
    },
    {
      "name": "None"
    },
    {
      "name": "SearchHotels"
    },
    {
      "name": "ShowHotelsReviews"
    }
  ],
  "entities": [
    {
      "name": "AirportCode",
      "roles": [
        "destination"
      ]
    },
    {
      "name": "Hotel",
      "roles": []
    }
  ],
  "composites": [],
  "closedLists": [],
  "patternAnyEntities": [
    {
      "name": "patternAny1",
      "explicitList": [],
      "roles": [
        "role1",
        "role2"
      ]
    }
  ],
  "regex_entities": [
    {
      "name": "regex1",
      "regexPattern": "[^a]+",
      "roles": [
        "regex role"
      ]
    }
  ],
  "prebuiltEntities": [
    {
      "name": "datetimeV2",
      "roles": [
        "datetime role"
      ]
    }
  ],
  "model_features": [
    {
      "name": "Near",
      "mode": true,
      "words": "near,around,close,nearby",
      "activated": true
    },
    {
      "name": "Show",
      "mode": true,
      "words": "show,find,look,search",
      "activated": true
    }
  ],
  "regex_features": [
    {
      "name": "AirportCodeRegex",
      "pattern": "[a-z]{3}",
      "activated": true
    }
  ],
  "patterns": [
    {
      "pattern": "this is [a test] {patternAny1:role1}",
      "intent": "Help"
    }
  ],
  "utterances": [
    {
      "text": "i need help",
      "intent": "Help",
      "entities": []
    },
    {
      "text": "help me",
      "intent": "Help",
      "entities": []
    },
    {
      "text": "tomorrow",
      "intent": "dateintent",
      "entities": []
    },
    {
      "text": "search for hotels in seattle",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "what can i do?",
      "intent": "Help",
      "entities": []
    },
    {
      "text": "next monday",
      "intent": "dateintent",
      "entities": []
    },
    {
      "text": "next year",
      "intent": "dateintent",
      "entities": []
    },
    {
      "text": "look for hotels in miami",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "show me hotels in california",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "show me the reviews of the amazing bot resort",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 23,
          "endPos": 44
        }
      ]
    },
    {
      "text": "can i see the reviews of extended bot hotel?",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 25,
          "endPos": 42
        }
      ]
    },
    {
      "text": "find reviews of hotelxya",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 16,
          "endPos": 23
        }
      ]
    },
    {
      "text": "show me reviews of the amazing hotel",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 19,
          "endPos": 35
        }
      ]
    },
    {
      "text": "what are the available options?",
      "intent": "Help",
      "entities": []
    },
    {
      "text": "best hotels in seattle",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "hotels in los angeles",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "can you show me hotels from los angeles?",
      "intent": "SearchHotels",
      "entities": []
    },
    {
      "text": "can you show me the reviews of the amazing resort & hotel",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 31,
          "endPos": 56
        }
      ]
    },
    {
      "text": "what are the reviews of the hotel bot framework?",
      "intent": "ShowHotelsReviews",
      "entities": [
        {
          "entity": "Hotel",
          "startPos": 24,
          "endPos": 46
        }
      ]
    },
    {
      "text": "find hotels near eze",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 17,
          "endPos": 19
        }
      ]
    },
    {
      "text": "where can i stay near nnn?",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 22,
          "endPos": 24
        }
      ]
    },
    {
      "text": "show hotels near att airport",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 17,
          "endPos": 19
        }
      ]
    },
    {
      "text": "find hotels near agl",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 17,
          "endPos": 19
        }
      ]
    },
    {
      "text": "find hotels around eze airport",
      "intent": "SearchHotels",
      "entities": [
        {
          "entity": "AirportCode",
          "startPos": 19,
          "endPos": 21
        }
      ]
    },
    {
      "text": "01/7",
      "intent": "dateintent",
      "entities": []
    }
  ]
}

Beispiel für eine Antwort

Statuscode:: 201

Location: https://westus.api.cognitive.microsoft.com/luis/api/v2.0/bd72e8d7-62b8-48f5-9dcb-e3b0588b803a/versions/0.2

"0.2"

Definitionen

Name	Beschreibung
ClosedList	Exportiertes Modell – Eine Listenentität.
ErrorResponse	Fehlerantwort beim Aufrufen eines Vorgangs in der API.
HierarchicalModel
JSONEntity	Exportiertes Modell – Extrahierte Entität aus Der Äußerung.
JSONModelFeature	Exportiertes Modell – Phraselist-Modellfeature.
JSONRegexFeature	Exportiertes Modell – Ein Musterfeature.
JSONUtterance	Exportiertes Modell – Utterance, das zum Trainieren des Modells verwendet wurde.
LuisApp	Exportiertes Modell – Eine exportierte LUIS-Anwendung.
PatternAny	Pattern.Any Entity Extractor.
PatternRule	Muster
PrebuiltDomainObject
PrebuiltEntity	Vordefinierter Objektextraktor.
RegexEntity	Regulärer Ausdrucksentitätsextraktionsmodul.
SubClosedList	Unterliste von Elementen für eine Listenentität.

ClosedList

Objekt

Exportiertes Modell – Eine Listenentität.

Name	Typ	Beschreibung
name	string	Name der Listenentität.
roles	string[]
subLists	SubClosedList[]	Unterlisten für die Listenentität.

ErrorResponse

Objekt

Fehlerantwort beim Aufrufen eines Vorgangs in der API.

Name	Typ	Beschreibung
errorType	string

HierarchicalModel

Objekt

Name	Typ	Beschreibung
children	string[]
inherits	PrebuiltDomainObject
name	string
roles	string[]

JSONEntity

Objekt

Exportiertes Modell – Extrahierte Entität aus Der Äußerung.

Name	Typ	Beschreibung
endPos	integer	Der Index innerhalb der Äußerung, in der die extrahierte Entität endet.
entity	string	Der Entitätsname.
role	string	Die Rolle der Entität innerhalb der Äußerung.
startPos	integer	Der Index innerhalb der Äußerung, in der die extrahierte Entität beginnt.

JSONModelFeature

Objekt

Exportiertes Modell – Phraselist-Modellfeature.

Name	Typ	Beschreibung
activated	boolean	Gibt an, ob das Feature aktiviert ist.
mode	boolean	Ein austauschbares Begriffslistenfeature dient als Liste von Synonymen für Schulungen. Eine nicht austauschbare Begriffsliste dient als separate Features für Schulungen. Wenn Ihre nicht austauschbare Begriffsliste also fünf Ausdrücke enthält, werden sie fünf separaten Features zugeordnet. Sie können sich die nicht austauschbare Begriffsliste als einen zusätzlichen Beutel von Wörtern vorstellen, um vorhandene Vokabularfeatures von LUIS hinzuzufügen. Es wird als Lexicon-Nachschlagefunktion verwendet, bei der sein Wert 1 ist, wenn das Lexikal ein bestimmtes Wort oder 0 enthält, wenn dies nicht der Grund ist. Der Standardwert ist wahr.
name	string	Der Name der Begriffsliste.
words	string	Liste der durch Kommas getrennten Ausdrücke, die die Phraselist darstellen.

JSONRegexFeature

Objekt

Exportiertes Modell – Ein Musterfeature.

Name	Typ	Beschreibung
activated	boolean	Gibt an, ob das Musterfeature aktiviert ist.
name	string	Name des Features.
pattern	string	Der reguläre Ausdruck, der übereinstimmen soll.

JSONUtterance

Objekt

Exportiertes Modell – Utterance, das zum Trainieren des Modells verwendet wurde.

Name	Typ	Beschreibung
entities	JSONEntity[]	Die übereinstimmenen Entitäten.
intent	string	Die übereinstimmene Absicht.
text	string	Die Äußerung.

LuisApp

Objekt

Exportiertes Modell – Eine exportierte LUIS-Anwendung.

Name	Typ	Beschreibung
closedLists	ClosedList[]	Liste der Listenentitäten.
composites	HierarchicalModel[]	Liste der zusammengesetzten Entitäten.
culture	string	Die Kultur der Anwendung. Z.B.: en-us.
desc	string	Die Beschreibung der Anwendung.
entities	HierarchicalModel[]	Liste der Entitäten.
intents	HierarchicalModel[]	Liste der Absichten.
model_features	JSONModelFeature[]	Liste der Modellfeatures.
name	string	Der Name der Anwendung.
patternAnyEntities	PatternAny[]	Liste der "Pattern.Any"-Entitäten.
patterns	PatternRule[]	Liste der Muster.
prebuiltEntities	PrebuiltEntity[]	Liste der vordefinierten Entitäten.
regex_entities	RegexEntity[]	Liste der Entitäten regulärer Ausdrücke.
regex_features	JSONRegexFeature[]	Liste der Musterfeatures.
utterances	JSONUtterance[]	Liste der Beispiel-Äußerungen.
versionId	string	Die Versions-ID der Anwendung, die exportiert wurde.

PatternAny

Objekt

Pattern.Any Entity Extractor.

Name	Typ	Beschreibung
explicitList	string[]
name	string
roles	string[]

PatternRule

Objekt

Muster

Name	Typ	Beschreibung
intent	string	Der Name des Intents, zu dem das Muster gehört.
pattern	string	Der Mustertext.

PrebuiltDomainObject

Objekt

Name	Typ	Beschreibung
domain_name	string
model_name	string

PrebuiltEntity

Objekt

Vordefinierter Objektextraktor.

Name	Typ	Beschreibung
name	string
roles	string[]

RegexEntity

Objekt

Regulärer Ausdrucksentitätsextraktionsmodul.

Name	Typ	Beschreibung
name	string
regexPattern	string
roles	string[]

SubClosedList

Objekt

Unterliste von Elementen für eine Listenentität.

Name	Typ	Beschreibung
canonicalForm	string	Das Standardformular, das die Liste darstellt.
list	string[]	Liste der Synonymwörter.

Freigeben über

Versions - Import

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

Ocp-Apim-Subscription-Key

Beispiele

Successful Import Application

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ClosedList

ErrorResponse

HierarchicalModel

JSONEntity

JSONModelFeature

JSONRegexFeature

JSONUtterance

LuisApp

PatternAny

PatternRule

PrebuiltDomainObject

PrebuiltEntity

RegexEntity

SubClosedList