에이전트

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Dialogflow CX 에이전트는 최종 사용자와의 동시 실행 대화를 처리하는 가상 에이전트입니다. 이는 인간 언어의 미묘한 차이를 이해하는 자연어 이해 모듈입니다. Dialogflow는 대화로 이루어진 최종 사용자의 텍스트 또는 오디오를 앱과 서비스가 이해할 수 있는 구조화된 데이터로 변환합니다. 시스템에 필요한 대화 유형을 처리하도록 Dialogflow 에이전트를 직접 설계하고 빌드할 수 있습니다.

Dialogflow 에이전트는 콜센터 상담원과 유사합니다. 둘 다 예상되는 대화 시나리오를 처리하도록 학습해야 하며, 학습이 지나치게 명시적일 필요는 없습니다.

에이전트 만들기

에이전트를 만들려면 다음 안내를 따르세요.

콘솔

  1. Dialogflow CX 콘솔을 엽니다.
  2. Google Cloud 프로젝트를 만들거나 선택합니다.
  3. 에이전트 만들기를 클릭합니다.
  4. 기본 에이전트 설정 양식을 작성합니다.
    1. 어떤 표시 이름이든 선택할 수 있습니다.
    2. 선호하는 위치를 선택합니다. 고급 위치 설정을 변경하려면 수정 버튼을 클릭합니다.
    3. 원하는 시간대를 선택합니다.
    4. 에이전트의 기본 언어를 선택합니다. 에이전트를 만든 후에는 기본 언어를 변경할 수 없습니다.
  5. 저장을 클릭합니다.

API

프로젝트의 위치 설정을 아직 구성하지 않은 경우 API를 사용하여 에이전트를 만들기 전에 콘솔에서 이러한 설정을 구성해야 합니다. 현재는 API를 사용하여 위치 설정을 구성할 수 없습니다.

에이전트를 만들려면 Agent 유형의 create 메서드를 참조하세요.

에이전트 참조의 프로토콜 및 버전 선택:

프로토콜 V3 V3beta1
REST 에이전트 리소스 에이전트 리소스
RPC 에이전트 인터페이스 에이전트 인터페이스
C++ AgentsClient 사용 불가능
C# AgentsClient 사용 불가능
Go AgentsClient 사용 불가능
자바 AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP 사용 불가능 사용 불가능
Python AgentsClient AgentsClient
Ruby 사용 불가능 해당 사항 없음

에이전트 데이터

Dialogflow 에이전트는 가상 에이전트의 설정 및 데이터를 위한 최상위 컨테이너 역할을 합니다.

에이전트의 데이터에 액세스하려면 다음 단계를 따르세요.

콘솔

  1. Dialogflow CX 콘솔을 엽니다.
  2. 에이전트의 Google Cloud 프로젝트를 선택합니다.
  3. 목록에서 에이전트를 찾습니다.
  4. 에이전트 표시 이름을 클릭합니다.
  5. 다른 가이드에 설명된 대로 흐름, 페이지 등을 업데이트합니다.

API

업데이트할 데이터는 가이드를 참조하세요.

다음 데이터는 에이전트와 연결됩니다.

다양한 수준에서 데이터가 적용되는 방식에 대한 자세한 내용은 데이터 애플리케이션 수준을 참조하세요.

에이전트 설정

에이전트 설정에 액세스하려면 다음 단계를 따르세요.

콘솔

  1. Dialogflow CX 콘솔을 엽니다.
  2. Google Cloud 프로젝트를 선택합니다.
  3. 에이전트를 선택합니다.
  4. 에이전트 설정을 클릭합니다.
  5. 원하는 대로 설정을 업데이트합니다.
  6. 저장을 클릭합니다.

API

Agent 유형은 getpatch/update 메서드를 참조하세요.

에이전트 참조의 프로토콜 및 버전 선택:

프로토콜 V3 V3beta1
REST 에이전트 리소스 에이전트 리소스
RPC 에이전트 인터페이스 에이전트 인터페이스
C++ AgentsClient 사용 불가능
C# AgentsClient 사용 불가능
Go AgentsClient 사용 불가능
자바 AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP 사용 불가능 사용 불가능
Python AgentsClient AgentsClient
Ruby 사용 불가능 해당 사항 없음

다음 하위 섹션에서는 다양한 에이전트 설정 카테고리에 대해 설명합니다.

일반 설정

에이전트가 사용할 수 있는 일반 설정은 다음과 같습니다.

  • 표시 이름

    사람이 읽을 수 있는 에이전트 이름입니다.

  • 시간대

    에이전트의 기본 시간대입니다.

  • 기본 언어

    에이전트에서 지원하는 기본 언어입니다. 에이전트를 만든 후에는 기본 언어를 변경할 수 없습니다. 하지만 다음을 수행할 수는 있습니다.

    1. 에이전트를 JSON 형식으로 내보냅니다.
    2. 다운로드한 파일을 압축해제합니다.
    3. agent.json 파일을 찾습니다.
    4. defaultLanguageCodesupportedLanguageCodes 필드를 원하는 값으로 업데이트합니다.
    5. 1단계부터 동일하거나 다른 에이전트로 에이전트를 복원합니다.
    6. 필요에 따라 언어별 학습 문구 및 개체 값을 업데이트합니다.
  • 에이전트 잠금

    • 에이전트 잠금

      에이전트가 잠겨 있는지 여부를 나타냅니다. 잠긴 에이전트를 수정할 수 없습니다.

  • 로그 기록 설정

    • Stackdriver Logging 사용 설정

      에이전트에 Cloud Logging이 사용 설정되었는지 나타냅니다.

    • 상호작용 로깅 사용 설정

      Google에서 품질 개선을 위해 보안 수정된 최종 사용자 쿼리를 수집하고 저장할지 여부를 나타냅니다.

  • BigQuery

    • BigQuery 내보내기 사용 설정

      BigQuery 내보내기가 사용 설정되어 있는지 여부를 나타냅니다.

    • BigQuery 데이터 세트

      BigQuery 데이터 세트 이름

    • BigQuery 테이블

      BigQuery 테이블 이름

다양한 수준에서 데이터가 적용되는 방식은 데이터 애플리케이션 수준을 참조하세요.

머신러닝(ML) 설정

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

다음과 같은 에이전트 전체 ML 설정을 사용할 수 있습니다.

  • ML의 맞춤법 수정 허용

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

    맞춤법 교정 기능은 Dialogflow에서 지원하는 모든 언어에 사용할 수 있지만 현재 특정 리전으로 제한됩니다.

    경고 및 권장사항:

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

다음과 같은 흐름별 ML 설정을 사용할 수 있습니다.

  • NLU 유형

    다음 중 하나일 수 있습니다.

    • 표준: 표준 NLU 기술
    • 고급: 고급 NLU 기술. 이 NLU 유형은 특히 대규모 에이전트와 흐름에서 표준보다 더 잘 작동합니다. 모델 학습은 표준 NLU를 사용하는 학습보다 시간이 오래 걸립니다.
  • 자동 학습

    사용 설정하면 콘솔로 업데이트될 때마다 흐름이 학습됩니다. 대규모 흐름의 경우 콘솔 UI가 지연될 수 있으므로 이 설정을 중지하고 대규모 흐름을 필요에 맞게 수동으로 학습해야 합니다.

  • 분류 임곗값

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

    인텐트 일치의 신뢰도 점수가 임곗값보다 작으면 불일치 이벤트가 호출됩니다.

  • 학습 상태

    흐름 데이터에 대한 최신 업데이트 이후에 흐름이 학습되었는지 여부를 나타냅니다.

  • NLU 학습

    이 버튼을 사용하여 흐름을 수동으로 학습합니다.

음성 및 IVR 설정

다음 음성 설정을 사용할 수 있습니다.

  • 음성 적응 사용

    자동 음성 적응을 참조하세요.

  • 고급 음성 설정

    이 섹션에서는 음성 기능을 위한 추가적인 고급 설정을 제공합니다. 고급 설정을 사용하거나 사용 중지할 수 있습니다. 이러한 설정은 에이전트 설정(전체 에이전트에 적용), 흐름 설정(전체 흐름에 적용되며 에이전트 설정을 재정의), 페이지 설정(페이지에 적용 및 흐름 및 에이전트 설정 재정의), fulfillment 설정(fulfillment에 적용 및 페이지, 흐름, 에이전트 설정을 재정의)에서 사용할 수 있습니다. 이러한 설정의 하위 집합은 수준의 설정 관련성에 따라 각 수준에서 사용할 수 있습니다.

    • 음성 끝 민감도

      최종 사용자 오디오 입력에서 음성의 끝을 인식하는 민감도를 제어합니다. 값의 범위는 0(낮은 민감도, 음성이 끝날 가능성이 작음)에서 100(높은 민감도, 음성이 끝날 가능성이 높음)까지입니다.

    • 음성 중지 제한 시간

      Dialogflow가 최종 사용자 오디오 입력 대기를 중지하는 시간(초)입니다. 기본값은 5초이며 최댓값은 60초입니다. 이 제한 시간 동안 Dialogflow는 no-input event를 호출합니다.

    • 통화 참여

      사용 설정하면 최종 사용자가 Dialogflow 응답 오디오를 중단할 수 있습니다. 중단되면 Dialogflow는 오디오 전송을 중지하고 다음 최종 사용자 입력을 처리합니다.

      메시지 큐에 여러 메시지가 있고, 통화 참여가 사용 설정된 페이지, 흐름, 에이전트와 연결된 fulfillment에서 메시지가 큐에 추가된 경우 큐의 다음 모든 메시지에서도 통화 참여가 사용 설정됩니다. 이 경우 통합 시 통화 참여가 사용 설정된 큐에 추가된 모든 메시지의 오디오 재생이 중지됩니다.

    • Google Cloud Storage URI

      제공되는 경우 요청과 연결된 모든 오디오 데이터가 Cloud Storage 버킷에 저장됩니다.

      저장되는 오디오 적용 가능한 요청
      최종 사용자 오디오 입력 DetectIntent, StreamingDetectIntent, AnalyzeContent, StreamingAnalyzeContent
      응답을 위해 합성된 텍스트 음성 변환(TTS) 오디오 AnalyzeContent, StreamingAnalyzeContent

      프로젝트의 다음 서비스 계정에 스토리지 객체 생성자 역할을 부여하세요.

      • 파트너 기본 제공 전화 통합을 사용하는 경우 one-click@df-cx-ALPHANUMERIC_VALUE-ALPHANUMERIC_VALUE.iam.gserviceaccount.com 형식의 서비스 계정

      • Dialogflow CX 전화 게이트웨이 통합을 사용하는 경우 service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com 형식의 서비스 계정에 연결합니다. IAM에서 이 서비스 계정을 찾으려면 Google 제공 역할 부여 포함 옵션을 선택합니다.

공유 설정

액세스 제어를 참조하세요.

언어 설정

에이전트에 언어 지원을 추가합니다. 전체 언어 목록은 언어 참조를 확인하세요.

보안 설정

보안 설정을 참고하세요.

고급 설정

현재 고급 설정만 감정 분석용입니다.

에이전트 내보내기 및 복원

에이전트를 파일로 내보낸 후, 이 파일로 에이전트를 복원할 수 있습니다.

에이전트 내보내기에는 다음을 제외한 모든 에이전트 데이터가 포함됩니다.

  • 흐름 버전: 초안 흐름만 파일로 내보냅니다.
  • 환경: 커스텀 환경은 파일로 내보내지 않습니다.

에이전트 복원은 다음을 제외한 모든 대상 에이전트 데이터(모든 흐름 버전 포함)를 덮어씁니다.

  • 환경: 모든 커스텀 환경은 대상 에이전트에서 변경되지 않습니다. 대상 에이전트의 커스텀 환경에서 참조하는 흐름 버전은 연결된 환경이 존재하는 한 계속 존재합니다. 그러나 이러한 비활성 흐름 버전은 에이전트에 나열되거나 선택할 수 있는 흐름 버전이 아닙니다.

내보낼 때 내보내기 파일 형식을 선택할 수 있습니다. 에이전트 데이터에 소스 제어 버전 관리를 사용하는 경우 JSON 형식으로 내보내야 합니다. 에이전트를 복원할 때 Dialogflow는 자동으로 파일 형식을 결정합니다.

에이전트를 내보내거나 복원하려면 다음 단계를 따르세요.

콘솔

  1. Dialogflow CX 콘솔을 엽니다.
  2. 에이전트의 Google Cloud 프로젝트를 선택합니다.
  3. 목록에서 에이전트의 옵션 메뉴를 클릭합니다.
  4. 내보내기 또는 복원 버튼을 클릭합니다.
  5. 안내에 따라 완료합니다.

API

Agent 유형은 exportrestore 메서드를 참조하세요.

에이전트 참조의 프로토콜 및 버전 선택:

프로토콜 V3 V3beta1
REST 에이전트 리소스 에이전트 리소스
RPC 에이전트 인터페이스 에이전트 인터페이스
C++ AgentsClient 사용 불가능
C# AgentsClient 사용 불가능
Go AgentsClient 사용 불가능
자바 AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP 사용 불가능 사용 불가능
Python AgentsClient AgentsClient
Ruby 사용 불가능 해당 사항 없음

에이전트 크기가 최대 한도를 초과하는 경우 에이전트 내보내기 및 복원에 Cloud Storage 옵션을 사용합니다.

GitHub를 사용하는 경우 GitHub 내보내기/복원 가이드도 참조하세요.

에이전트 삭제

에이전트를 삭제하려면 전체 액세스 권한 또는 수정 액세스 권한을 제공하는 역할이 필요합니다. 자세한 내용은 액세스 제어 가이드를 참조하세요.

에이전트를 삭제하려면 다음 안내를 따르세요.

콘솔

  1. Dialogflow CX 콘솔을 엽니다.
  2. 에이전트의 Google Cloud 프로젝트를 선택합니다.
  3. 목록에서 에이전트의 옵션 메뉴를 클릭합니다.
  4. 삭제 버튼을 클릭합니다.
  5. 대화상자에서 삭제를 확인합니다.

API

Agent 유형은 delete 메서드를 참조하세요.

에이전트 참조의 프로토콜 및 버전 선택:

프로토콜 V3 V3beta1
REST 에이전트 리소스 에이전트 리소스
RPC 에이전트 인터페이스 에이전트 인터페이스
C++ AgentsClient 사용 불가능
C# AgentsClient 사용 불가능
Go AgentsClient 사용 불가능
자바 AgentsClient AgentsClient
Node.js AgentsClient AgentsClient
PHP 사용 불가능 사용 불가능
Python AgentsClient AgentsClient
Ruby 사용 불가능 해당 사항 없음

프로젝트를 삭제하면 프로젝트와 관련된 모든 Dialogflow CX 에이전트와 데이터가 즉시 삭제됩니다.