Examples - List

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

アプリケーションのバージョンからレビューされる発話の例を返します。

GET {Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/{versionId}/examples

With optional parameters:

GET {Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/{versionId}/examples?skip={skip}&take={take}&enableNestedChildren={enableNestedChildren}

URI パラメーター

名前	/	必須	型	説明
appId	path	True	string uuid	アプリケーション ID。
Endpoint	path	True	string	サポートされている Cognitive Services エンドポイント (プロトコルとホスト名など)。 https://westus.api.cognitive.microsoft.com
versionId	path	True	string	バージョン ID。
enableNestedChildren	query		boolean	入れ子/フラット形式を切り替えます
skip	query		integer	スキップするエントリの数。 既定値は 0 です。
take	query		integer	返されるエントリの数。 最大ページ サイズは 500 です。 既定値は 100 です。

要求ヘッダー

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

応答

名前	型	説明
200 OK	LabeledUtterance[]	アプリケーション内のすべての発話例の予測とラベルのペアの一覧。
Other Status Codes	ErrorResponse	エラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

例

Successful Review Labeled Examples request

Sample Request

HTTP

GET {Endpoint}/luis/authoring/v3.0-preview/apps/86226c53-b7a6-416f-876b-226b2b5ab07b/versions/0.1/examples?enableNestedChildren=False

Sample Response

Status code:

200

[
  {
    "id": -12,
    "text": "what's the weather like in seattle?",
    "tokenizedText": [
      "what",
      "'",
      "s",
      "the",
      "weather",
      "like",
      "in",
      "seattle",
      "?"
    ],
    "intentLabel": "GetWeather",
    "entityLabels": [
      {
        "entityName": "Location",
        "startTokenIndex": 7,
        "endTokenIndex": 7
      }
    ],
    "intentPredictions": [
      {
        "name": "GetWeather",
        "score": 1
      },
      {
        "name": "None",
        "score": 0.21
      },
      {
        "name": "BookFlight",
        "score": 0
      }
    ],
    "entityPredictions": [
      {
        "entityName": "Location",
        "startTokenIndex": 7,
        "endTokenIndex": 7,
        "phrase": "seattle"
      }
    ]
  },
  {
    "id": -11,
    "text": "book me a flight from cairo to redmond next thursday",
    "tokenizedText": [
      "book",
      "me",
      "a",
      "flight",
      "from",
      "cairo",
      "to",
      "redmond",
      "next",
      "thursday"
    ],
    "intentLabel": "BookFlight",
    "entityLabels": [
      {
        "entityName": "Location",
        "startTokenIndex": 7,
        "endTokenIndex": 7,
        "role": "To"
      },
      {
        "entityName": "Location",
        "startTokenIndex": 5,
        "endTokenIndex": 5,
        "role": "from"
      }
    ],
    "intentPredictions": [
      {
        "name": "BookFlight",
        "score": 0.93
      },
      {
        "name": "None",
        "score": 0.41
      },
      {
        "name": "GetWeather",
        "score": 0
      }
    ],
    "entityPredictions": [
      {
        "entityName": "datetime",
        "startTokenIndex": 8,
        "endTokenIndex": 9,
        "phrase": "next thursday"
      }
    ]
  }
]

定義

名前	説明
EntityLabel	例内で抽出されたエンティティのエンティティの種類と位置を定義します。
EntityPrediction	提案されたエンティティ。
ErrorResponse	API で操作を呼び出すときのエラー応答。
IntentPrediction	提案された意図。
LabeledUtterance	例の予測とラベルのペア。

EntityLabel

例内で抽出されたエンティティのエンティティの種類と位置を定義します。

名前	型	説明
children	EntityLabel[]	例内で抽出されたエンティティのエンティティの種類と位置を定義します。
endTokenIndex	integer	抽出されたエンティティが終了する発話内のインデックス。
entityName	string	エンティティの型。
role	string	予測されるエンティティのロール。
roleId	string	予測されたエンティティのロール ID。
startTokenIndex	integer	抽出されたエンティティが開始される発話内のインデックス。

EntityPrediction

提案されたエンティティ。

名前	型	説明
children	EntityPrediction[]	提案されたエンティティ。
endTokenIndex	integer	抽出されたエンティティが終了する発話内のインデックス。
entityName	string	エンティティの名前
phrase	string	エンティティを構成する実際のトークン。
startTokenIndex	integer	抽出されたエンティティが開始される発話内のインデックス。

ErrorResponse

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

名前	型	説明
errorType	string

IntentPrediction

提案された意図。

名前	型	説明
name	string	意図の名前
score	number	予測モデルに基づく意図のスコア。

LabeledUtterance

例の予測とラベルのペア。

名前	型	説明
entityLabels	EntityLabel[]	例に一致するエンティティ。
entityPredictions	EntityPrediction[]	提案されたエンティティの一覧。
id	integer	ラベル付き発話の ID。
intentLabel	string	例に一致する意図。
intentPredictions	IntentPrediction[]	提案された意図の一覧。
text	string	発話。 たとえば、「シアトルの天気は?
tokenizedText	string[]	トークン化された発話。