에이전트 설정

이 페이지에서는 에이전트에 적용할 수 있는 다양한 설정을 설명합니다. 이러한 설정에 액세스하려면 다음 안내를 따르세요.

  1. Dialogflow ES 콘솔로 이동합니다.
  2. 왼쪽 사이드바 메뉴의 상단 근처에 있는 에이전트를 선택합니다.
  3. 에이전트 이름 옆에 있는 설정 버튼을 클릭합니다.

에이전트 버전

에이전트는 기본적으로 Dialogflow 체험판 버전을 사용합니다. 에이전트의 버전을 변경하려면 다음 단계를 따르세요.

Console

  1. 왼쪽 사이드바 메뉴 맨 아래로 스크롤합니다. 여기에 에이전트 버전이 표시됩니다.
  2. 수정 또는 업그레이드 링크를 클릭합니다.
  3. 요금제 선택

API

프로젝트 리소스setAgent 메서드를 호출합니다. tier 필드에 "TIER_ENTERPRISE"를 제공하여 Dialogflow Essentials 버전으로 업그레이드하거나 "TIER_STANDARD"를 제공하여 Dialogflow 무료 체험판 버전으로 되돌립니다.

여러 프로젝트를 사용하는 경우 소비자 프로젝트가 할당량요금에 맞춰 버전을 결정하는 데 사용됩니다.

일반

일반 설정에 액세스하려면 일반 탭을 클릭합니다.

사용 가능한 설정은 다음과 같습니다.

  • 설명: 에이전트에 대한 설명입니다.
  • 기본 시간대: 에이전트의 기본 시간대입니다. 날짜 및 시간 요청은 API 요청에 시간대를 제공하지 않으면 이 시간대를 사용하여 해결됩니다.
  • 에이전트 아바타 URI: 일부 통합에서 사용하는 에이전트 아바타의 URI입니다.
  • Google 프로젝트: 에이전트에 연결된 GCP 프로젝트입니다.
  • 에이전트 웹훅 프로토콜 버전: V1 API 레거시 에이전트에만 표시됩니다. V2 API 웹훅 형식으로 전환할 수 있습니다.
  • 베타 기능: 에이전트에 베타 기능을 사용 설정하도록 전환합니다.
  • 로그 설정:

    • Dialogflow에 대한 상호작용 로깅:

      에이전트에 상호 작용 로깅이 사용 설정되었는지 나타냅니다.

    • Google Cloud에 대한 상호작용 로깅:

      에이전트에 Cloud Logging이 사용 설정되었는지 나타냅니다. Dialogflow에 대한 상호작용 로깅이 사용 설정된 경우에만 이 옵션을 사용할 수 있습니다. Dialogflow 로깅을 중지하면 이 설정도 중지됩니다. 로그 열기 링크를 클릭하여 Cloud Logging에서 에이전트 로그를 열 수도 있습니다.

  • 에이전트 삭제: 에이전트를 완전히 삭제하며, 이 작업을 취소할 수 없습니다. 에이전트를 다른 사용자와 공유하는 경우, 에이전트를 삭제하려면 먼저 에이전트에서 사용자를 삭제해야 합니다. 에이전트 관리를 참조하세요.

언어

언어 설정에 액세스하려면 언어 탭을 클릭합니다.

기본 언어와 여러 언어를 추가로 설정할 수 있습니다. 일부 루트 언어의 경우 언어를 한 개 이상 추가 할 수도 있습니다. 자세한 내용은 다국어 에이전트를 참조하세요.

ML 설정(머신러닝)

머신러닝 설정에 액세스하려면 ML 설정 탭을 클릭합니다.

Dialogflow 에이전트는 머신러닝 알고리즘을 사용하여 최종 사용자 표현을 이해하고, 인텐트와 일치시키고, 구조화된 데이터를 추출합니다. 에이전트는 개발자가 제공하는 학습 문구와 Dialogflow에서 기본 제공되는 언어 모델을 통해 학습합니다. 이 데이터를 기반으로 최종 사용자 표현과 일치시킬 인텐트에 대한 의사 결정 모델을 빌드합니다. 이 모델은 에이전트마다 고유합니다.

기본적으로 개발자가 인텐트와 항목을 변경하거나 에이전트를 가져오거나, 복원하거나, 학습시킬 때마다 Dialogflow는 에이전트의 머신러닝 모델을 업데이트합니다.

사용 가능한 설정은 다음과 같습니다.

  • ML 분류 임곗값: 거짓 양성 결과를 필터링하면서 에이전트에 일치하는 다양한 자연어 입력을 얻으려면 머신러닝 분류 임곗값을 조정하면 됩니다. 이 설정은 인텐트 일치에 필요한 최소 인텐트 감지 신뢰도를 제어합니다.

  • 자동 맞춤법 교정:

    이 기능이 사용 설정되어 있는 상태에서 사용자 입력 내용에 맞춤법이나 문법 오류가 있는 경우 인텐트는 입력이 정확하게 작성된 것처럼 일치됩니다. 인텐트 감지 응답에는 교정된 사용자 입력 내용이 포함됩니다. 예를 들어 사용자가 '샤과를 줘'라고 입력하더라도 '사과를 줘'로 입력한 것처럼 처리됩니다. 이 기능은 시스템과 커스텀 항목에 모두 관련된 일치 항목에도 적용됩니다.

    맞춤법 교정 기능은 Dialogflow에서 지원하는 모든 언어에서 사용 가능합니다.

    경고 및 권장사항:

    • 맞춤법 교정 기능은 ASR(자동 음성 인식) 오류를 교정하지 못하므로 ASR 입력을 사용하는 에이전트에는 이 기능을 사용 설정하지 않는 것이 좋습니다.
    • 교정된 입력 내용이 잘못된 인텐트와 일치할 수도 있습니다. 일반적으로 일치하지 않는 문구를 부정 예시에 추가하는 방식으로 이 문제를 해결할 수 있습니다.
    • 맞춤법 교정 기능은 에이전트의 응답 시간을 다소 지연시킵니다.
    • Actions on Google에서는 맞춤법 교정 기능을 사용할 수 없습니다.
    • 맞춤법 교정 기능은 일반적인 사용자 쿼리로 훈련되었습니다. 에이전트가 분야별 특수 용어를 사용하여 정의된 경우 교정 기능이 도움이 되지 않을 수 있습니다.
  • 자동 학습: 에이전트가 수정될 때마다 자동 에이전트 학습을 사용하거나 사용 중지합니다.

  • 에이전트 확인: 에이전트 확인 가이드를 참조하세요.

내보내기 및 가져오기

내보내기 및 가져오기 설정에 액세스하려면 내보내기 및 가져오기 탭을 클릭합니다.

이 기능을 사용하면 에이전트를 백업하거나 한 계정에서 다른 계정으로 전송할 때 ZIP 파일로 내보내거나 가져올 수 있습니다. JSON 파일을 직접 수정하고 다시 가져올 수 있지만 Dialogflow 콘솔 또는 API를 사용하여 수정해야 합니다. 이렇게 하면 시스템에서 변경사항이 검증되므로 문제를 최소한으로 유지할 수 있습니다.

사용할 수 있는 옵션은 다음과 같습니다.

  • ZIP 파일로 내보내기: 에이전트를 zip 파일로 내보냅니다.
  • ZIP 파일에서 복원: 현재 에이전트를 제공된 zip 파일로 덮어씁니다.
  • ZIP 파일에서 가져오기: 제공된 zip 파일의 인텐트와 항목을 현재 에이전트에 추가합니다. 기존 인텐트나 항목의 이름이 zip 파일과 동일하면 대체됩니다.

이러한 옵션은 에이전트 초안에 적용됩니다. 에이전트 버전을 내보내려면 먼저 초안에 로드하세요.

다음 사항 에이전트 내보내기에 포함됩니다.

  • 인텐트
  • 항목
  • 대부분의 에이전트 설정(제외된 설정은 아래 목록 참조)

다음은 에이전트 내보내기에 포함되지 않으며, 가져오거나 복원할 때 덮어쓰기되지 않습니다.

에이전트 가져오기/복원에 필요한 최대 에이전트 크기(압축되지 않은 콘텐츠)는 50MB를 초과할 수 없습니다.

환경

환경 설정에 액세스하려면 환경 탭을 클릭합니다.

버전 및 환경을 사용하면 여러 버전의 에이전트를 별도의 맞춤설정 가능한 환경에 배포할 수 있습니다. 자세한 내용은 버전 및 환경을 참조하세요.

음성

음성 설정에 액세스하려면 음성 탭을 클릭합니다.

음성 인식과 음성 합성의 설정입니다. 사용 가능한 설정은 다음과 같습니다.

  • 음성 인식 품질 개선
  • TTS(텍스트 음성 변환)
    • 자동 TTS(텍스트 음성 변환) 사용 설정: 모든 대화에서 자동으로 기본 텍스트 응답을 음성으로 변환합니다. 오디오 출력으로 인텐트 감지를 참조하세요.
    • 음성 구성:
      • 에이전트 언어: 음성 합성의 기본 언어를 선택합니다.
      • 음성: 음성 합성 모델을 선택합니다.
      • 말하기 속도: 음성의 말하기 속도를 조정합니다.
      • 높낮이: 목소리의 높낮이를 조정합니다.
      • 볼륨 게인: 오디오의 볼륨 게인을 조정합니다.
      • 오디오 효과 프로필: 합성된 음성에 적용할 오디오 효과 프로필을 선택합니다. 음성 오디오는 선택한 프로필(예: 헤드폰, 대형 스피커, 전화 통화)과 연결된 기기에 최적화됩니다. 사용 가능한 프로필 목록은 TTS(텍스트 음성 변환) 문서에서 생성된 오디오에 기기 프로필 사용을 참조하세요.

공유

공유 설정에 액세스하려면 공유 탭을 클릭합니다.

이 설정을 사용하여 다른 개발자와 에이전트 액세스를 공유할 수 있습니다. 자세한 내용은 액세스 제어를 참조하세요.

고급

고급 설정에 액세스하려면 고급 탭을 클릭합니다.

현재 이 설정에서는 단 하나의 기능만 제어 가능합니다. 자세한 내용은 감정 분석을 참조하세요.