필터링

특성에서 직접 얻은 정보 또는 대화가 거친 작업의 속성을 기반으로 대화를 필터링할 수 있습니다.

대화 필터

다음 표의 특성 중 하나 이상을 기준으로 대화를 필터링할 수 있습니다. 이러한 필터는 대규모 대화 데이터 세트에서 검색 범위를 좁히는 데 유용합니다. 대화 목록 표시 페이지의 '필터링' 섹션에는 다음 필터를 적용하는 데 필요한 권한이 나열되어 있습니다.

참고: curl 명령어 또는 URL에서 큰따옴표(")를 사용하는 경우 백슬래시로 이스케이프 처리해야 하며 큰따옴표 뒤에 추가 공백이 없어야 합니다.

필터 용어	설명	참조 코드
에이전트 ID	고유한 에이전트의 문자열	agent_id="some agent_id" quality_metadata.agent_info.agent_id:"some agent_id"
상담사 팀	상담사 팀의 문자열	agent_team="some agent_team" quality_metadata.agent_info.teams:"some agent_team"
에이전트 유형	사람 또는 자동 에이전트	quality_metadata.agent_info.agent_type:"HUMAN_AGENT" quality_metadata.agent_info.agent_type="AUTOMATED_AGENT"
분석 생성 시간	분석이 생성된 시간	latest_analysis.create_time>"2023-12-31T16:00:10-08:00"
분석 상태	대화 분석 여부	분석됨: latest_analysis:"*" 분석되지 않음: -latest_analysis:"*"
대화 채널	대화의 매체: PHONE_CALL 또는 CHAT	medium="PHONE_CALL"
대화 생성 시간	대화가 CX Insights로 가져온 시간	create_time>"1969-12-31T16:00:10-08:00" create_time<="1969-12-31T16:00:20-08:00"
대화 라벨	대화에 할당된 라벨 또는 태그	labels:"key_only" labels.key_1:"value_1"
대화 시작 시간	대화가 시작된 시간	start_time>"1969-12-31T16:00:10-08:00" start_time>"1969-12-31T16:00:20-08:00"
대화 업데이트 시간	대화가 마지막으로 업데이트된 시간	update_time>"1969-12-31T16:00:10-08:00" update_time<="1969-12-31T16:00:20-08:00"
고객만족도 점수	고객 만족도 점수	quality_metadata.customer_satisfaction_rating>"1" quality_metadata.customer_satisfaction_rating<"5"
맞춤 강조 표시 (구문 일치 검색기라고도 함)	특정 문구를 표시하는 데 도움이 되는 맞춤 하이라이트	latest_analysis.analysis_result.call_analysis_metadata.phrase_matchers.id:"add_one_positive_custom_highlight" latest_analysis.analysis_result.call_analysis_metadata.phrase_matchers.id:"multiple positive custom highlights" -latest_analysis.analysis_result.call_analysis_metadata.phrase_matchers.id:"one_negative_custom_highlight" -latest_analysis.analysis_result.call_analysis_metadata.phrase_matchers.id:"multiple negative custom highlights"
데이터 소스	대화 소스가 Cloud Storage 또는 Dialogflow이거나 화면 녹화가 있음	data_source.gcs_source: "*" data_source.dialogflow_source: "*" data_source.screen_recordings.video_uri: "*"
Dialogflow 대화	가상 에이전트를 사용하여 Dialogflow를 통해 이루어진 대화	data_source.dialogflow_source.dialogflow_conversation="projects/123456789/locations/us-central1/conversations/some_dialogflow_conversation"
Dialogflow 대화 프로필 ID	고유한 Dialogflow 대화 프로필의 문자열	dialogflow_conversation_profile_id="some_dialogflow_conversation_profile_id"
기간	대화가 지속된 시간	duration<="20s"
언어	BCP-47 형식의 언어 코드와 지원되는 접두사를 사용하여 대화에서 사용된 음성 또는 입력 언어	language_code: "some_language_code"
최신 분석 생성 시간	최신 분석이 생성된 시간	latest_analysis.create_time>"1969-12-31T16:00:10-08:00" latest_analysis.create_time<$eq;"1969-12-31T16:00:20-08:00"
최신 요약	가장 최근 요약의 일부와 일치	latest_summary.text:"phrase to match" latest_summary.text:"and another" -latest_summary.text:"exclude this"
스코어카드	특정 스코어카드로 분석된 모든 대화	latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_scorecard_revision_id=projects/PROJECT_ID/locations/us-central1/qaScorecards/SCORECARD_ID
스코어카드 질문 답변	특정 스코어카드로 분석되고 질문에 대한 특정 답변을 생성하는 대화	latest_analysis.analysis_result.call_analysis_metadata.qa_scorecard_results.qa_answers.contains((qa_question="projects/PROJECT_ID/locations/LOCATION_ID/qaScorecards/SCORECARD_ID/revisions/REVISION_ID/qaQuestions/QUESTION"),(answer_value.str_value="ANSWER"))
감정 점수	대화의 평균 사용자 감정 점수	latest_analysis.analysis_result.call_analysis_metadata.sentiments.sentiment_data.score>"0.1" latest_analysis.analysis_result.call_analysis_metadata.sentiments.sentiment_data.score<"0.2"
음소거 시간	대화의 무음 시간	latest_analysis.analysis_result.call_analysis_metadata.silence.silence_duration>"10s" latest_analysis.analysis_result.call_analysis_metadata.silence.silence_duration<$eq;"20s"
스마트 하이라이트	특정 문구를 표시하는 데 도움이 되는 스마트 강조 표시	latest_analysis.analysis_result.call_analysis_metadata.intents.display_name:"one_positive_smart_highlight" latest_analysis.analysis_result.call_analysis_metadata.intents.display_name:"multiple positive smart highlights" -latest_analysis.analysis_result.call_analysis_metadata.intents.display_name:"one_negative_smart_highlight" -latest_analysis.analysis_result.call_analysis_metadata.intents.display_name:"multiple negative smart highlights"
요약 상태	요약이 생성되었는지 여부	요약이 있음: latest_summary:"*" 요약 없음: -latest_summary:"*"
주제 (문제라고도 함)	Topic Modeling으로 식별된 주제 또는 문제	latest_analysis.analysis_result.issues.issue="projects/123456789/locations/us-central1/issueModels/test_model/issues/issue_foo" latest_analysis.analysis_result.issue_model_id="projects/123456789/locations/us-central1/issueModels/test_model"
스크립트	대화 텍스트 일치	transcript.transcript_segments.text:"one_positive_term" transcript.transcript_segments.text:"multiple positive terms" -transcript.transcript_segments.text:"one_negative_term" -transcript.transcript_segments.text:"multiple negative terms"
턴 수	대화 차례 수	turn_count>"10" turn_count<="20"

작업 필터

또한 대화에 대해 실행된 작업에서 제공되는 정보를 기반으로 대화를 필터링할 수도 있습니다. 다음 작업 속성을 기반으로 대화 데이터 세트를 필터링할 수 있습니다.

필터 용어	설명	참조 코드
생성 시간	작업이 생성된 시간	metadata.create_time>"1969-12-31T16:00:10-08:00" metadata.create_time<="1969-12-31T16:00:20-08:00"
대화 ID	특정 대화의 문자열	metadata.conversation_id="some_conversation_id"
완료	작업의 최종 상태	완료: done="true" 완료되지 않음: done="false"
작업 유형	데이터 세트에서 수행된 작업 유형	작업 유형은 metadata.operation_type="BulkAnalyzeConversations"입니다. 작업 유형이 metadata.operation_type!="BulkAnalyzeConversations"이 아닙니다.
상태	작업의 세부 상태	성공적으로 완료됨: status_code="0" 실패했지만 중단되지 않음: status_code!="ABORTED"

일괄 작업을 실행할 때 발생하는 오류를 보려면 curl 명령어를 사용해야 합니다.

• 일괄 분석 작업:

  curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "Content-Type: application/json; charset=utf-8" "https://contactcenterinsights.googleapis.com/v1/projects/$PROJECT/locations/$LOCATION/operations?filter=metadata.operation_type=\"BulkAnalyzeConversations\"&page_size=10"

• 일괄 수집 작업 (스크립트 또는 오디오):

  curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "Content-Type: application/json; charset=utf-8"  "https://contactcenterinsights.googleapis.com/v1/projects/$PROJECT/locations/$LOCATION/operations?filter=metadata.operation_type=\"IngestConversations\"&page_size=10"