Examples - Add

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

ラベル付きの発話の例をアプリケーションのバージョンに追加します。

POST {Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/{versionId}/example

With optional parameters:

POST {Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/{versionId}/example?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	入れ子/フラット形式を切り替えます

要求ヘッダー

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

要求本文

名前	型	説明
entityLabels	EntityLabelObject[]	発話の例内で識別されたエンティティ。
intentName	string	発話の例を表す識別された意図。
text	string	発話の例。

応答

名前	型	説明
201 Created	LabelExampleResponse	作成された発話の例の ID。
Other Status Codes	ErrorResponse	エラー応答。

セキュリティ

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

例

Successful Add Label request

Sample Request

HTTP

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


{
  "text": "whats the weather in buenos aires?",
  "intentName": "WeatherInPlace",
  "entityLabels": [
    {
      "entityName": "Place",
      "startCharIndex": 21,
      "endCharIndex": 34
    }
  ]
}

Sample Response

Status code:

201

{
  "UtteranceText": "whats the weather in buenos aires?",
  "ExampleId": -11
}

定義

名前	説明
EntityLabelObject	例内の抽出されたエンティティのエンティティの種類と位置を定義します。
ErrorResponse	API で操作を呼び出すときのエラー応答。
ExampleLabelObject	ラベル付けされた発話の例。
LabelExampleResponse	ラベル付きの発話例を追加するときの応答。

EntityLabelObject

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

名前	型	説明
children	EntityLabelObject[]	発話の例内で識別されたエンティティ。
endCharIndex	integer	抽出されたエンティティが終了する発話内のインデックス。
entityName	string	エンティティの型。
role	string	発話でエンティティが果たすロール。
startCharIndex	integer	抽出されたエンティティが開始される発話内のインデックス。

ErrorResponse

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

名前	型	説明
errorType	string

ExampleLabelObject

ラベル付けされた発話の例。

名前	型	説明
entityLabels	EntityLabelObject[]	発話の例内で識別されたエンティティ。
intentName	string	発話の例を表す識別された意図。
text	string	発話の例。

LabelExampleResponse

ラベル付きの発話例を追加するときの応答。

名前	型	説明
ExampleId	integer	新しく作成された例の ID。
UtteranceText	string	発話の例。