Versions - Import V2 App

Importuje nową wersję do aplikacji LUIS.

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

Parametry identyfikatora URI

Name In Required Type Description
appId
path True
  • string
uuid

Identyfikator aplikacji.

Endpoint
path True
  • string

Obsługiwane Cognitive Services punkty końcowe (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com) .

versionId
query
  • string

Nowy versionId do zaimportowania. Jeśli nie zostanie określony, versionId zostanie odczytany z zaimportowanego obiektu.

Nagłówek żądania

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Treść żądania

Name Type Description
closedLists

Lista jednostek listy.

composites

Lista jednostek złożonych.

culture
  • string

Kultura aplikacji. Np.: pl-US.

desc
  • string

Opis aplikacji.

entities

Lista jednostek.

intents

Lista intencji.

luis_schema_version
  • string

Wersja deserializacji schematu Luis.

model_features

Lista funkcji modelu.

name
  • string

Nazwa aplikacji.

patternAnyEntities

Lista wzorców. dowolnych jednostek.

patterns

Lista wzorców.

prebuiltEntities

Lista wstępnie utworzonych jednostek.

regex_entities

Lista jednostek wyrażeń regularnych.

regex_features

Lista funkcji wzorców.

utterances

Lista przykładowych wyrażenia długości.

versionId
  • string

Identyfikator wersji aplikacji, która została wyeksportowana.

Odpowiedzi

Name Type Description
201 Created
  • string

Utworzona wersja aplikacji.

Other Status Codes

Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Przykłady

Successful Import Application

Sample Request

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

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

Definicje

ClosedList

Wyeksportowany model — jednostka listy.

ErrorResponse

Odpowiedź na błąd podczas wywoływania operacji w interfejsie API.

HierarchicalModelV2
JSONEntity

Wyeksportowana jednostka wyodrębniona z modelu z wypowiedź.

JSONModelFeature

Wyeksportowana Funkcja modelu PhraseList.

JSONRegexFeature

Wyeksportowany model — funkcja wzorca.

JSONUtterance

Wyeksportowany model — wypowiedź, który został użyty do uczenia modelu.

LuisAppV2

Wyeksportowany model — wyeksportowana aplikacja LUIS.

PatternAny

Wzorzec. wszystkie wyekstraktory jednostek.

PatternRule

Wzorce

PrebuiltDomainObject
PrebuiltEntity

Prekompilowany Ekstraktor obiektu.

RegexEntity

Ekstraktor jednostki wyrażenia regularnego.

SubClosedList

Podlista elementów dla jednostki listy.

ClosedList

Wyeksportowany model — jednostka listy.

Name Type Description
name
  • string

Nazwa jednostki listy.

roles
  • string[]
subLists

Podlisty dla jednostki listy.

ErrorResponse

Odpowiedź na błąd podczas wywoływania operacji w interfejsie API.

Name Type Description
errorType
  • string

HierarchicalModelV2

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

JSONEntity

Wyeksportowana jednostka wyodrębniona z modelu z wypowiedź.

Name Type Description
children

Wyeksportowana jednostka wyodrębniona z modelu z wypowiedź.

endPos
  • integer

Indeks w wypowiedź, w którym znajduje się wyodrębniona jednostka.

entity
  • string

Nazwa jednostki.

role
  • string

Rola, którą jednostka odgrywa w wypowiedź.

startPos
  • integer

Indeks w wypowiedź, w którym rozpocznie się wyodrębniona jednostka.

JSONModelFeature

Wyeksportowana Funkcja modelu PhraseList.

Name Type Description
activated
  • boolean

Wskazuje, czy funkcja jest włączona.

enabledForAllModels
  • boolean

Wskazuje, czy PhraseList jest włączony dla wszystkich modeli w aplikacji.

mode
  • boolean

Funkcja wieloskładnikowej listy fraz służy jako lista synonimów do szkoleń. Lista fraz niewymieniających się z wymianą służy jako osobne funkcje szkoleniowe. Dlatego jeśli lista fraz niewymiennych zawiera 5 fraz, zostaną one zamapowane na 5 oddzielnych funkcji. Możesz traktować listę niewymiennych fraz jako dodatkowy zbiór słów do dodania do LUIS istniejących funkcji słownictwa. Jest używana jako funkcja wyszukiwania leksykonu, gdzie jej wartość wynosi 1, jeśli Leksykon zawiera dany wyraz lub 0, jeśli nie. Wartość domyślna to True.

name
  • string

Nazwa PhraseList.

words
  • string

Lista fraz oddzielonych przecinkami, które reprezentują PhraseList.

JSONRegexFeature

Wyeksportowany model — funkcja wzorca.

Name Type Description
activated
  • boolean

Wskazuje, czy funkcja wzorca jest włączona.

name
  • string

Nazwa funkcji.

pattern
  • string

Wyrażenie regularne do dopasowania.

JSONUtterance

Wyeksportowany model — wypowiedź, który został użyty do uczenia modelu.

Name Type Description
entities

Dopasowane jednostki.

intent
  • string

Dopasowany cel.

text
  • string

Wypowiedź.

LuisAppV2

Wyeksportowany model — wyeksportowana aplikacja LUIS.

Name Type Description
closedLists

Lista jednostek listy.

composites

Lista jednostek złożonych.

culture
  • string

Kultura aplikacji. Np.: pl-US.

desc
  • string

Opis aplikacji.

entities

Lista jednostek.

intents

Lista intencji.

luis_schema_version
  • string

Wersja deserializacji schematu Luis.

model_features

Lista funkcji modelu.

name
  • string

Nazwa aplikacji.

patternAnyEntities

Lista wzorców. dowolnych jednostek.

patterns

Lista wzorców.

prebuiltEntities

Lista wstępnie utworzonych jednostek.

regex_entities

Lista jednostek wyrażeń regularnych.

regex_features

Lista funkcji wzorców.

utterances

Lista przykładowych wyrażenia długości.

versionId
  • string

Identyfikator wersji aplikacji, która została wyeksportowana.

PatternAny

Wzorzec. wszystkie wyekstraktory jednostek.

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

PatternRule

Wzorce

Name Type Description
intent
  • string

Nazwa obiektu, do którego należy wzorzec.

pattern
  • string

Tekst wzorca.

PrebuiltDomainObject

Name Type Description
domain_name
  • string
model_name
  • string

PrebuiltEntity

Prekompilowany Ekstraktor obiektu.

Name Type Description
name
  • string
roles
  • string[]

RegexEntity

Ekstraktor jednostki wyrażenia regularnego.

Name Type Description
name
  • string
regexPattern
  • string
roles
  • string[]

SubClosedList

Podlista elementów dla jednostki listy.

Name Type Description
canonicalForm
  • string

Standardowy formularz reprezentujący listę.

list
  • string[]

Lista wyrazów synonimu.