Versions - Import V2 App

Referentie

Service:: Azure AI Services

API-versie:: 3.0-preview

Hiermee importeert u een nieuwe versie in een LUIS-toepassing.

POST {Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/import

Met optionele parameters:

POST {Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/import?JsonVersion=V2&versionId={versionId}

URI-parameters

Name	In	Vereist	Type	Description
appId	path	True	string (uuid)	De toepassings-id.
Endpoint	path	True	string	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).
versionId	query		string	De nieuwe versionId die moet worden geïmporteerd. Als dit niet is opgegeven, wordt de versionId gelezen uit het geïmporteerde object.

Aanvraagkoptekst

Name	Vereist	Type	Description
Ocp-Apim-Subscription-Key	True	string

Aanvraagbody

Name	Type	Description
closedLists	ClosedList[]	Lijst met lijstentiteiten.
composites	HierarchicalModelV2[]	Lijst met samengestelde entiteiten.
culture	string	De cultuur van de toepassing. Bijvoorbeeld: en-us.
desc	string	De beschrijving van de toepassing.
entities	HierarchicalModelV2[]	Lijst met entiteiten.
intents	HierarchicalModelV2[]	Lijst met intenties.
luis_schema_version	string	Luis-schemadeserialisatieversie.
model_features	JSONModelFeature[]	Lijst met modelfuncties.
name	string	De naam van de toepassing.
patternAnyEntities	PatternAny[]	Lijst met Pattern.Any-entiteiten.
patterns	PatternRule[]	Lijst met patronen.
prebuiltEntities	PrebuiltEntity[]	Lijst met vooraf gedefinieerde entiteiten.
regex_entities	RegexEntity[]	Lijst met entiteiten voor reguliere expressies.
regex_features	JSONRegexFeature[]	Lijst met patroonfuncties.
utterances	JSONUtterance[]	Lijst met voorbeelduitingen.
versionId	string	De versie-id van de toepassing die is geëxporteerd.

Antwoorden

Name	Type	Description
201 Created	string	De gemaakte toepassingsversie.
Other Status Codes	ErrorResponse	Foutreactie.

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Voorbeelden

Successful Import Application

Voorbeeldaanvraag

HTTP

POST {Endpoint}/luis/authoring/v3.0-preview/apps/bd72e8d7-62b8-48f5-9dcb-e3b0588b803a/versions/import?JsonVersion=V2&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": []
    }
  ]
}

Voorbeeldrespons

Statuscode:: 201

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

"0.2"

Definities

Name	Description
ClosedList	Geëxporteerd model - een lijstentiteit.
ErrorResponse	Foutreactie bij het aanroepen van een bewerking op de API.
HierarchicalModelV2
JSONEntity	Geëxporteerd model- Uit utterance geëxtraheerde entiteit.
JSONModelFeature	Geëxporteerd model - Phraselist-modelfunctie.
JSONRegexFeature	Geëxporteerd model - Een patroonfunctie.
JSONUtterance	Geëxporteerd model - Utterance die is gebruikt om het model te trainen.
LuisAppV2	Geëxporteerd model - een geëxporteerde LUIS-toepassing.
PatternAny	Pattern.Any Entity Extractor.
PatternRule	Patroon
PrebuiltDomainObject
PrebuiltEntity	Vooraf gemaakte entiteitsextractor.
RegexEntity	Entiteitsextractor voor reguliere expressies.
SubClosedList	Sublijst met items voor een lijstentiteit.

ClosedList

Object

Geëxporteerd model - een lijstentiteit.

Name	Type	Description
name	string	Naam van de lijstentiteit.
roles	string[]
subLists	SubClosedList[]	Sublijsten voor de lijstentiteit.

ErrorResponse

Object

Foutreactie bij het aanroepen van een bewerking op de API.

Name	Type	Description
errorType	string

HierarchicalModelV2

Object

Name	Type	Description
children	string[]
inherits	PrebuiltDomainObject
name	string
roles	string[]

JSONEntity

Object

Geëxporteerd model- Uit utterance geëxtraheerde entiteit.

Name	Type	Description
children	JSONEntity[]	Geëxporteerd model- Uit utterance geëxtraheerde entiteit.
endPos	integer	De index binnen de uiting waar de geëxtraheerde entiteit eindigt.
entity	string	De naam van de entiteit.
role	string	De rol die de entiteit speelt in de uiting.
startPos	integer	De index binnen de uiting waar de geëxtraheerde entiteit wordt gestart.

JSONModelFeature

Object

Geëxporteerd model - Phraselist-modelfunctie.

Name	Type	Default value	Description
activated	boolean		Geeft aan of de functie is ingeschakeld.
enabledForAllModels	boolean	True	Geeft aan of de Phraselist is ingeschakeld voor alle modellen in de toepassing.
mode	boolean		Een uitwisselbare woordgroepenlijstfunctie fungeert als een lijst met synoniemen voor training. Een niet-uitwisselbare frasenlijst fungeert als afzonderlijke functies voor training. Als uw niet-uitwisselbare frasenlijst dus 5 zinnen bevat, worden deze toegewezen aan 5 afzonderlijke functies. U kunt de niet-uitwisselbare woordgroepenlijst beschouwen als een extra zak woorden om toe te voegen aan bestaande vocabulaire functies van LUIS. Het wordt gebruikt als een lexiconzoekfunctie waarbij de waarde 1 is als het lexicon een bepaald woord of 0 bevat als dat niet het enige is. De standaardwaarde is waar.
name	string		De naam van de woordgroepenlijst.
words	string		Lijst met door komma's gescheiden woordgroepen die de frasenlijst vertegenwoordigen.

JSONRegexFeature

Object

Geëxporteerd model - Een patroonfunctie.

Name	Type	Description
activated	boolean	Geeft aan of de patroonfunctie is ingeschakeld.
name	string	Naam van de functie.
pattern	string	De reguliere expressie die overeenkomt.

JSONUtterance

Object

Geëxporteerd model - Utterance die is gebruikt om het model te trainen.

Name	Type	Description
entities	JSONEntity[]	De overeenkomende entiteiten.
intent	string	De overeenkomende intentie.
text	string	De uiting.

LuisAppV2

Object

Geëxporteerd model - een geëxporteerde LUIS-toepassing.

Name	Type	Description
closedLists	ClosedList[]	Lijst met lijstentiteiten.
composites	HierarchicalModelV2[]	Lijst met samengestelde entiteiten.
culture	string	De cultuur van de toepassing. Bijvoorbeeld: en-us.
desc	string	De beschrijving van de toepassing.
entities	HierarchicalModelV2[]	Lijst met entiteiten.
intents	HierarchicalModelV2[]	Lijst met intenties.
luis_schema_version	string	Luis-schemadeserialisatieversie.
model_features	JSONModelFeature[]	Lijst met modelfuncties.
name	string	De naam van de toepassing.
patternAnyEntities	PatternAny[]	Lijst met Pattern.Any-entiteiten.
patterns	PatternRule[]	Lijst met patronen.
prebuiltEntities	PrebuiltEntity[]	Lijst met vooraf gedefinieerde entiteiten.
regex_entities	RegexEntity[]	Lijst met entiteiten voor reguliere expressies.
regex_features	JSONRegexFeature[]	Lijst met patroonfuncties.
utterances	JSONUtterance[]	Lijst met voorbeelduitingen.
versionId	string	De versie-id van de toepassing die is geëxporteerd.

PatternAny

Object

Pattern.Any Entity Extractor.

Name	Type	Description
explicitList	string[]
name	string
roles	string[]

PatternRule

Object

Patroon

Name	Type	Description
intent	string	De naam van de intentie waartoe het patroon behoort.
pattern	string	De patroontekst.

PrebuiltDomainObject

Object

Name	Type	Description
domain_name	string
model_name	string

PrebuiltEntity

Object

Vooraf gemaakte entiteitsextractor.

Name	Type	Description
name	string
roles	string[]

RegexEntity

Object

Entiteitsextractor voor reguliere expressies.

Name	Type	Description
name	string
regexPattern	string
roles	string[]

SubClosedList

Object

Sublijst met items voor een lijstentiteit.

Name	Type	Description
canonicalForm	string	Het standaardformulier dat de lijst vertegenwoordigt.
list	string[]	Lijst met synoniemenwoorden.

Delen via

Versions - Import V2 App

URI-parameters

Aanvraagkoptekst

Aanvraagbody

Antwoorden

Beveiliging

Ocp-Apim-Subscription-Key

Voorbeelden

Successful Import Application

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ClosedList

ErrorResponse

HierarchicalModelV2

JSONEntity

JSONModelFeature

JSONRegexFeature

JSONUtterance

LuisAppV2

PatternAny

PatternRule

PrebuiltDomainObject

PrebuiltEntity

RegexEntity

SubClosedList

Aanvullende resources