Conversational Analytics API는 자연어를 사용하여 데이터를 쿼리할 수 있는 강력한 도구입니다. 이 페이지에서는 이상적인 출력을 위해 효과적인 질문 형식을 지정하는 방법을 안내합니다. 이 페이지에는 다음 작업에 대한 권장사항이 포함되어 있습니다.
일반적인 질문하기
일반적인 질문을 할 때는 구체적으로 질문하고 컨텍스트를 제공하세요. 광범위한 질문 대신 날짜, 특정 카테고리, 숫자 필터와 같은 관련 세부정보를 포함하여 범위를 좁히세요.
예
원래 질문: '매년 수동으로 생성되는 인보이스와 시스템에서 생성되는 인보이스는 각각 몇 개야?'
구체적인 질문: '매년 수동으로 생성되는 인보이스와 시스템에서 생성되는 인보이스의 수를 알려줘. 수동 인보이스 1개를 만드는 데 15분이 걸린다고 가정하고 모든 수동 인보이스를 처리하는 데 걸리는 총 시간을 시간 단위로 계산하여 요약해 줘'
효과적인 이유: 미세 조정된 질문에서는 구체적인 계산 요구사항(수동 인보이스에 소요된 시간)을 추가하고 출력 형식을 요약으로 지정합니다.
더 복잡한 분석을 위해 여러 부분으로 구성된 질문하기
복잡한 질문을 여러 부분으로 나누어 Conversational Analytics API가 각 구성요소를 정확하게 처리하도록 지원합니다.
예
원래 질문: '각 미수금 유형(PHA, 협동조합 리베이트, 신용카드, 리테일 미디어)의 상품 인도 결제 및 결제 청산의 평균 처리 기간은 며칠이며, 이 중 수동 청산은 몇 퍼센트야? 수동으로 청산되는 각 미수금에 15분이 소요된다고 가정할 때, 매년 결제 앱에 쓰는 시간은 얼마이고 각 미수금 유형을 청산하는 시간은 얼마야?
미세 조정된 질문, 첫 번째 부분: '2025년 5월 5일부터 2025년 6월 1일까지 각 미수금 유형의 평균 처리 기간은 며칠이야?'
미세 조정된 질문, 두 번째 부분: '2025년 5월 5일부터 2025년 6월 1일까지 각 미수금 유형의 수동 청산 비율은 얼마야?'
미세 조정된 질문, 세 번째 부분: '수동으로 청산되는 각 미수금에 15분이 소요된다고 가정할 때, 매년 결제 앱에 쓰는 시간은 얼마이고 각 미수금 유형을 청산하는 시간은 얼마야?'
효과적인 이유: 질문을 별도로 물어보면 Conversational Analytics API가 각 특정 측정항목(평균 처리 시간, 수동 청산 비율, 총 소요 시간)에 적절한 필터를 적용하여 더 정확한 결과를 얻을 수 있습니다.
데이터 조건으로 질문하기
데이터 조건이 포함된 질문을 할 때는 정확한 날짜, 숫자 제한, 구체적인 카테고리 등 필요한 필터와 조건을 모두 질문에 명시하세요. Conversational Analytics API가 올바른 필터(예: 기간, 상위 N개 결과, 특정 카테고리)를 적용하는지 확인합니다.
예시
다음 질문은 필터 기준을 올바르게 지정합니다.
'2025년 5월 2일부터 2025년 6월 3일까지의 인보이스 날짜와 미결제 인보이스의 평균 경과 기간만 보여 줘.' 이 질문은 기간을 명확하게 지정합니다.
'46일이 지난 레코드의 고객 이름, 미결제 잔액 합계, 평균 경과 기간, 미수금 유형을 알려줘. 미결제 잔액을 기준으로 결과를 최대 5개 레코드로 제한해 줘.' 이 질문은 레코드 경과 기간을 지정하고, 한도를 제공하고, 정렬 요구사항을 제공합니다.
'고객 미수금 잔액의 차액별 상위 산업을 제공하고 2025FP1 금액을 전년도 말과 비교해 줘.' 이 질문은 '상위 산업'과 비교 기간을 지정합니다.
데이터 집계 요청
데이터를 집계하기 위해 질문할 때는 집계 유형(예: '미결제 잔액 합계' 또는 '평균 경과 기간')과 집계할 측정기준(예: '고객 이름', '미수금 유형' 또는 '산업')을 지정하세요.
예
다음 질문은 데이터 집계에 대한 명확한 요구사항을 효과적으로 지정합니다.
'46일이 지난 레코드의 고객 이름, 미결제 잔액 합계, 평균 경과 기간, 미수금 유형을 알려줘.'
후속 질문
후속 질문을 할 때는 이전에 설정된 컨텍스트를 참조하되 변경사항이나 추가사항을 명시적으로 언급하세요. 예를 들어 기간이나 한도를 변경하려면 새 파라미터를 명확하게 명시하세요.
예시
원래 질문: '46일이 지난 레코드의 고객 이름, 미결제 잔액 합계, 평균 경과 기간, 미수금 유형을 알려줘. 미결제 잔액을 기준으로 결과를 최대 5개 레코드로 제한해 줘.'
후속 질문: '90일이 지난 레코드의 이전 측정항목을 제공하고 상위 10개 레코드로 제한해 줘.'
이유: 후속 질문에서는 '경과 기간' 필터와 결과 한도에 대한 변경사항을 명확하게 지정하고 컨텍스트를 위해 이전 질문과 동일한 측정항목을 참조합니다.
형식 지정된 결과 요청
결과 형식을 지정하지 않은 질문을 물어보면 Conversational Analytics API가 질문에 제공된 특정 기준과 핵심 용어에 가장 적합한 형식을 결정합니다.
질문에 핵심 용어를 포함하여 Conversational Analytics API가 다음 형식으로 결과를 제공하도록 안내할 수 있습니다.
Conversational Analytics API가 결과를 테이블로 반환하도록 안내
다음 질문은 측정기준 및 측정항목 열 이름을 지정하므로 결과를 테이블 형식으로 반환해야 함을 의미합니다.
'46일이 지난 레코드의 고객 이름, 미결제 잔액 합계, 평균 경과 기간, 미수금 유형을 알려줘.'
Conversational Analytics API가 결과를 텍스트로 반환하도록 안내
'요약'과 같은 핵심 용어를 사용하거나 간단한 답변만 필요한 질문을 하면 Conversational Analytics API가 결과를 텍스트로 제공하도록 안내할 수 있습니다.
다음 질문은 결과를 텍스트 출력으로 반환해야 함을 의미합니다.
'모든 수동 인보이스를 처리하는 데 걸린 총 시간을 시간 단위로 계산하여 요약해 줘.'
'지난주에 수동 인보이스를 처리하는 데 걸린 총시간은 얼마야?'
Conversational Analytics API가 결과를 선 차트로 반환하도록 안내
질문에 '추세', '변화', '델타 변화'와 같은 핵심 용어를 사용하면 Conversational Analytics API가 결과를 선 차트로 제공합니다.
다음 질문은 결과를 선 차트로 반환해야 함을 의미합니다.
'2024년 각 산업의 최종 잔액에 대한 월별 추세는 어때?'
'2025년 5월 2일부터 2025년 6월 3일까지 전날 대비 일별 미결제 인보이스 평균 경과 기간의 일일 델타 변화는 얼마야?'
Conversational Analytics API가 결과를 막대 그래프 또는 비교 차트로 반환하도록 안내
'비교', '차이'와 같은 핵심 용어를 사용하면 Conversational Analytics API가 결과를 막대 그래프 또는 비교 차트로 제공하도록 안내할 수 있습니다.
다음 질문은 결과를 막대 그래프 또는 비교 차트로 반환해야 함을 의미합니다.
'고객 미수금 잔액의 차액별 상위 산업을 제공하고 2025FP1 금액을 전년도 말과 비교해 줘.'
이 질문에 대한 결과는 각 산업의 분산을 표시하는 막대 그래프로 반환됩니다.
추가 리소스
추가 문제 해결 도움말과 자주 묻는 질문(FAQ)에 대한 답변은 Conversational Analytics API에 관한 자주 묻는 질문(FAQ) 페이지를 참조하세요.
API 오류 및 잠재적 해결 방법에 대한 자세한 내용은 Conversational Analytics API 오류 문제 해결 가이드를 참조하세요.