대화 필터링하기

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

대화 필터

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

필터 용어 설명 참조 코드
에이전트 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"