언어 - 질문 답변
언어 - 질문 답변 API는 최신 변환기 모델과 함께 고급 자연어 처리를 제공하여 사용자 지정 질문 답변 프로젝트 또는 원시 텍스트에 대한 답변을 생성하는 클라우드 기반 서비스입니다. 질문 답변은 비정형 문서 지원 및 정확한 답변과 같은 추가 기능을 통해 QnA Maker 서비스에서 향상된 언어 서비스의 기능입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| 연락처 | |
|---|---|
| 이름 | 질문 답변 지원 |
| URL | https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/overview |
| 전자 메일 | qnamakersupport@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsot |
| 웹 사이트 | https://azure.microsoft.com/en-us/services/cognitive-services/question-answering/#overview |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/en-us/privacystatement |
| 카테고리 | AI; 웹 사이트 |
언어 - 질문 답변 커넥터는 모든 Power 앱을 언어 서비스 내의 새로운 질문 답변 기능과 통합하는 커넥터입니다. 이 커넥터를 사용하여 사용자는 이제 질문 답변의 향상된 기능뿐만 아니라 새로운 기능에 연결할 수 있습니다. 이 커넥터에는 사용자가
- 프로젝트에서 답변 생성
- 프로젝트 메타데이터 가져오기
- 일정 기간 동안 제공된 텍스트에서 답변을 생성하며 고객에게 더 많은 기능을 제공하기 위해 더 많은 작업을 배포할 계획입니다.
필수 조건
여기에 있는 지침에 따라 사용자 지정 질문 답변 프로젝트를 만듭니다.
자격 증명을 가져오는 방법
- 프로젝트를 배포한 후 "예측 URL 가져오기"를 클릭합니다.
- 예측 URL의 호스트 이름과 Ocp-Apim-Subscription-Key인 계정 키에서 사이트 URL을 가져옵니다.
- 계정 키 및 사이트 URL을 사용하여 연결을 만듭니다.
커넥터 시작
흐름에서 커넥터 사용
-
Microsoft Power Automate로 이동하여 만들기를 클릭하고 "인스턴트 클라우드 흐름"을 선택합니다.
- 이 커넥터를 테스트하려면 "수동으로 흐름 트리거"를 클릭하고 을 클릭
Create할 수 있습니다.
- "새 단계"를 클릭하고 "언어 – 질문 답변"을 검색하고 세 가지 작업 중에서 선택합니다.
작업:
프로젝트에서 답변 생성
- 이 작업은 프로젝트의 기술 자료를 사용하여 지정된 질문에 답변하는 데 도움이 됩니다.
- "Sample-project"
하기 위해 이 쿼리를 제공할 수 있습니다. - 다음에서 요청 본문에 대해 자세히 알아보세요. 질문 답변 - 답변 가져오기 - REST API(Azure Cognitive Services) | Microsoft Docs
프로젝트 메타데이터 가져오기
- 이 작업은 프로젝트의 모든 메타데이터를 가져오는 데 도움이 됩니다.
- 프로젝트 이름을 지정하여 프로젝트의 메타데이터를 가져옵니다.
제공된 텍스트에서 답변 생성
- 이 작업은 제공된 텍스트를 사용하여 지정된 질문에 답변하는 데 도움이 됩니다. 이 작업만 사용하려면 언어 리소스에서 사용자 지정 질문 답변을 사용하도록 설정할 필요가 없습니다.
- 이 작업에는 사용자 지정 질문 답변 프로젝트가 필요하지 않습니다. 언어 리소스만 필요합니다. 언어 리소스를 만들고 Azure Portal의 키 및 엔드포인트 섹션에서 각각 사이트 URL 및 계정 키로 엔드포인트와 키를 복사할 수 있습니다.
- 쿼리 " 표면을 충전하는 데 얼마나 걸리나요? " 다음 텍스트에: "전원 및 충전. Surface Pro 4 배터리를 빈 상태에서 완전히 충전하는 데 2~4시간이 걸립니다. "
"을 충전하는 동안 게임 또는 비디오 스트리밍과 같은 전력 집약적인 활동에 Surface를 사용하는 경우 더 오래 걸릴 수 있습니다. - 다음에서 요청 본문에 대해 자세히 알아보세요. 질문 답변 - 텍스트에서 답변 가져오기 - REST API(Azure Cognitive Services) | Microsoft Docs
응답
프로젝트에서 답변 생성
"접근성" 질문에 대한 "Sample-project"의 답변을 반환합니다. 이 작업에 대한 응답 개체에 대해 자세히 알아보려면 질문 답변 - 답변 가져오기 - REST API(Azure Cognitive Services)를 방문하세요. Microsoft Docs
제공된 텍스트에서 답변 생성
지정된 텍스트에서 질문에 대한 답변을 추출합니다. 응답 개체에 대해 자세히 알아보려면 질문 답변 - 텍스트에서 답변 가져오기 - REST API(Azure Cognitive Services)를 방문하세요. | Microsoft Docs .
프로젝트 메타데이터 가져오기
요청된 프로젝트의 메타데이터를 가져옵니다. 응답 개체에 대해 자세히 알아보려면 질문 답변 프로젝트 - 프로젝트 세부 정보 가져오기 - REST API(Azure Cognitive Services)를 방문하세요. Microsoft Docs .
알려진 문제 및 제한 사항
우리는 어떤을 찾을 수 없습니다, 당신이 찾을 경우 우리에게 연락하시기 바랍니다 qnamakersupport@microsoft.com
일반적인 오류 및 해결
다음 설명서를 참조하세요. https://docs.microsoft.com/en-us/rest/api/cognitiveservices/questionanswering/question-answering
자주 묻는 질문(FAQ)
다음 설명서를 참조하세요. https://docs.microsoft.com/en-us/azure/cognitive-services/language-service/question-answering/overview
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| API 키 | API 키 | 모든 지역 | 공유 가능 |
| Azure AD 통합 | Azure Active Directory를 사용하여 Azure Blob Storage에 액세스합니다. | 모든 지역 | 공유할 수 없음 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
API 키
인증 ID: keyBasedAuth
적용 가능: 모든 지역
API 키
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 계정 키 | 시큐어스트링 (보안 문자열) | Azure Portal에서 복사할 언어 리소스의 엔드포인트 키 | 진실 |
| 사이트 URL | 문자열 | Azure Portal에서 복사할 언어 리소스의 호스트 이름 | 진실 |
Azure AD 통합
인증 ID: tokenBasedAuth
적용 가능: 모든 지역
Azure Active Directory를 사용하여 Azure Blob Storage에 액세스합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 사이트 URL | 문자열 | Azure Portal에서 복사할 언어 리소스의 호스트 이름 | 진실 |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 계정 키 | 시큐어스트링 (보안 문자열) | Azure Portal에서 복사할 언어 리소스의 엔드포인트 키 | 진실 |
| 사이트 URL | 문자열 | Azure Portal에서 복사할 언어 리소스의 호스트 이름 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| Project에서 답변 생성 |
이 작업은 프로젝트의 기술 자료를 사용하여 지정된 질문에 답변하는 데 도움이 됩니다. |
| 제공된 텍스트에서 답변 생성 |
이 작업은 제공된 텍스트를 사용하여 지정된 질문에 답변하는 데 도움이 됩니다. |
| 프로젝트 메타데이터 가져오기 |
이 작업은 프로젝트의 모든 메타데이터를 가져오는 데 도움이 됩니다. |
Project에서 답변 생성
이 작업은 프로젝트의 기술 자료를 사용하여 지정된 질문에 답변하는 데 도움이 됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
프로젝트 이름
|
projectName | True | string |
사용할 프로젝트 이름입니다. |
|
Question
|
question | True | string |
프로젝트에 대해 쿼리할 사용자 질문입니다. |
|
사용자 ID
|
userId | string |
사용자의 고유 식별자입니다. |
|
|
맨 위로 #
|
top | integer |
질문에 대해 반환할 최대 답변 수입니다. |
|
|
신뢰도 임계값
|
confidenceScoreThreshold | float |
답변에 대한 최소 임계값 점수입니다. 값 범위는 0에서 1까지입니다. |
|
|
순위 유형
|
rankerType | string |
사용할 순위의 유형입니다. |
|
|
QnA ID
|
qnaId | string |
프로젝트에서 가져올 정확한 QnA ID입니다. |
|
|
이전 QnA ID
|
previousQnaId | integer |
이전 턴 상위 응답 결과 QnA ID입니다. |
|
|
이전 사용자 쿼리
|
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 버전입니다. |
반환
질문 답변 목록을 나타냅니다.
제공된 텍스트에서 답변 생성
이 작업은 제공된 텍스트를 사용하여 지정된 질문에 답변하는 데 도움이 됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Question
|
question | True | string |
지정된 텍스트 레코드에 대해 쿼리할 사용자 질문입니다. |
|
아이디
|
id | True | string |
텍스트 레코드의 고유 식별자입니다. |
|
문자 메시지
|
text | True | string |
레코드의 텍스트 내용입니다. |
|
Language
|
language | string |
텍스트 레코드의 언어입니다. 이는 언어의 BCP-47 표현입니다. |
|
|
문자열 인덱스 형식
|
stringIndexType | string |
문자열 오프셋을 해석하는 데 사용되는 메서드를 지정합니다. 유니코드 v8.0.0에 따라 기본값은 텍스트 요소(Graphemes)입니다. 자세한 내용은 https://aka.ms/text-analytics-offsets참조하세요. |
|
|
API 버전
|
api-version | True | string |
클라이언트 API 버전입니다. |
반환
응답 결과를 나타냅니다.
프로젝트 메타데이터 가져오기
이 작업은 프로젝트의 모든 메타데이터를 가져오는 데 도움이 됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
프로젝트 이름
|
ProjectNamePathParameter | True | string |
사용할 프로젝트의 이름입니다. |
|
API 버전
|
api-version | True | string |
클라이언트 API 버전입니다. |
반환
프로젝트를 나타냅니다.
정의
ProjectMetadata
프로젝트를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
projectName
|
projectName | string |
프로젝트의 이름입니다. |
|
description
|
description | string |
프로젝트에 대한 설명입니다. |
|
Language
|
language | Language |
텍스트 레코드의 언어입니다. 이는 언어의 BCP-47 표현입니다. |
|
defaultAnswer
|
settings.defaultAnswer | string |
기술 자료에서 일치하는 항목이 없으면 기본 응답 응답입니다. |
|
multilingualResource
|
multilingualResource | boolean |
프로젝트 전체에서 여러 언어에 사용할 수 있는 리소스입니다. |
|
생성된날짜시간
|
createdDateTime | date-time |
프로젝트 생성 날짜-시간. |
|
lastModifiedDateTime
|
lastModifiedDateTime | date-time |
마지막으로 수정한 날짜-시간을 프로젝트를 나타냅니다. |
|
lastDeployedDateTime
|
lastDeployedDateTime | date-time |
프로젝트의 마지막 배포 날짜-시간을 나타냅니다. |
Language
AnswersResult
질문 답변 목록을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
answers
|
answers | array of KnowledgeBaseAnswer |
응답 결과 목록을 나타냅니다. |
|
isUserQuestionAmbiguous
|
isUserQuestionAmbiguous | boolean |
사용자의 질문이 모호한 경우 부울 값을 반환합니다. |
KnowledgeBaseAnswer
프로젝트 대답을 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
질문
|
questions | array of string |
답변과 관련된 질문 목록입니다. |
|
대답
|
answer | string |
텍스트에 응답합니다. |
|
신뢰도 임계값
|
confidenceScore | float |
답변 신뢰도 점수, 값 범위는 0에서 1까지입니다. |
|
QnA ID
|
id | integer |
QnA 결과의 ID입니다. |
|
source
|
source | string |
QnA 결과의 원본입니다. |
|
metadata
|
metadata | object |
답변과 연결된 메타데이터로, 질문 답변을 분류하거나 필터링하는 데 유용합니다. |
|
대화
|
dialog | KnowledgeBaseAnswerDialog |
답변과 연결된 대화 상자입니다. |
|
answerSpan
|
answerSpan | AnswerSpan |
QnA의 응답 범위 개체입니다. |
KnowledgeBaseAnswerDialog
답변과 연결된 대화 상자입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
isContextOnly
|
isContextOnly | boolean |
프롬프트가 이전 질문과만 관련이 있는지 여부를 표시합니다. true이면 컨텍스트가 없는 쿼리에 대한 검색 결과로 이 QnA를 포함하지 마세요. 그렇지 않으면 false이면 컨텍스트를 무시하고 검색 결과에 이 QnA를 포함합니다. |
|
프롬프트
|
prompts | array of KnowledgeBaseAnswerPrompt |
답변과 연결된 프롬프트 목록입니다. |
KnowledgeBaseAnswerPrompt
답변을 묻는 메시지를 표시합니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
displayOrder
|
displayOrder | integer |
프롬프트의 인덱스 - 프롬프트 순서에 사용됩니다. |
|
qnaId
|
qnaId | integer |
프롬프트에 해당하는 QnA ID입니다. |
|
displayText
|
displayText | string |
후속 질문 프롬프트를 나타내기 위해 표시되는 텍스트입니다. |
AnswerSpan
QnA의 응답 범위 개체입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문자 메시지
|
text | string |
정확한 답변의 예측 텍스트입니다. |
|
신뢰도 임계값
|
confidenceScore | float |
정확한 답변의 예측 점수, 값 범위는 0에서 1까지입니다. |
|
offset
|
offset | integer |
답변 시작부터 정확한 응답 오프셋입니다. |
|
length
|
length | integer |
정확한 답변의 길이입니다. |
AnswersFromTextResult
응답 결과를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
answers
|
answers | array of TextAnswer |
응답 결과를 나타냅니다. |
TextAnswer
응답 결과를 나타냅니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
대답
|
answer | string |
대답 텍스트입니다. |
|
신뢰도 임계값
|
confidenceScore | float |
답변 신뢰도 점수, 값 범위는 0에서 1까지입니다. |
|
아이디
|
id | string |
레코드 ID입니다. |
|
answerSpan
|
answerSpan | AnswerSpan |
QnA의 응답 범위 개체입니다. |
|
offset
|
offset | integer |
문서 시작 부분의 문장 오프셋입니다. |
|
length
|
length | integer |
문장의 길이입니다. |