대화 평가

대화 평가는 방문자의 AI 에이전트 사용 경험에 대한 피드백을 수집합니다. 활성화하면 대화가 끝날 때 경험을 평가하도록 요청하여 에이전트 성과를 개선할 수 있는 직접적인 신호를 얻습니다.

평가는 대시보드 대화 > 받은편지함의 각 대화 옆에 나타나며 대화 내보내기에도 포함됩니다. 이 데이터로 지식의 빈틈을 찾고 에이전트 설정을 다듬으며 시간에 따른 만족도 추세를 추적하세요.

대시보드 대화 > 인사이트 > 대화 평가에서 설정하세요.

대화 평가 설정 조회

권한 범위: read_all

GET https://app.quickchat.ai/v1/api/conversation_ratings/configuration

Shell

curl https://app.quickchat.ai/v1/api/conversation_ratings/configuration \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/conversation_ratings/configuration",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

응답 200 OK

{
  "conv_rating_active": true,
  "conv_rating_popup_active": true,
  "conv_rating_question_codes": ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]
}

필드	설명
conv_rating_active 불리언	대화 종료 시 방문자 피드백 수집 활성화
conv_rating_popup_active 불리언	피드백 요청 팝업 표시(conv_rating_active와 같아야 함)
conv_rating_question_codes 문자열 배열	표시할 피드백 질문 유형. 기본값: ["HELPFUL_THUMBS", "EXPERIENCE_THUMBS"]

대화 평가 설정 수정

권한 범위: write_all

PATCH https://app.quickchat.ai/v1/api/conversation_ratings/configuration

참고

conv_rating_active와 conv_rating_popup_active는 같은 값으로 설정해야 합니다.

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/conversation_ratings/configuration \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "conv_rating_active": true,
  "conv_rating_popup_active": true
}'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/conversation_ratings/configuration",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "conv_rating_active": True,
        "conv_rating_popup_active": True,
    },
)
data = response.json()

응답 200 OK: 수정된 대화 평가 설정을 반환합니다.

---