이 페이지에서는 Agent Assist 스마트 작성 기능을 사용하기 위한 권장사항을 간략하게 설명합니다. API를 직접 호출하여 이 기능을 구현하는 방법에 관한 자세한 내용은 스마트 작성 안내 가이드를 참고하고, Agent Assist 콘솔을 사용하여 이 기능을 구현하는 방법에 관한 안내는 콘솔 튜토리얼을 참고하세요.
용어
스마트 작성에서는 다음 용어를 사용합니다.
추천 기본 텍스트
이 섹션에서는 Agent Assist에 사용되는 용어를 정의합니다.
추천의 기본 텍스트는 스마트 작성에서 완성된 텍스트에 대한 추천을 생성하는 데 사용하는 부분적으로 입력된 텍스트입니다. 이 텍스트는 SuggestSmartComposeAnswersRequest의 current_text_input.text에 있습니다.
예: 상담사가 'Ho'를 입력하면 'how are you'가 추천될 수 있습니다. 이 경우 'Ho'는 기본 텍스트이고 'how are you'는 추천입니다.
추천 확장 텍스트
추천의 확장 텍스트는 추천과 기본 텍스트를 병합하여 구성됩니다. 기본 텍스트에 제안의 접두사와 일치하는 접미사가 포함된 경우 일치하는 부분이 병합됩니다. 스마트 작성은 대소문자를 구분하지 않는 방식으로 접미사와 접두사를 일치시킵니다. 거짓 음성을 방지하려면 기본 텍스트의 접미사와 일치하는 비어 있지 않은 접두사가 있는 경우에만 추천을 표시하는 것이 좋습니다.
예: 기본 텍스트가 'Ho'이고 추천이 'how are you'인 경우 추천 확장 텍스트는 'How are you'가 됩니다.
사용 가능한 추천
다음과 같은 경우 추천이 사용 가능한 추천입니다.
- 추천의 기본 텍스트는 이미 입력된 텍스트의 접두사입니다.
- 입력된 텍스트가 추천의 확장 텍스트의 접두사이지만 확장 텍스트와 같지 않습니다.
예: 이미 입력된 텍스트가 'how a'인 경우 기본 텍스트 'Ho'가 포함된 'how are you' 제안은 사용 가능한 제안이지만 이미 입력된 텍스트가 'h' 또는 'how are you'인 경우 사용 가능한 제안이 아닙니다.
추천 요청
사용 가능한 추천으로 아직 처리되지 않은 새 문자가 입력될 때마다 서버에서 suggestSmartComposeAnswers 요청을 전송하도록 하는 것이 좋습니다. 이렇게 하면 스마트 작성 제안이 생성될 가능성이 높아집니다. 이로 인해 qps가 높아질 수 있습니다. 할당량 한도로 인해 요청이 제한되는 경우 Google에 문의하여 해결 방법을 논의하세요. 요청을 구성할 때 max_results=3을 설정하여 가져온 추천 수를 늘리는 것이 좋습니다.
추천 선택
추천 선택은 상담사 UI에서 스마트 작성을 구현하기 전에 구현해야 하는 중요한 기능입니다. 입력은 빠르게 이루어지며 스마트 작성 제안에는 약간의 지연 시간이 있습니다. 따라서 제안이 상담사 UI에 도달할 때 유효하지 않을 수 있습니다. 이 문제를 최소화하려면 사용 가능한 추천의 하위 집합만 UI에 렌더링하는 것이 좋습니다. 입력된 텍스트에 대해 다음과 같은 경우 추천을 선택해야 합니다.
- 입력된 텍스트에 사용할 수 있는 제안입니다.
- 기본 텍스트의 문자 수가 사용 가능한 모든 추천 중 가장 많습니다.
- 가장 긴 기본 텍스트가 동일한 추천이 여러 개 있는 경우 추천 순위가 가장 높은 옵션을 선택합니다.
워크플로 예:
- 에이전트가 'Ho'를 입력합니다.
- 현재 메시지 'Ho'와 함께 요청이 전송됩니다.
- 상담사가 계속해서 'How'를 입력했습니다.
- {"안녕하세요", "잘 지내시나요", "오늘 기분은 어떠신가요?"}라는 제안 (원래 항목 'Ho'에 기반) 에이전트 UI에 도달합니다.
- 이 경우 상담사가 다른 단어를 입력했으므로 'Hope you'는 더 이상 유효한 추천이 아닙니다. 대신 '안녕하세요'가 제안되어야 합니다.
캐싱
캐싱을 키-값 맵으로 구현하는 것이 좋습니다. 이때 접두사를 키로 사용하고 API에서 반환된 추천을 값으로 사용합니다. 지도에서 에이전트 입력과 일치하는 키를 확인해야 합니다. 지도에 일치하는 키가 포함되어 있지 않으면 매번 지도를 확인하면서 에이전트 입력의 끝에서 문자를 한 번에 하나씩 삭제해야 합니다. 일치하는 추천이 발견되거나, 에이전트 입력에서 삭제할 문자가 더 이상 없거나, 반복 한도에 도달할 때까지 (50회 반복이 적절한 수치임) 계속해야 합니다. 일치하는 키가 발견되면 추천을 반복해야 합니다. 추천이 유효한지 확인하기 위해 키 (접두사의 하위 문자열)와 추천이 병합된 후 에이전트 입력과 비교됩니다. 병합된 제안과 상담사 입력은 첫 번째 문자부터 완전히 겹쳐야 합니다. 그렇지 않은 경우 다음 제안을 확인해야 합니다.
캐싱을 사용하는 예:
- 상담사가 'H'를 입력합니다.
- 키-값 맵에서 'H' 접두사의 제안을 확인합니다. 입력 끝에서 삭제할 문자가 더 이상 없으므로 'H'에 대한 추천 요청이 이루어집니다.
- '상담사'가 'Ho'를 계속 입력합니다.
- 키-값 맵에서 'Ho' 접두사에 대한 제안이 확인됩니다. 없으면 키-값 맵에서 'H' 접두사에 대한 추천을 확인합니다. 입력 끝에서 삭제할 문자가 더 이상 없으므로 'Ho'에 대한 추천 요청이 이루어집니다.
- 2단계에서 전송된 요청에서 추천이 없는 응답이 수신되고 응답이 'H' 키의 캐시에 추가됩니다.
- 4단계에서 전송된 요청으로부터 {'Hope you', 'how are you', 'How are you doing today?'} 제안이 포함된 응답이 수신되고 제안이 'Ho' 키의 캐시에 추가됩니다.
- 키-값 맵에서 'Ho' 접두사에 대한 제안을 확인합니다. 제안이 있습니다. 제안은 키와 제안이 병합되고 '에이전트' 입력에 대해 확인되는 방식으로 루프됩니다. '상담사' 입력 'Ho'가 첫 번째 추천 'Hope you'와 겹치므로 상담사에게 'pe you' 추천이 표시됩니다.
- '에이전트'가 'How'를 계속 입력합니다.
- 키-값 맵에서 'How' 접두사에 대한 제안을 확인합니다. 추천이 없으며, 키-값 맵에서 'Ho'라는 접두사에 대한 추천을 확인한 결과 추천이 있습니다. 제안은 키와 제안이 병합되고 '상담사' 입력에 대해 확인되는 방식으로 루프됩니다. '상담사' 입력 'How'가 첫 번째 추천 'how are you'와 겹치므로 상담사에게 'are you' 추천이 표시됩니다.
대화 기록
스마트 작성은 대화 기록을 기반으로 작동합니다. analyzeContent API를 통해 스마트 답장 또는 기타 Agent Assist 기능을 사용하는 경우 이미 보장 대상에 포함됩니다. 그렇지 않으면 suggestSmartComposeAnswers를 사용하여 스마트 작성 제안을 가져오기 전에 완료된 모든 메시지에서 analyzeContent API를 호출해야 합니다. 자세한 내용은 스마트 작성 안내 가이드를 참고하세요.