Versions - Import

リファレンス

Service:: Cognitive Services - LUIS

API Version:: 2.0

LUIS アプリケーションに新しいバージョンをインポートします。

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

With optional parameters:

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

URI パラメーター

名前	/	必須	型	説明
appId	path	True	string uuid	アプリケーション ID。
Endpoint	path	True	string	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名など)。 https://westus.api.cognitive.microsoft.com
versionId	query		string	インポートする新しい versionId。指定しない場合、versionId はインポートされたオブジェクトから読み取られます。

要求ヘッダー

名前	必須	型	説明
Ocp-Apim-Subscription-Key	True	string

要求本文

名前	型	説明
closedLists	ClosedList[]	リストエンティティの一覧。
composites	HierarchicalModel[]	複合エンティティの一覧。
culture	string	アプリケーションのカルチャ。例: en-us。
desc	string	アプリケーションの説明。
entities	HierarchicalModel[]	エンティティの一覧。
intents	HierarchicalModel[]	意図の一覧。
model_features	JSONModelFeature[]	モデル機能の一覧。
name	string	アプリケーションの名前です。
patternAnyEntities	PatternAny[]	Pattern.Any エンティティの一覧。
patterns	PatternRule[]	パターンの一覧。
prebuiltEntities	PrebuiltEntity[]	事前構築済みエンティティの一覧。
regex_entities	RegexEntity[]	正規表現エンティティの一覧。
regex_features	JSONRegexFeature[]	パターンフィーチャの一覧。
utterances	JSONUtterance[]	発話の例の一覧。
versionId	string	エクスポートされたアプリケーションのバージョン ID。

応答

名前	型	説明
201 Created	string	作成されたアプリケーションのバージョン。
Other Status Codes	ErrorResponse	エラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

例

Successful Import Application

Sample Request

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

Sample Response

Status code:: 201

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

Response Body

"0.2"

定義

名前	説明
ClosedList	エクスポートされたモデル - リストエンティティ。
ErrorResponse	API で操作を呼び出すときのエラー応答。
HierarchicalModel
JSONEntity	エクスポートされたモデル - 発話から抽出されたエンティティ。
JSONModelFeature	エクスポートされたモデル - フレーズリストモデル機能。
JSONRegexFeature	エクスポートされたモデル - パターン機能。
JSONUtterance	エクスポートされたモデル - モデルのトレーニングに使用された発話。
LuisApp	エクスポートされたモデル - エクスポートされた LUIS アプリケーション。
PatternAny	Pattern.Any Entity Extractor。
PatternRule	Pattern
PrebuiltDomainObject
PrebuiltEntity	事前構築済みのエンティティ抽出器。
RegexEntity	正規表現エンティティ抽出器。
SubClosedList	リストエンティティのアイテムのサブリスト。

ClosedList

エクスポートされたモデル - リストエンティティ。

名前	型	説明
name	string	リストエンティティの名前。
roles	string[]
subLists	SubClosedList[]	リストエンティティのサブリスト。

ErrorResponse

API で操作を呼び出すときのエラー応答。

名前	型	説明
errorType	string

HierarchicalModel

名前	型	説明
children	string[]
inherits	PrebuiltDomainObject
name	string
roles	string[]

JSONEntity

エクスポートされたモデル - 発話から抽出されたエンティティ。

名前	型	説明
endPos	integer	抽出されたエンティティが終了する発話内のインデックス。
entity	string	エンティティ名。
role	string	発話内のエンティティのロール。
startPos	integer	抽出されたエンティティが開始される発話内のインデックス。

JSONModelFeature

エクスポートされたモデル - フレーズリストモデル機能。

名前	型	説明
activated	boolean	機能が有効になっているかどうかを示します。
mode	boolean	交換可能なフレーズリスト機能は、トレーニングのシノニムのリストとして機能します。交換できないフレーズリストは、トレーニング用の個別の機能として機能します。したがって、互換性のないフレーズリストに 5 つのフレーズが含まれている場合、それらは 5 つの個別の機能にマップされます。互換性のないフレーズリストは、LUIS の既存のボキャブラリ機能に追加する単語の追加バッグと考えることができます。特定の単語が辞書に含まれている場合は値が 1、含まれていない場合は 0 である辞書検索機能として使用されます。既定値は true です。
name	string	フレーズリスト名。
words	string	Phraselist を表すコンマ区切りのフレーズの一覧。

JSONRegexFeature

エクスポートされたモデル - パターン機能。

名前	型	説明
activated	boolean	パターン機能が有効かどうかを示します。
name	string	機能の名前。
pattern	string	一致する正規表現。

JSONUtterance

エクスポートされたモデル - モデルのトレーニングに使用された発話。

名前	型	説明
entities	JSONEntity[]	一致するエンティティ。
intent	string	一致する意図。
text	string	発話。

LuisApp

エクスポートされたモデル - エクスポートされた LUIS アプリケーション。

名前	型	説明
closedLists	ClosedList[]	リストエンティティの一覧。
composites	HierarchicalModel[]	複合エンティティの一覧。
culture	string	アプリケーションのカルチャ。例: en-us。
desc	string	アプリケーションの説明。
entities	HierarchicalModel[]	エンティティの一覧。
intents	HierarchicalModel[]	意図の一覧。
model_features	JSONModelFeature[]	モデル機能の一覧。
name	string	アプリケーションの名前です。
patternAnyEntities	PatternAny[]	Pattern.Any エンティティの一覧。
patterns	PatternRule[]	パターンの一覧。
prebuiltEntities	PrebuiltEntity[]	事前構築済みエンティティの一覧。
regex_entities	RegexEntity[]	正規表現エンティティの一覧。
regex_features	JSONRegexFeature[]	パターンフィーチャの一覧。
utterances	JSONUtterance[]	発話の例の一覧。
versionId	string	エクスポートされたアプリケーションのバージョン ID。

PatternAny

Pattern.Any Entity Extractor。

名前	型	説明
explicitList	string[]
name	string
roles	string[]

PatternRule

Pattern

名前	型	説明
intent	string	パターンが属する意図の名前。
pattern	string	パターンテキスト。

PrebuiltDomainObject

名前	型	説明
domain_name	string
model_name	string

PrebuiltEntity

事前構築済みのエンティティ抽出器。

名前	型	説明
name	string
roles	string[]

RegexEntity

正規表現エンティティ抽出器。

名前	型	説明
name	string
regexPattern	string
roles	string[]

SubClosedList

リストエンティティのアイテムのサブリスト。

名前	型	説明
canonicalForm	string	リストが表す標準フォーム。
list	string[]	シノニム語の一覧。

次の方法で共有