語言 - 問答
語言 - 問答 API 是一項基於雲的服務，它通過最先進的轉換器模型提供高級自然語言處理，以根據自定義問答項目或原始文本生成答案。 問答是語言服務中的一項功能，已從 QnA Maker 服務增強，具有支援非結構化文件和精確回答等其他功能。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure 中國區域 |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 由 21Vianet 營運的中國雲 |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 由 21Vianet 營運的中國雲 |
| 連絡人 | |
|---|---|
| 名稱 | 問答支持 |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| qnamakersupport@microsoft.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 微索 |
| 網站 | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| 隱私策略 | https://privacy.microsoft.com/en-us/privacystatement |
| 類別 | 人工智慧;網站 |
語言 - 問答連接器是將任何 Power 應用程式與語言服務中的新問答功能整合的連接器。 使用此連接器，用戶現在可以連接到問答的新功能和增強功能。 此連接器中有一些動作可協助使用者
- 從專案產生答案
- 取得專案中繼資料
- 在一段時間內從提供的文本生成答案，我們計劃推出更多操作，為客戶提供更多功能。
先決條件
請依照 此處 的指示建立自訂問答專案。
如何取得認證
- 部署專案後，按一下「取得預測 URL」。
- 從預測URL的主機名和您的帳戶金鑰（即Ocp-Apim-Subscription-Key）取得您的網站URL。
- 使用您的帳戶金鑰和網站 URL 建立連線。
開始使用連接器
在流程中使用連接器
- 移至 Microsoft Power Automate ，然後按一下 [建立]，然後選取 [即時雲端流程]。
- 若要測試此聯結器，您可以按一下「手動觸發流程」，然後按一下
Create。
- 單擊“新步驟”並蒐索“語言 - 問答”，然後在三個操作中進行選擇。
動作：
從專案產生答案
- 此動作有助於使用專案中的知識庫來回答指定的問題。
- 您可以提供此查詢以從您的“示例項目”生成答案
- 從這裡深入瞭解要求本文： 問題解答 - 取得答案 - REST API （Azure 認知服務） |Microsoft 文件
取得專案中繼資料
- 此動作有助於取得專案的所有中繼資料。
- 提供您的專案名稱以取得專案的中繼資料。
從提供的文本生成答案
- 此操作有助於使用提供的文本回答指定的問題。 若要僅使用此動作，不需要在語言資源上啟用自訂問答。
- 此動作不需要自訂問答專案。 它只需要一個語言資源。 您可以建立語言資源，並將端點和金鑰從 Azure 入口網站的 [金鑰] 和 [端點] 區段中，分別複製到 [網站 URL] 和 [帳戶金鑰]。
- 查詢「充電表面需要多長時間？ “ 在以下文字上：” 電力和充電。 Surface Pro 4 電池從空狀態充滿電需要兩到四個小時。 如果您在充電時將 Surface 用於遊戲或視訊串流等耗電活動，則可能需要更長的時間「
- 從這裡深入瞭解要求本文： 問題解答 - 從文字取得答案 - REST API （Azure 認知服務） |Microsoft 文件
回應
從專案產生答案
它將從您的“示例項目”返回問題“輔助功能”的答案。 若要深入瞭解此動作的回應物件，請流覽 問題解答 - 取得答案 - REST API （Azure 認知服務） |Microsoft 文件
從提供的文本生成答案
它將從給定的文本中提取您問題的答案。 若要深入瞭解回應物件，請流覽 問題解答 - 從文字取得答案 - REST API （Azure 認知服務） |Microsoft Docs 的 .
取得專案中繼資料
它會取得所要求專案的中繼資料。 若要深入瞭解回應物件，請流覽 問答專案 - 取得專案詳細資料 - REST API （Azure 認知服務） |Microsoft Docs 的 .
已知問題與限制
我們還沒有找到任何內容，如果您發現任何內容，請在以下位置與我們聯繫： qnamakersupport@microsoft.com
常見錯誤和補救措施
請參閱此文件： https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
FAQ
正在建立連線
連接器支援下列驗證類型：
| API 金鑰 | API 金鑰 (ApiKey) | 所有區域 | 可共用 |
| Azure AD 整合 | 使用 Azure Active Directory 來存取您的 Azure Blob 儲存體。 | 所有區域 | 不可共享 |
| 預設值 [已棄用] | 此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。 | 所有區域 | 不可共享 |
API 金鑰
驗證 ID：keyBasedAuth
適用：所有地區
API 金鑰 (ApiKey)
這是可共享的連接。 如果 Power App 與其他使用者共用，也會共用連線。 如需詳細資訊，請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 帳戶金鑰 | securestring | 要從 Azure 入口網站複製語言資源的端點金鑰 | 對 |
| 網站 URL | 字串 | 要從 Azure 入口網站複製的語言資源主機名稱 | 對 |
Azure AD 整合
驗證識別碼：tokenBasedAuth
適用：所有地區
使用 Azure Active Directory 來存取您的 Azure Blob 儲存體。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 網站 URL | 字串 | 要從 Azure 入口網站複製的語言資源主機名稱 | 對 |
預設值 [已棄用]
適用：所有地區
此選項僅適用於沒有明確驗證類型的舊連線，並且僅用於回溯相容性。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 帳戶金鑰 | securestring | 要從 Azure 入口網站複製語言資源的端點金鑰 | 對 |
| 網站 URL | 字串 | 要從 Azure 入口網站複製的語言資源主機名稱 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 取得專案中繼資料 |
此動作有助於取得專案的所有中繼資料。 |
| 從專案產生答案 |
此動作有助於使用專案中的知識庫來回答指定的問題。 |
| 從提供的文本生成答案 |
此操作有助於使用提供的文本回答指定的問題。 |
取得專案中繼資料
此動作有助於取得專案的所有中繼資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案名稱
|
ProjectNamePathParameter | True | string |
要使用的項目名稱。 |
|
API 版本
|
api-version | True | string |
這是用戶端 API 版本。 |
傳回
表示專案。
從專案產生答案
此動作有助於使用專案中的知識庫來回答指定的問題。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
專案名稱
|
projectName | True | string |
這是您要使用的專案名稱。 |
|
Question
|
question | True | string |
針對專案查詢的使用者問題。 |
|
使用者識別碼
|
userId | string |
用戶的唯一識別碼。 |
|
|
頂#
|
top | integer |
要針對問題傳回的答案數目上限。 |
|
|
信賴度臨界值
|
confidenceScoreThreshold | float |
答案的最低閾值分數。 值範圍從 0 到 1。 |
|
|
排名器類型
|
rankerType | string |
要使用的排名器類型。 |
|
|
QnA 識別碼
|
qnaId | string |
這是要從專案擷取的確切 QnA 識別碼。 |
|
|
先前的 QnA 識別碼
|
previousQnaId | integer |
上一個回合最上層答案結果 QnA 識別碼。 |
|
|
上一個用戶查詢
|
previousUserQuery | string |
先前的用戶查詢。 |
|
|
Key
|
key | string |
QnA 中使用的元數據字典中的元數據索引鍵。 |
|
|
value
|
value | string |
QnA 中使用的元數據字典中的元數據值。 |
|
|
將中繼資料聯結為
|
logicalOperation | string |
設定 'OR' 或 'AND' 以進行中繼資料篩選的對應邏輯運算。 |
|
|
來源篩選器
|
sourceFilter | string |
尋找與專案中任何指定來源清單相關聯的 QnA。 |
|
|
將過濾器與
|
logicalOperation | string |
用來將元數據篩選與來源篩選聯結的邏輯作業。 |
|
|
實現精確答案
|
enable | boolean |
啟用或停用回應範圍預測。 |
|
|
信賴度臨界值
|
confidenceScoreThreshold | float |
包含精確答案所需的最低閾值分數，值範圍從 0 到 1。 |
|
|
頂#
|
topAnswersWithSpan | integer |
精確答案預測時要考慮的熱門答案數量從 1 到 10。 |
|
|
包含非結構化來源
|
includeUnstructuredSources | boolean |
旗標以啟用非結構化來源的查詢。 |
|
|
部署名稱
|
deploymentName | True | string |
這是您要使用的專案的特定部署。 |
|
API 版本
|
api-version | True | string |
這是用戶端 API 版本。 |
傳回
代表問題解答清單。
從提供的文本生成答案
此操作有助於使用提供的文本回答指定的問題。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Question
|
question | True | string |
使用者問題，以針對指定的文字記錄進行查詢。 |
|
識別碼
|
id | True | string |
文字記錄的唯一識別碼。 |
|
收發簡訊
|
text | True | string |
記錄的文字內容。 |
|
語言
|
language | string |
文字記錄的語言。 這是語言的 BCP-47 表示法。 |
|
|
字串索引類型
|
stringIndexType | string |
指定用來解譯字串位移的方法。 根據 Unicode v8.0.0，預設為 Text Elements （Graphemes）。 如需詳細資訊，請參閱 https://aka.ms/text-analytics-offsets。 |
|
|
API 版本
|
api-version | True | string |
這是用戶端 API 版本。 |
傳回
代表答案結果。
定義
專案中繼資料
表示專案。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
projectName
|
projectName | string |
項目的名稱。 |
|
描述
|
description | string |
專案的描述。 |
|
語言
|
language | Language |
文字記錄的語言。 這是語言的 BCP-47 表示法。 |
|
預設答案
|
settings.defaultAnswer | string |
在知識庫中找不到良好相符項時的預設答案回應。 |
|
多語言資源
|
multilingualResource | boolean |
跨專案啟用多種語言的資源。 |
|
createdDateTime
|
createdDateTime | date-time |
專案建立日期時間。 |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
表示上次修改日期時間的專案。 |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
表示專案上次部署日期時間。 |
語言
答案結果
代表問題解答清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
answers
|
answers | array of KnowledgeBaseAnswer |
代表答案結果清單。 |
|
isUserQuestion模棱兩可
|
isUserQuestionAmbiguous | boolean |
如果使用者的問題不明確，則傳回布林值。 |
知識庫答案
代表專案答案。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
問題
|
questions | array of string |
與答案相關聯的問題清單。 |
|
答
|
answer | string |
回答文字。 |
|
信賴度臨界值
|
confidenceScore | float |
回答信賴分數，值範圍從 0 到 1。 |
|
QnA 識別碼
|
id | integer |
QnA 結果的標識碼。 |
|
來源
|
source | string |
QnA 結果的來源。 |
|
中繼資料
|
metadata | object |
與答案相關聯的元數據，有助於分類或篩選問題解答。 |
|
對話
|
dialog | KnowledgeBaseAnswerDialog |
與 Answer 相關聯的對話方塊。 |
|
答案跨度
|
answerSpan | AnswerSpan |
回答 QnA 的 span 物件。 |
知識庫AnswerDialog
與 Answer 相關聯的對話方塊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
若要標記提示是否只與先前的問題相關。 如果為 true，請勿將此 QnA 包含為沒有內容之查詢的搜尋結果;否則，如果為 false，則會忽略內容，並在搜尋結果中包含此 QnA。 |
|
提示
|
prompts | array of KnowledgeBaseAnswerPrompt |
與答案相關聯的提示清單。 |
知識庫AnswerPrompt
提示輸入答案。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顯示順序
|
displayOrder | integer |
提示的索引 - 用於提示的順序。 |
|
qnaId
|
qnaId | integer |
對應至提示的 QnA 識別碼。 |
|
顯示文字
|
displayText | string |
顯示來代表後續問題提示的文字。 |
答案跨度
回答 QnA 的 span 物件。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
收發簡訊
|
text | string |
精確答案的預測文本。 |
|
信賴度臨界值
|
confidenceScore | float |
精確答案的預測分數，值範圍從 0 到 1。 |
|
位移
|
offset | integer |
精確答案從答案的開頭偏移。 |
|
length
|
length | integer |
精確答案的長度。 |
AnswersFromText結果
代表答案結果。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
answers
|
answers | array of TextAnswer |
代表答案結果。 |
文本答案
代表答案結果。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
答
|
answer | string |
回答文字。 |
|
信賴度臨界值
|
confidenceScore | float |
回答信賴分數，值範圍從 0 到 1。 |
|
識別碼
|
id | string |
記錄 ID。 |
|
答案跨度
|
answerSpan | AnswerSpan |
回答 QnA 的 span 物件。 |
|
位移
|
offset | integer |
從文件開頭偏移的句子。 |
|
length
|
length | integer |
刑期的長度。 |