Apps - Import

Riferimento

Service:: Cognitive Services - LUIS

API Version:: 2.0

Importa un'applicazione in LUIS, la struttura dell'applicazione è inclusa nel corpo della richiesta.

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

With optional parameters:

POST {Endpoint}/luis/api/v2.0/apps/import?appName={appName}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).
appName	query		string	Nome dell'applicazione da creare. Se non specificato, il nome dell'applicazione verrà letto dall'oggetto importato. Se il nome dell'applicazione esiste già, viene restituito un errore.

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à composte.
culture	string	Impostazioni cultura dell'applicazione. Ad esempio: en-us.
desc	string	Descrizione dell'applicazione.
entities	HierarchicalModel[]	Elenco di entità.
intents	HierarchicalModel[]	Elenco delle 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	ID dell'applicazione importata.
Other Status Codes	ErrorResponse	Risposta errore.

Sicurezza

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Esempio

Successful Import Application

Sample Request

HTTP

POST {Endpoint}/luis/api/v2.0/apps/import?appName=Test LUIS App


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

Sample Response

Status code:: 201

Location: https://westus.api.cognitive.microsoft.com/luis/api/v2.0/apps/374fac89-ae12-4afd-8c21-8a6424ce1c1f

Response Body

"374fac89-ae12-4afd-8c21-8a6424ce1c1f"

Definizioni

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

ClosedList

Modello esportato: entità elenco.

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

ErrorResponse

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

Nome	Tipo	Descrizione
errorType	string

HierarchicalModel

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

JSONEntity

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 viene avviata l'entità estratta.

JSONModelFeature

Modello esportato - Funzionalità modello fraselista.

Nome	Tipo	Descrizione
activated	boolean	Indica se la funzionalità è abilitata.
mode	boolean	Una funzionalità di elenco frasi interscambiabili funge da elenco di sinonimi per il training. Un elenco di frasi non scambiabili funge da funzionalità separate per il training. Quindi, se l'elenco di frasi non interscambiabili contiene 5 frasi, verranno mappate a 5 funzionalità separate. È possibile pensare all'elenco di frasi non interscambiabili come una borsa aggiuntiva di parole da aggiungere alle funzionalità del vocabolario esistente di LUIS. Viene usato come funzionalità di ricerca del lessico in cui il relativo valore è 1 se il lessico contiene una parola specifica o 0 se non lo fa. Il valore predefinito è true.
name	string	Nome dell'elenco di frasi.
words	string	Elenco di frasi separate da virgole che rappresentano l'elenco di frasi.

JSONRegexFeature

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 corrispondere.

JSONUtterance

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

Modello esportato: un'applicazione LUIS esportata.

Nome	Tipo	Descrizione
closedLists	ClosedList[]	Elenco di entità elenco.
composites	HierarchicalModel[]	Elenco di entità composte.
culture	string	Impostazioni cultura dell'applicazione. Ad esempio: en-us.
desc	string	Descrizione dell'applicazione.
entities	HierarchicalModel[]	Elenco di entità.
intents	HierarchicalModel[]	Elenco delle 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

Pattern.Any Entity Extractor.

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

PatternRule

Modello

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

PrebuiltDomainObject

Nome	Tipo	Descrizione
domain_name	string
model_name	string

PrebuiltEntity

Estrattore di entità predefinito.

Nome	Tipo	Descrizione
name	string
roles	string[]

RegexEntity

Estrattore di entità espressione regolare.

Nome	Tipo	Descrizione
name	string
regexPattern	string
roles	string[]

SubClosedList

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