Versions - Import

Servizio:: Azure AI Services

Versione API:: 2.0

Importa una nuova versione in un'applicazione LUIS.

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

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
appId	path	True	string (uuid)	ID applicazione.
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).
versionId	query		string	Nuovo versionId da importare. Se non specificato, il valore versionId verrà letto dall'oggetto importato.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string

Corpo della richiesta

Nome	Tipo	Descrizione
closedLists	ClosedList[]	Elenco di entità elenco.
composites	HierarchicalModel[]	Elenco di entità composite.
culture	string	Impostazioni cultura dell'applicazione. Ad esempio: en-us.
desc	string	Descrizione dell'applicazione.
entities	HierarchicalModel[]	Elenco di entità.
intents	HierarchicalModel[]	Elenco di finalità.
model_features	JSONModelFeature[]	Elenco delle funzionalità del modello.
name	string	Nome dell'applicazione.
patternAnyEntities	PatternAny[]	Elenco di entità Pattern.Any.
patterns	PatternRule[]	Elenco di modelli.
prebuiltEntities	PrebuiltEntity[]	Elenco di entità predefinite.
regex_entities	RegexEntity[]	Elenco di entità di espressioni regolari.
regex_features	JSONRegexFeature[]	Elenco delle funzionalità del modello.
utterances	JSONUtterance[]	Elenco di espressioni di esempio.
versionId	string	ID versione dell'applicazione esportata.

Risposte

Nome	Tipo	Descrizione
201 Created	string	Versione dell'applicazione creata.
Other Status Codes	ErrorResponse	Risposta errore.

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

Esempio

Successful Import Application

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 201

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

"0.2"

Definizioni

Nome	Descrizione
ClosedList	Modello esportato: entità elenco.
ErrorResponse	Risposta di errore quando si richiama un'operazione sull'API.
HierarchicalModel
JSONEntity	Modello esportato: entità estratta dall'espressione.
JSONModelFeature	Modello esportato - Funzionalità del modello phraselist.
JSONRegexFeature	Modello esportato: funzionalità modello.
JSONUtterance	Modello esportato: espressione usata per eseguire il training del modello.
LuisApp	Modello esportato: applicazione LUIS esportata.
PatternAny	Estrattore di entità Pattern.Any.
PatternRule	Modello
PrebuiltDomainObject
PrebuiltEntity	Estrattore entità predefinito.
RegexEntity	Estrattore di entità dell'espressione regolare.
SubClosedList	Sottolista di elementi per un'entità elenco.

ClosedList

Object

Modello esportato: entità elenco.

Nome	Tipo	Descrizione
name	string	Nome dell'entità elenco.
roles	string[]
subLists	SubClosedList[]	Sottoliste per l'entità elenco.

ErrorResponse

Object

Risposta di errore quando si richiama un'operazione sull'API.

Nome	Tipo	Descrizione
errorType	string

HierarchicalModel

Object

Nome	Tipo	Descrizione
children	string[]
inherits	PrebuiltDomainObject
name	string
roles	string[]

JSONEntity

Object

Modello esportato: entità estratta dall'espressione.

Nome	Tipo	Descrizione
endPos	integer	Indice all'interno dell'espressione in cui termina l'entità estratta.
entity	string	Nome dell'entità.
role	string	Ruolo dell'entità all'interno dell'espressione.
startPos	integer	Indice all'interno dell'espressione in cui inizia l'entità estratta.

JSONModelFeature

Object

Modello esportato - Funzionalità del modello phraselist.

Nome	Tipo	Descrizione
activated	boolean	Indica se la funzionalità è abilitata.
mode	boolean	Una funzionalità di elenco di frasi intercambiabili funge da elenco di sinonimi per il training. Un elenco di frasi non scambiabili funge da funzionalità separate per il training. Pertanto, se l'elenco di frasi non intercambiabili contiene 5 frasi, verrà eseguito il mapping a 5 funzionalità separate. È possibile considerare l'elenco di frasi non intercambiabili come un contenitore aggiuntivo di parole da aggiungere alle funzionalità del vocabolario esistente di LUIS. Viene usato come funzione di ricerca lessico in cui il valore è 1 se il lessico contiene una determinata parola o 0 in caso contrario. Il valore predefinito è vero.
name	string	Nome dell'elenco di frasi.
words	string	Elenco di frasi separate da virgole che rappresentano l'elenco di frasi.

JSONRegexFeature

Object

Modello esportato: funzionalità modello.

Nome	Tipo	Descrizione
activated	boolean	Indica se la funzionalità Pattern è abilitata.
name	string	Nome della funzionalità.
pattern	string	Espressione regolare da trovare.

JSONUtterance

Object

Modello esportato: espressione usata per eseguire il training del modello.

Nome	Tipo	Descrizione
entities	JSONEntity[]	Entità corrispondenti.
intent	string	Finalità corrispondente.
text	string	Espressione.

LuisApp

Object

Modello esportato: applicazione LUIS esportata.

Nome	Tipo	Descrizione
closedLists	ClosedList[]	Elenco di entità elenco.
composites	HierarchicalModel[]	Elenco di entità composite.
culture	string	Impostazioni cultura dell'applicazione. Ad esempio: en-us.
desc	string	Descrizione dell'applicazione.
entities	HierarchicalModel[]	Elenco di entità.
intents	HierarchicalModel[]	Elenco di finalità.
model_features	JSONModelFeature[]	Elenco delle funzionalità del modello.
name	string	Nome dell'applicazione.
patternAnyEntities	PatternAny[]	Elenco di entità Pattern.Any.
patterns	PatternRule[]	Elenco di modelli.
prebuiltEntities	PrebuiltEntity[]	Elenco di entità predefinite.
regex_entities	RegexEntity[]	Elenco di entità di espressioni regolari.
regex_features	JSONRegexFeature[]	Elenco delle funzionalità del modello.
utterances	JSONUtterance[]	Elenco di espressioni di esempio.
versionId	string	ID versione dell'applicazione esportata.

PatternAny

Object

Estrattore di entità Pattern.Any.

Nome	Tipo	Descrizione
explicitList	string[]
name	string
roles	string[]

PatternRule

Object

Modello

Nome	Tipo	Descrizione
intent	string	Nome della finalità a cui appartiene il modello.
pattern	string	Testo del pattern.

PrebuiltDomainObject

Object

Nome	Tipo	Descrizione
domain_name	string
model_name	string

PrebuiltEntity

Object

Estrattore entità predefinito.

Nome	Tipo	Descrizione
name	string
roles	string[]

RegexEntity

Object

Estrattore di entità dell'espressione regolare.

Nome	Tipo	Descrizione
name	string
regexPattern	string
roles	string[]

SubClosedList

Object

Sottolista di elementi per un'entità elenco.

Nome	Tipo	Descrizione
canonicalForm	string	Modulo standard rappresentato dall'elenco.
list	string[]	Elenco di parole sinonimi.

Condividi tramite

Versions - Import

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

Esempio

Successful Import Application

Esempio di richiesta

Risposta di esempio

Definizioni

ClosedList

ErrorResponse

HierarchicalModel

JSONEntity

JSONModelFeature

JSONRegexFeature

JSONUtterance

LuisApp

PatternAny

PatternRule

PrebuiltDomainObject

PrebuiltEntity

RegexEntity

SubClosedList