Examples - Add

服務:

Azure AI Services

API 版本:

2.0

在應用程式的版本中新增已加上標籤的範例語句。

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

URI 參數

名稱	位於	必要	類型	Description
appId	path	True	string (uuid)	應用程式識別碼。
Endpoint	path	True	string	支援的認知服務端點（通訊協定和主機名，例如：https://westus.api.cognitive.microsoft.com）。
versionId	path	True	string	版本標識碼。

要求標頭

名稱	必要	類型	Description
Ocp-Apim-Subscription-Key	True	string

要求本文

名稱	類型	Description
entityLabels	EntityLabelObject[]	範例語句內的已識別實體。
intentName	string	表示範例語句的已識別意圖。
text	string	範例語句。

回應

名稱	類型	Description
201 Created	LabelExampleResponse	所建立範例語句的標識碼。
Other Status Codes	ErrorResponse	錯誤回應。

安全性

Ocp-Apim-Subscription-Key

類型: apiKey
位於: header

範例

Successful Add Label request

範例要求

HTTP

POST {Endpoint}/luis/api/v2.0/apps/86226c53-b7a6-416f-876b-226b2b5ab07b/versions/0.1/example


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

範例回覆

狀態碼:

201

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

定義

名稱	Description
EntityLabelObject	定義範例中擷取實體的實體類型和位置。
ErrorResponse	叫用 API 上的作業時發生錯誤回應。
ExampleLabelObject	加上標籤的範例語句。
LabelExampleResponse	新增加上標籤的範例語句時回應。

EntityLabelObject

Object

定義範例中擷取實體的實體類型和位置。

名稱	類型	Description
endCharIndex	integer	擷取實體結束之語句內的索引。
entityName	string	實體類型。
role	string	語句中實體的角色。
startCharIndex	integer	擷取實體啟動之語句內的索引。

ErrorResponse

Object

叫用 API 上的作業時發生錯誤回應。

名稱	類型	Description
errorType	string

ExampleLabelObject

Object

加上標籤的範例語句。

名稱	類型	Description
entityLabels	EntityLabelObject[]	範例語句內的已識別實體。
intentName	string	表示範例語句的已識別意圖。
text	string	範例語句。

LabelExampleResponse

Object

新增加上標籤的範例語句時回應。

名稱	類型	Description
ExampleId	integer (int64)	新建立的範例標識碼。
UtteranceText	string	範例語句。