Conversational Analytics API는 자연어를 사용하여 데이터를 쿼리할 수 있는 강력한 도구입니다. 이 페이지에서는 이상적인 출력을 위해 효과적인 질문을 형식화하는 방법을 안내합니다. 이 페이지에는 다음 작업에 대한 권장사항이 포함되어 있습니다.
일반적인 질문하기
일반적인 질문을 할 때는 구체적으로 질문하고 맥락을 제공하세요. 광범위한 질문 대신 날짜, 특정 카테고리, 숫자 필터와 같은 관련 세부정보를 포함하여 범위를 좁히세요.
예
원래 질문: '매년 수동으로 생성되는 인보이스와 시스템에서 생성되는 인보이스는 각각 몇 개야?'
구체적인 질문: '매년 수동으로 생성된 인보이스와 시스템에 의해 생성된 인보이스의 수를 알려 줘. 수동 인보이스 1개를 만드는 데 15분이 걸린다고 가정하고 모든 수동 인보이스를 처리하는 데 걸리는 총 시간을 시간 단위로 계산하여 요약해 줘'
효과적인 이유: 질문을 수정하여 구체적인 계산 요구사항(수동 인보이스에 소요된 시간)을 추가하고 출력 형식(요약)을 지정합니다.
더 복잡한 분석을 위해 여러 부분으로 구성된 질문하기
복잡한 질문을 여러 부분으로 나누어 Conversational Analytics API가 각 구성요소를 정확하게 처리하도록 지원합니다.
예
원래 질문: '각 수취 유형 (PHA, 협동조합 리베이트, 신용카드, 소매 미디어)의 상품 수령 및 결제 승인 시 현금의 평균 처리 기간은 며칠이며, 이 중 수동 승인 비율은 얼마인가요? 수동으로 정리된 각 수취 채권에 15분이 소요된다고 가정할 때, 매년 현금 앱에 소요되는 시간과 각 수취 채권 유형에 소요되는 시간은 얼마인가요?'
구체화된 질문, 1부: '2025년 5월 5일과 2025년 6월 1일 사이의 각 수취 유형의 평균 처리 기간은 며칠인가요?'
구체화된 질문, 2부: '2025년 5월 5일과 2025년 6월 1일 사이에 각 수취 유형에 대해 수동 정산이 차지하는 비율은 얼마인가요?'
구체화된 질문, 3부: '수동으로 처리된 각 수취 채권에 15분을 사용한다고 가정할 때 매년 현금 앱과 각 수취 채권 유형의 처리에 얼마나 많은 시간을 사용하고 있나요?'
효과적인 이유: 질문을 별도로 하면 대화형 분석 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가 결과를 텍스트로 반환하도록 안내
'요약'과 같은 핵심 용어를 사용하거나 간단한 답변만 필요한 질문을 하면 대화형 분석 API가 결과를 텍스트로 제공하도록 안내할 수 있습니다.
다음 질문은 결과가 텍스트 출력으로 반환되어야 함을 의미합니다.
'모든 수동 인보이스를 처리하는 데 걸린 총 시간을 시간 단위로 계산하여 요약해 줘.'
'지난주에 수동 인보이스를 처리하는 데 걸린 총시간은 얼마야?'
Conversational Analytics API가 결과를 선 그래프로 반환하도록 안내
질문에 '추세', '변화', '변화량'과 같은 핵심 용어를 사용하면 대화형 분석 API가 결과를 선 차트로 제공합니다.
다음 질문은 결과를 선 차트로 반환해야 함을 의미합니다.
'2024년 각 산업의 월별 기말 잔액 추세는 뭐야?'
'2025년 5월 2일과 2025년 6월 3일 사이의 전날 대비 일별 미결제 인보이스 평균 연령의 일일 변화량은 얼마야?'
Conversational Analytics API가 결과를 막대 또는 비교 차트로 반환하도록 안내
'비교', '차이'와 같은 핵심 용어를 사용하면 Conversational Analytics API가 결과를 막대 또는 비교 차트로 제공하도록 안내할 수 있습니다.
다음 질문은 결과가 막대 또는 비교 차트로 반환되어야 함을 의미합니다.
'전년도 말 대비 2025FP1 금액과 함께 고객 수취채권 잔액의 차액별 상위 업종을 제공해 줘.'
이 질문에 대한 결과는 각 업계의 분산을 표시하는 막대 그래프로 반환됩니다.
추가 리소스
추가 문제 해결 도움말과 자주 묻는 질문(FAQ)에 대한 답변은 대화형 분석 API에 관한 자주 묻는 질문(FAQ) 페이지를 참고하세요.
API 오류 및 잠재적 해결 방법에 대한 자세한 내용은 대화형 분석 API 오류 문제 해결 가이드를 참고하세요.