QnA Maker
정보를 탐색하기 쉬운 FAQ로 증류합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 |
| Power Apps | 스탠다드 | 다음을 제외한 모든 Power Apps 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| Power Automate | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 21Vianet에서 운영하는 중국 클라우드 |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://www.qnamaker.ai/ |
알려진 문제 및 제한 사항
QnA Maker 커넥터는 API QnA Maker 4.0 버전만 지원합니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| API 키 | API 키 | 모든 지역 | 공유 가능 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
API 키
인증 ID: keyBasedAuth
적용 가능: 모든 지역
API 키
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 계정 키 | 시큐어스트링 (보안 문자열) | Cognitive Services 계정 키 | 진실 |
| 사이트 URL | 문자열 | 루트 사이트 URL(예: https://westus.api.cognitive.microsoft.com) |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | API 키 | 진실 |
| 사이트 URL | 문자열 | 루트 사이트 URL입니다. 지정하지 않으면 사이트 URL이 기본값으로 지정 https://westus.api.cognitive.microsoft.com됩니다. |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 1200 | 60초 |
동작
| 기술 자료 다운로드 [사용되지 않음] |
이 작업은 지정된 기술 자료와 연결된 모든 데이터를 다운로드합니다. |
| 기술 자료 세부 정보 다운로드 |
특정 기술 자료의 세부 정보를 가져옵니다. |
| 기술 자료 세부 정보 다운로드(V2) |
특정 기술 자료의 세부 정보를 가져옵니다. |
| 답변 생성 |
이 작업은 지정된 질문에 대한 상위 순위 대답을 반환합니다. |
| 답변 생성 [사용되지 않음] |
이 작업은 지정된 질문에 대한 상위 순위 대답을 반환합니다. |
기술 자료 다운로드 [사용되지 않음]
이 작업은 지정된 기술 자료와 연결된 모든 데이터를 다운로드합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
기술 자료 ID
|
KnowledgeBaseId | True | string |
QnAMaker 포털에서 가져와야 합니다. |
반환
CreateKb 작업에 대한 응답 스키마입니다.
기술 자료 세부 정보 다운로드
특정 기술 자료의 세부 정보를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
기술 자료 ID
|
KnowledgeBaseId | True | string |
QnAMaker 포털에서 가져와야 합니다. |
반환
CreateKb 작업에 대한 응답 스키마입니다.
기술 자료 세부 정보 다운로드(V2)
특정 기술 자료의 세부 정보를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
리소스 하위 도메인 또는 지역
|
subdomainName | True | string |
Azure 하위 도메인 또는 지리적 지역(예: westus) |
|
기술 자료 ID
|
KnowledgeBaseId | True | string |
QnAMaker 포털에서 가져와야 합니다. |
반환
CreateKb 작업에 대한 응답 스키마입니다.
답변 생성
이 작업은 지정된 질문에 대한 상위 순위 대답을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
기술 자료 ID
|
KnowledgeBaseId | True | string |
QnAMaker 포털에서 가져와야 합니다. |
|
서비스 호스트
|
ServiceHost | True | string |
QnAMaker 포털에서 가져와야 합니다. |
|
엔드포인트 키
|
EndpointKey | True | string |
QnAMaker 포털에서 가져와야 합니다. |
|
Question
|
question | True | string |
질문을 합니다. |
|
Top
|
top | integer |
출력에서 원하는 순위가 지정된 결과 수입니다. |
반환
답변 생성 [사용되지 않음]
이 작업은 지정된 질문에 대한 상위 순위 대답을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
기술 자료 ID
|
KnowledgeBaseId | True | string |
QnAMaker 포털에서 가져와야 합니다. |
|
Question
|
question | True | string |
질문을 합니다. |
|
Top
|
top | integer |
출력에서 원하는 순위가 지정된 결과 수입니다. |
반환
정의
GenerateAnswer_Response
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
Answers
|
answers | array of object |
모든 답변 목록입니다. |
|
답변
|
answers.answer | string |
질문에 대한 상위 순위 답변입니다. |
|
Score
|
answers.score | float |
답변의 상대 점수입니다. |
|
아이디
|
answers.id | number | |
|
출처
|
answers.source | string |
DownloadKnowledgeBase_Response
CreateKb 작업에 대한 응답 스키마입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
기술 자료를 식별하는 고유 ID입니다. |
|
hostName
|
hostName | string |
기술 자료가 호스트되는 URL 호스트 이름입니다. |
|
lastAccessedTimestamp
|
lastAccessedTimestamp | string |
기술 자료가 마지막으로 액세스된 타임스탬프를 반환합니다(UTC). |
|
lastChangedTimestamp
|
lastChangedTimestamp | string |
기술 자료가 마지막으로 수정된 타임스탬프를 반환합니다(UTC). |
|
lastPublishedTimestamp
|
lastPublishedTimestamp | string |
기술 자료가 마지막으로 게시된 타임스탬프를 반환합니다(UTC). |
|
이름
|
name | string |
기술 자료의 이름입니다. |
|
userId
|
userId | string |
기술 자료를 만들거나 소유한 사용자입니다. |
|
웹 주소
|
urls | array of string |
Q-A가 추출되어 기술 자료에 추가된 URL 원본입니다. |
|
소스
|
sources | array of string |
Q-A가 추출되거나 기술 자료에 명시적으로 추가된 사용자 지정 원본입니다. |