데이터 스토어 핸들러

데이터 스토어 핸들러는 웹사이트 콘텐츠 및 업로드된 데이터를 기반으로 LLM 생성 에이전트 응답을 제공할 수 있는 특수한 유형의 상태 핸들러입니다.

이 핸들러를 만들려면 에이전트를 만들 때 데이터 스토어를 제공합니다.

에이전트는 이러한 데이터 스토어 핸들러를 사용하여 최종 사용자와 콘텐츠에 대한 대화를 할 수 있습니다.

제한사항

다음과 같은 제한사항이 적용됩니다.

액세스 제어

프로젝트 소유자인 경우에는 데이터 스토어 핸들러를 만드는 데 필요한 모든 권한이 있습니다. 프로젝트 소유자가 아닌 경우 다음 역할이 부여되어 있어야 합니다.

  • Dialogflow 관리자
  • 검색 엔진 관리자

자세한 내용은 액세스 제어 가이드를 참고하세요.

에이전트 만들기

데이터 스토어 핸들러를 사용하는 에이전트를 만들려면 다음 단계를 따르세요.

  1. 아직 수행하지 않은 경우 설정 안내를 따르세요.
  2. 에이전트 빌더 콘솔로 이동합니다.

    에이전트 빌더 콘솔

  3. 콘솔 드롭다운에서 프로젝트를 선택합니다.

  4. API를 아직 활성화하지 않았으면 서비스 약관을 읽고 동의한 후 계속 및 API 활성화를 클릭합니다.

  5. 새 앱 만들기 또는 새 앱을 클릭합니다.

  6. 채팅을 선택합니다.

  7. 에이전트 구성 섹션에 회사 이름을 입력합니다.

  8. 시간대 및 언어 설정 섹션을 펼칩니다.

  9. 시간대를 선택합니다.

  10. 기본 언어를 선택합니다.

  11. 에이전트 이름 섹션에 에이전트 이름을 입력합니다.

  12. 에이전트 위치 섹션에서 리전 또는 멀티 리전을 선택합니다.

  13. 계속을 클릭합니다.

  14. 다음 중 하나를 수행하여 데이터 스토어를 에이전트에 연결합니다.

    • 이전에 만든 기존 데이터 스토어를 선택합니다.
    • 새 데이터 스토어를 만듭니다.
      1. 새 데이터 스토어 만들기를 클릭합니다.
      2. 데이터 소스를 선택합니다.
      3. 선택한 데이터 스토어 소스의 데이터와 구성을 입력합니다. 데이터 스토어 위치는 에이전트 위치와 일치해야 합니다.
      4. 만들기를 클릭하여 데이터 스토어를 만듭니다.
      5. 새 데이터 스토어를 선택합니다.
  15. 만들기를 클릭합니다.

  16. 이제 에이전트가 생성되었으며 사용 가능한 데이터 스토어 페이지로 자동 리디렉션됩니다. 여기에서 필요에 따라 데이터 스토어를 더 추가할 수 있습니다.

  17. 웹사이트용 새 데이터 스토어를 만든 경우 도메인을 확인해야 합니다.

  18. Dialogflow CX 콘솔로 에이전트를 열려면 왼쪽 패널에서 미리보기를 클릭합니다. 콘솔에서 데이터 스토어 핸들러를 수정 또는 추가하고 에이전트를 배포할 수 있습니다. 원하는 경우 데이터 스토어에서 다루지 않는 시나리오를 처리하는 흐름을 추가합니다.

에이전트 테스트

시뮬레이터를 사용하여 에이전트를 테스트할 수 있습니다.

에이전트 배포

에이전트를 배포하는 방법에는 여러 가지가 있습니다.

  • 가장 간단한 옵션은 에이전트에 사용자 인터페이스를 제공하는 통합을 사용하는 것입니다. 각 통합은 배포 안내를 제공합니다.

  • Dialogflow CX Messenger 통합은 데이터 스토어 핸들러에 특히 적합한 옵션입니다. 생성형 기능을 위한 옵션이 기본 제공됩니다.

  • 자체 사용자 인터페이스를 만들고 상호작용에 대화형 에이전트 (Dialogflow CX) API를 사용할 수 있습니다. 사용자 인터페이스 구현은 배포를 제어합니다.

특수 인텐트

상담사는 사용자가 제공하는 콘텐츠에 대한 질문을 처리하는 것 외에도 다음 유형의 질문을 처리할 수 있습니다.

  • 에이전트 식별: '누구인가요?' 또는 '사람인가요?와 같은 질문을 처리합니다.
  • 상담사에게 에스컬레이션: '사람과 이야기하고 싶어요' 또는 '실제 사람과 대화하고 싶어요'와 같은 질문을 처리합니다.

이는 자동으로 생성되는 인텐트인텐트 경로를 통해 수행됩니다.

기존 에이전트의 데이터 스토어 핸들러 추가 또는 수정

데이터 스토어 핸들러는 특수한 유형의 상태 핸들러입니다. 즉, 흐름 또는 페이지에 적용할 수 있으며 동일한 범위 규칙을 사용하여 평가됩니다.

데이터 스토어 핸들러를 추가하거나 수정하려면 다음 안내를 따르세요.

  1. Dialogflow CX 콘솔로 이동합니다.
  2. 프로젝트를 선택합니다.
  3. 에이전트를 선택합니다.
  4. 데이터 스토어 핸들러와 연결된 흐름을 선택합니다. 일반적으로 기본 시작 흐름입니다.
  5. 데이터 스토어 핸들러와 연결된 페이지를 선택합니다. 일반적으로 시작 페이지입니다.
  6. 페이지 데이터에서 상태 핸들러 추가를 클릭한 후 데이터 스토어를 선택합니다.
  7. 데이터 스토어를 만들어야 하는 경우 Vertex AI Agent Builder 사용자 인터페이스로 이동합니다. 선택하는 데 도움이 필요하면 데이터 스토어 정보를 참조하세요.
  8. 이미 데이터 스토어가 있으면 데이터 스토어 수정을 클릭합니다.
  9. 필요에 따라 업데이트하고, 완료되면 저장합니다. 데이터 스토어별 설정에 관한 내용은 아래를 참고하세요.

에이전트 응답

에이전트 응답 섹션에서 생성형 응답을 참조하는 커스텀 응답을 제공할 수 있습니다. 에이전트 말하기 섹션에서 $request.knowledge.questions[0]을 사용하여 생성형 답변을 제공합니다.

데이터 스토어 응답 옵션

생성형 답변에서 제공해야 하는 최대 보조 링크 수를 나타내도록 링크 최댓값 필드를 업데이트할 수 있습니다.