Versions - Export

Služba:: Azure AI Services

Verze rozhraní API:: 2.0

Exportuje aplikaci LUIS do formátu JSON.

GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions/{versionId}/export

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
appId	path	True	string (uuid)	ID aplikace.
Endpoint	path	True	string	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	ID verze.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string

Odpovědi

Name	Typ	Description
200 OK	LuisApp	Struktura aplikace LUIS ve formátu JSON.
Other Status Codes	ErrorResponse	Chybová odpověď.

Zabezpečení

Ocp-Apim-Subscription-Key

Typ: apiKey
V: header

Příklady

Successful Export Application Version

Ukázkový požadavek

HTTP

GET {Endpoint}/luis/api/v2.0/apps/bd72e8d7-62b8-48f5-9dcb-e3b0588b803a/versions/0.2/export

Ukázková odpověď

Stavový kód:: 200

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

Definice

Name	Description
ClosedList	Exportovaný model – entita seznamu
ErrorResponse	Chybová odpověď při vyvolání operace v rozhraní API
HierarchicalModel
JSONEntity	Exportovaný model – extrahovaná entita z promluvy
JSONModelFeature	Exportovaný model – funkce modelu frází
JSONRegexFeature	Exportovaný model – funkce vzoru
JSONUtterance	Exportovaný model – promluva použitá k trénování modelu
LuisApp	Exportovaný model – exportovaná aplikace LUIS
PatternAny	Pattern.Any extraktor entit.
PatternRule	Vzor
PrebuiltDomainObject
PrebuiltEntity	Předem připravený extraktor entity.
RegexEntity	Extraktor entity regulárního výrazu.
SubClosedList	Dílčí seznam položek pro entitu seznamu

ClosedList

Objekt

Exportovaný model – entita seznamu

Name	Typ	Description
name	string	Název entity seznamu
roles	string[]
subLists	SubClosedList[]	Podsestavy pro entitu seznamu

ErrorResponse

Objekt

Chybová odpověď při vyvolání operace v rozhraní API

Name	Typ	Description
errorType	string

HierarchicalModel

Objekt

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

JSONEntity

Objekt

Exportovaný model – extrahovaná entita z promluvy

Name	Typ	Description
endPos	integer	Index v promluvě, kde končí extrahovaná entita.
entity	string	Název entity.
role	string	Role entity v promluvě.
startPos	integer	Index v promluvě, kde začíná extrahovaná entita.

JSONModelFeature

Objekt

Exportovaný model – funkce modelu frází

Name	Typ	Description
activated	boolean	Označuje, jestli je funkce povolená.
mode	boolean	Funkce seznamu zaměnitelných frází slouží jako seznam synonym pro trénování. Seznam neměnitelných frází slouží jako samostatné funkce pro trénování. Pokud tedy seznam nezaměnitelných frází obsahuje 5 frází, budou namapovány na 5 samostatných funkcí. Seznam nezaměnitelných frází si můžete představit jako další tašku slov, která můžete přidat do stávajících funkcí slovníku LUIS. Používá se jako vyhledávací funkce lexikonu, kde jeho hodnota je 1, pokud lexikon obsahuje dané slovo nebo 0, pokud ne. Výchozí hodnota je true.
name	string	Název frází.
words	string	Seznam frází oddělených čárkami, které představují seznam frází

JSONRegexFeature

Objekt

Exportovaný model – funkce vzoru

Name	Typ	Description
activated	boolean	Označuje, jestli je povolená funkce Pattern.
name	string	Název funkce
pattern	string	Regulární výraz, který se má shodovat.

JSONUtterance

Objekt

Exportovaný model – promluva použitá k trénování modelu

Name	Typ	Description
entities	JSONEntity[]	Odpovídající entity.
intent	string	Odpovídající záměr.
text	string	Promluva.

LuisApp

Objekt

Exportovaný model – exportovaná aplikace LUIS

Name	Typ	Description
closedLists	ClosedList[]	Seznam entit seznamu
composites	HierarchicalModel[]	Seznam složených entit
culture	string	Jazyková verze aplikace. Např. en-us.
desc	string	Popis aplikace.
entities	HierarchicalModel[]	Seznam entit
intents	HierarchicalModel[]	Seznam záměrů
model_features	JSONModelFeature[]	Seznam funkcí modelu
name	string	Název aplikace.
patternAnyEntities	PatternAny[]	Seznam entit Pattern.Any
patterns	PatternRule[]	Seznam vzorů
prebuiltEntities	PrebuiltEntity[]	Seznam předem připravených entit
regex_entities	RegexEntity[]	Seznam entit regulárních výrazů
regex_features	JSONRegexFeature[]	Seznam funkcí vzorů
utterances	JSONUtterance[]	Seznam ukázkových promluv
versionId	string	ID verze aplikace, která byla exportována.

PatternAny

Objekt

Pattern.Any extraktor entit.

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

PatternRule

Objekt

Vzor

Name	Typ	Description
intent	string	Název záměru, do kterého vzor patří.
pattern	string	Vzorové texty.

PrebuiltDomainObject

Objekt

Name	Typ	Description
domain_name	string
model_name	string

PrebuiltEntity

Objekt

Předem připravený extraktor entity.

Name	Typ	Description
name	string
roles	string[]

RegexEntity

Objekt

Extraktor entity regulárního výrazu.

Name	Typ	Description
name	string
regexPattern	string
roles	string[]

SubClosedList

Objekt

Dílčí seznam položek pro entitu seznamu

Name	Typ	Description
canonicalForm	string	Standardní formulář, který seznam představuje.
list	string[]	Seznam slov synonym

Sdílet prostřednictvím

Versions - Export

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

Příklady

Successful Export Application Version

Ukázkový požadavek

Ukázková odpověď

Definice

ClosedList

ErrorResponse

HierarchicalModel

JSONEntity

JSONModelFeature

JSONRegexFeature

JSONUtterance

LuisApp

PatternAny

PatternRule

PrebuiltDomainObject

PrebuiltEntity

RegexEntity

SubClosedList