QnAMaker 클래스

패키지:

com.microsoft.bot.ai.qna

Maven 아티팩트:

com.microsoft.bot:bot-ai-qna:4.14.3

• java.lang.Object
• • com.microsoft.bot.ai.qna.QnAMaker

구현

QnAMakerClient TelemetryQnAMaker

public class QnAMaker
implements QnAMakerClient, TelemetryQnAMaker

QnA Maker 기술 자료에 대한 액세스를 제공합니다.

필드 요약

한정자 및 형식	필드 및 설명
static final java.lang.String	QNA_MAKER_NAME QnAMaker 클래스의 이름입니다.
static final java.lang.String	QNA_MAKER_TRACE_LABEL QnA Maker 추적을 로깅할 때 사용되는 레이블입니다.
static final java.lang.String	QNA_MAKER_TRACE_TYPE QnA Maker 추적을 로깅할 때 사용되는 형식입니다.

생성자 요약

생성자	Description
QnAMaker(QnAMakerEndpoint withEndpoint, QnAMakerOptions options)	QnAMaker 클래스의 새 인스턴스를 초기화합니다.
QnAMaker(QnAMakerEndpoint withEndpoint, QnAMakerOptions options, BotTelemetryClient withTelemetryClient, Boolean withLogPersonalInformation)	QnAMaker 클래스의 새 인스턴스를 초기화합니다.

메서드 요약

한정자 및 형식	메서드 및 설명
java.util.concurrent.CompletableFuture<java.lang.Void>	callTrain(FeedbackRecords feedbackRecords) 기술 자료에 피드백을 보냅니다.
protected java.util.concurrent.CompletableFuture<Pair<java.util.Map<java.lang.String,java.lang.String>,java.util.Map<java.lang.String,java.lang.Double>>>	fillQnAEvent(QueryResult[] queryResults, TurnContext turnContext, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics) 원격 분석에 대한 QnaMessage 이벤트에 대한 이벤트 속성 및 메트릭을 채웁니다.
java.util.concurrent.CompletableFuture<QueryResult[]>	getAnswers(TurnContext turnContext, QnAMakerOptions options) 기술 자료에서 답변을 생성합니다.
java.util.concurrent.CompletableFuture<QueryResult[]>	getAnswers(TurnContext turnContext, QnAMakerOptions options, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics) 기술 자료에서 답변을 생성합니다.
java.util.concurrent.CompletableFuture<QueryResults>	getAnswersRaw(TurnContext turnContext, QnAMakerOptions options, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics) 기술 자료에서 답변을 생성합니다.
java.lang.Boolean	getLogPersonalInformation() 사용자로부터 온 개인 정보를 기록할지 여부를 나타내는 값을 가져옵니다.
QueryResult[]	getLowScoreVariation(QueryResult[] queryResult) 활성 학습에 대한 모호한 질문을 필터링합니다.
BotTelemetryClient	getTelemetryClient() 현재 구성된 BotTelemetryClient가져옵니다.
protected java.util.concurrent.CompletableFuture<java.lang.Void>	onQnaResults(QueryResult[] queryResults, TurnContext turnContext, Map<String,String> telemetryProperties, Map<String,Double> telemetryMetrics) QnA Maker에서 결과가 반환될 때 실행됩니다.

다음에서 상속된 메서드 java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

필드 세부 정보

QNA_MAKER_NAME

public static final String QNA_MAKER_NAME

QnAMaker 클래스의 이름입니다.

QNA_MAKER_TRACE_LABEL

public static final String QNA_MAKER_TRACE_LABEL

QnA Maker 추적을 로깅할 때 사용되는 레이블입니다.

QNA_MAKER_TRACE_TYPE

public static final String QNA_MAKER_TRACE_TYPE

QnA Maker 추적을 로깅할 때 사용되는 형식입니다.

생성자 세부 정보

QnAMaker

public QnAMaker(QnAMakerEndpoint withEndpoint, QnAMakerOptions options)

QnAMaker 클래스의 새 인스턴스를 초기화합니다.

매개 변수:

withEndpoint - 쿼리할 기술 자료의 엔드포인트입니다.

options - QnA Maker 기술 자료에 대한 옵션입니다.

QnAMaker

public QnAMaker(QnAMakerEndpoint withEndpoint, QnAMakerOptions options, BotTelemetryClient withTelemetryClient, Boolean withLogPersonalInformation)

QnAMaker 클래스의 새 인스턴스를 초기화합니다.

매개 변수:

withEndpoint - 쿼리할 기술 자료의 엔드포인트입니다.

options - QnA Maker 기술 자료에 대한 옵션입니다.

withTelemetryClient - 원격 분석 이벤트를 로깅하는 데 사용되는 IBotTelemetryClient입니다.

withLogPersonalInformation - 원격 분석 이벤트에 개인 식별 정보를 포함하도록 true로 설정합니다.

메서드 세부 정보

callTrain

public CompletableFuture callTrain(FeedbackRecords feedbackRecords)

기술 자료에 피드백을 보냅니다.

매개 변수:

feedbackRecords - 피드백 레코드.

반환:

비동기 작업을 나타냅니다.

Throw:

java.io.IOException - 있는 경우 IOException을 throw합니다.

fillQnAEvent

protected CompletableFuture,Map>> fillQnAEvent(QueryResult[] queryResults, TurnContext turnContext, Map telemetryProperties, Map telemetryMetrics)

원격 분석을 위해 QnaMessage 이벤트에 대한 이벤트 속성 및 메트릭을 채웁니다. 이러한 속성은 QnA GetAnswers 메서드가 호출될 때 기록됩니다.

매개 변수:

queryResults - QnA 서비스 결과입니다.

turnContext - 사용자와의 단일 대화 턴에 대한 정보를 포함하는 컨텍스트 개체입니다.

telemetryProperties - 이벤트에 대해 추가/재정의할 속성입니다.

telemetryMetrics - 이벤트에 대해 추가/재정의할 메트릭입니다.

반환:

IBotTelemetryClient로 전송될 속성 및 메트릭의 튜플입니다. QnAMessage 이벤트에 대한 TrackEvent 메서드입니다. 속성 및 메트릭은 GetAnswersAsync 메서드에서 전달된 속성으로 기록된 표준 속성을 반환했습니다.

Throw:

java.io.IOException - 있는 경우 IOException을 throw합니다.

getAnswers

public CompletableFuture getAnswers(TurnContext turnContext, QnAMakerOptions options)

기술 자료에서 답변을 생성합니다.

매개 변수:

turnContext - 기술 자료에 대해 쿼리할 사용자 질문이 포함된 턴 컨텍스트입니다.

options - QnA Maker 기술 자료에 대한 옵션입니다. null이면 생성자 옵션이 이 인스턴스에 사용됩니다.

반환:

순위 점수의 감소 순서로 정렬된 사용자 쿼리에 대한 답변 목록입니다.

getAnswers

public CompletableFuture getAnswers(TurnContext turnContext, QnAMakerOptions options, Map telemetryProperties, Map telemetryMetrics)

기술 자료에서 답변을 생성합니다.

매개 변수:

turnContext - 기술 자료에 대해 쿼리할 사용자 질문이 포함된 턴 컨텍스트입니다.

options - QnA Maker 기술 자료에 대한 옵션입니다. null이면 생성자 옵션이 이 인스턴스에 사용됩니다.

telemetryProperties - QnaMessage 이벤트를 사용하여 원격 분석에 기록할 추가 속성입니다.

telemetryMetrics - QnaMessage 이벤트를 사용하여 원격 분석에 기록할 추가 메트릭입니다.

반환:

순위 점수의 감소 순서로 정렬된 사용자 쿼리에 대한 답변 목록입니다.

getAnswersRaw

public CompletableFuture getAnswersRaw(TurnContext turnContext, QnAMakerOptions options, Map telemetryProperties, Map telemetryMetrics)

기술 자료에서 답변을 생성합니다.

매개 변수:

turnContext - 기술 자료에 대해 쿼리할 사용자 질문이 포함된 턴 컨텍스트입니다.

options - QnA Maker 기술 자료에 대한 옵션입니다. null이면 생성자 옵션이 이 인스턴스에 사용됩니다.

telemetryProperties - QnaMessage 이벤트를 사용하여 원격 분석에 기록할 추가 속성입니다.

telemetryMetrics - QnaMessage 이벤트를 사용하여 원격 분석에 기록할 추가 메트릭입니다.

반환:

순위 점수의 감소 순서로 정렬된 사용자 쿼리에 대한 답변 목록입니다.

getLogPersonalInformation

public Boolean getLogPersonalInformation()

사용자로부터 온 개인 정보를 기록할지 여부를 나타내는 값을 가져옵니다.

반환:

true이면 개인 정보를 IBotTelemetryClient.TrackEvent 메서드에 기록합니다. 그렇지 않으면 속성이 필터링됩니다.

getLowScoreVariation

public QueryResult[] getLowScoreVariation(QueryResult[] queryResult)

활성 학습에 대한 모호한 질문을 필터링합니다.

매개 변수:

queryResult - 사용자 쿼리 출력입니다.

반환:

모호한 질문의 필터링된 배열입니다.

getTelemetryClient

public BotTelemetryClient getTelemetryClient()

현재 구성된 BotTelemetryClient가져옵니다.

반환:

이벤트를 기록하는 데 사용되는 BotTelemetryClient.

onQnaResults

protected CompletableFuture onQnaResults(QueryResult[] queryResults, TurnContext turnContext, Map telemetryProperties, Map telemetryMetrics)

QnA Maker에서 결과가 반환될 때 실행됩니다.

매개 변수:

queryResults - QueryResult 배열

turnContext - TurnContext

telemetryProperties - LuisResult 이벤트를 사용하여 원격 분석에 기록할 추가 속성입니다.

telemetryMetrics - LuisResult 이벤트를 사용하여 원격 분석에 기록할 추가 메트릭입니다.

반환:

실행할 작업을 나타내는 작업입니다.

Throw:

java.io.IOException - 있는 경우 IOException을 throw합니다.