Power BI Embedded의 질문 및 답변Q&A in Power BI Embedded

Power BI Embedded는 질문 및 답변을 응용 프로그램에 통합하고 사용자가 자연어를 사용하여 질문하고 차트나 그래프와 같은 시각적 개체 형식으로 즉각적인 답변을 받을 수 있는 방법을 제공합니다.Power BI Embedded offers you a way to incorporate Q&A into an application and allow your users to ask questions using natural language and receive immediate answers in the form of visuals like charts or graphs.

포함된 프레임의 질문 및 답변 대화형 질문

응용 프로그램 내에 질문 및 답변을 포함하는 방법은 대화형결과 전용 두 가지입니다.There are two modes for embedding Q&A within your application: interactive and result only. 대화형 모드에서는 질문을 입력하고 시각적 개체 내에 표시할 수 있습니다.Interactive mode allows you to type in questions and have them displayed within the visual. 저장된 질문이 있거나 표시하려는 질문이 있으면 embed config에 질문을 채워서 결과 전용 모드를 사용할 수 있습니다.If you have a saved question, or a set question you want to display, you can use the result only mode by populating the question in your embed config.

다음은 JavaScript 코드의 모습입니다.Here is a look at what the JavaScript code will look like.

// Embed configuration used to describe the what and how to embed.
// This object is used when calling powerbi.embed within the JavaScript API.
// You can find more information at https://github.com/Microsoft/PowerBI-JavaScript/wiki/Embed-Configuration-Details.
var config= {
    type: 'qna',
    tokenType:   models.TokenType.Embed | models.TokenType.Aad,
    accessToken: access token value,
    embedUrl:    https://app.powerbi.com/qnaEmbed (groupId to be appended as query parameter if required),
    datasetIds:  array of requested data set ids (at the moment we support only one dataset),
    viewMode:    models.QnAMode.Interactive | models.QnAMode.ResultOnly,
    question:    optional parameter for Explore mode (QnAMode.Interactive) and mandatory for Render Result mode (QnAMode.ResultOnly)
};

// Get a reference to the embedded QNA HTML element
var qnaContainer = $('#qnaContainer')[0];

// Embed the QNA and display it within the div container.
var qna = powerbi.embed(qnaContainer, config);

질문 설정Set question

설정 질문과 함께 result mode를 사용하면 추가 질문을 프레임에 삽입하고 이전 결과를 대체하여 즉시 답변을 받도록 할 수 있습니다.If you used result mode with a set question, you can inject additional questions into the frame and have them immediately answered replacing the previous result. 새 질문과 일치하는 새 시각적 개체가 렌더링됩니다.A new visual is rendered matching the new question.

이런 사용의 한 가지 예는 질문과 대답 목록입니다.One example of this usage would be a frequently asked question list. 사용자가 질문을 검토하고 포함된 동일한 부분 내에 답변을 할 수 있습니다.The user could go through the questions and have them answered within the same embedded part.

JS SDK 사용을 위한 코드 조각:Code snippet for JS SDK usage:

// Get a reference to the embedded Q&A HTML element
var qnaContainer = $('#qnaContainer')[0];

// Get a reference to the embedded Q&A.
qna = powerbi.get(qnaContainer);

qna.setQuestion("This year sales")
    .then(function (result) {
        …….
    })
    .catch(function (errors) {
        …….
    });

시각적 개체가 렌더링된 이벤트Visual rendered event

대화형 모드의 경우 렌더링된 시각적 개체가 변경될 때마다 업데이트된 입력 쿼리를 대상으로 데이터가 변경된 이벤트를 사용하여 응용 프로그램에 통지할 수 있습니다.For interactive mode, the application can be notified with a data changed event each time the rendered visual changes to target the updated input query as it is being typed.

visualRendered 이벤트를 수신 대기하면 나중에 사용할 수 있도록 질문을 저장할 수 있습니다.Listening to the visualRendered event allows you to save questions for use later.

JS SDK 사용을 위한 코드 조각:Code snippet for JS SDK usage:

// Get a reference to the embedded Q&A HTML element
var qnaContainer = $('#qnaContainer')[0];

// Get a reference to the embedded Q&A.
qna = powerbi.get(qnaContainer);

// qna.off removes a given event listener if it exists.
qna.off("visualRendered");

// qna.on will add an event listener.
qna.on("visualRendered", function(event) {
     …….
});

embed 토큰Embed token

질문 및 답변 부분을 시작하려면 데이터 집합에서 embed 토큰 끄기를 만듭니다.Create an embed token off of a dataset to start a Q&A part. 자세한 내용은 질문 및 답변에 대한 토큰 생성을 참조하세요.For more information, see Generate token for Q&A.

다음 단계Next steps

질문 및 답변 포함을 시도해 보려면 JavaScript embed 샘플을 참조하세요.To give Q&A embedding a try, check out the JavaScript embed sample.

궁금한 점이 더 있나요?More questions? Power BI 커뮤니티에 질문합니다.Try asking the Power BI Community