에이전트

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

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

에이전트 만들기

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

콘솔

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

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. 필요에 따라 언어별 학습 문구와 항목 값을 업데이트합니다.
  • 에이전트 잠금

    • 에이전트 잠금

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

  • 로깅 설정

    • Cloud Logging 사용 설정

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

    • 상호작용 로깅 사용 설정

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

  • BigQuery 내보내기

    • BigQuery 내보내기 사용 설정

      BigQuery 내보내기가 사용 설정되었는지 나타냅니다.

    • BigQuery 데이터 세트

      BigQuery 데이터 세트 이름

    • BigQuery 테이블

      BigQuery 테이블 이름

  • 인텐트 추천

    인텐트 추천을 활성화할 수 있습니다.

  • 커스텀 페이로드 템플릿

    이 섹션에서는 커스텀 페이로드 템플릿에 대한 설명과 페이로드를 만들 수 있습니다.

머신러닝(ML) 설정

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

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

  • ML의 맞춤법 교정 허용

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

    맞춤법 교정 기능은 영어, 프랑스어, 독일어, 스페인어, 이탈리아어로 제공됩니다. 모든 Dialogflow CX 리전에서 사용할 수 있습니다.

    경고 및 권장사항:

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

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

  • NLU 유형

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

  • 자동 학습

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

  • 분류 기준점

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

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

  • 학습 상태

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

  • NLU 학습

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

생성형 AI 설정

다음과 같은 생성형 AI 설정을 사용할 수 있습니다.

  • 일반

    • 차단된 문구

      생성형 AI에서 차단된 문구 목록입니다. 차단된 문구가 프롬프트 또는 생성된 응답에 표시되면 생성이 실패합니다.

  • 생성형 에이전트

    • 생성형 모델 선택

      생성형 특성이 사용하는 모델을 선택합니다. 자세한 내용은 모델 버전을 참조하세요.

  • 생성형 폴백

  • 데이터 저장소

    데이터 스토어 에이전트 설정을 참조하세요.

음성 및 IVR 설정

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

  • Text-to-Speech

    • 음성 선택

      음성 합성에 사용되는 언어와 음성을 선택할 수 있습니다.

      음성 선택 드롭박스에서 커스텀 음성 옵션을 선택하고 해당 필드에 커스텀 음성 이름을 지정하여 에이전트에 커스텀 음성을 사용 설정할 수 있습니다. 커스텀 음성 이름은 projects/PROJECT_ID/locations/LOCATION/models/MODEL_NAME 패턴을 따라야 합니다.

      • 전화 게이트웨이를 사용하는 경우 커스텀 음성 프로젝트에서 Dialogflow Service Agent 서비스 계정 service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com에 'AutoML 예측자'가 부여되었는지 확인합니다.
      • 일반 API 호출의 경우 Dialogflow를 호출하는 데 사용되는 서비스 계정에 커스텀 음성 프로젝트의 'AutoML 예측자' 역할이 부여되었는지 확인합니다.
  • Speech-to-Text

    • 자동 음성 적응 사용 설정

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

    • 고급 음성 설정

      이 섹션에서는 음성 기능을 위한 추가적인 고급 설정을 제공합니다. 고급 설정을 사용하거나 사용 중지할 수 있습니다.

      이러한 설정은 에이전트 설정(전체 에이전트에 적용), 흐름 설정(전체 흐름에 적용되며 에이전트 설정을 재정의), 페이지 설정(페이지에 적용 및 흐름 및 에이전트 설정 재정의), fulfillment 설정(fulfillment에 적용 및 페이지, 흐름, 에이전트 설정을 재정의)에서 사용할 수 있습니다. 이러한 설정의 하위 집합은 수준의 설정 관련성에 따라 각 수준에서 사용할 수 있습니다.

      업데이트된 에이전트 수준 설정은 이러한 하위 수준에서 맞춤설정 옵션을 선택하면 흐름, 페이지, fulfillment 수준으로 전파되지 않습니다. 맞춤설정 옵션이 여러 설정을 포함하고 일부 설정만 업데이트하려는 경우, 에이전트 수준 설정과 동일하게 하려면 다른 설정을 업데이트해야 할 수 있습니다.

      • 모델 선택(Speech-to-Text)

        음성 인식에 사용되는 음성 모델을 설정합니다. 이 설정은 언어별로 적용되므로 언어마다 다른 모델을 선택할 수 있습니다. 또한 요청 수준 음성 모델 재정의를 선택하면 런타임 API 호출에서 다른 모델을 지정한 경우에도 선택한 모델이 사용됩니다.

        Dialogflow CX Phone Gateway는 제한사항을 참조하세요.

        자세한 내용은 음성 모델을 참조하세요.

      • 음성 끝 민감도

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

      • 고급 제한 시간 기반 음성 종료 민감도 사용 설정

        이 설정을 사용 설정하면 음성 종료 민감도 설정 값이 음성 종료를 결정하는 상대 오디오 무음 제한 시간을 설정하기 위한 게이지로 사용됩니다.

        이 설정이 사용 중지되면(기본값) Google Cloud Speech-to-Text에서 제공되는 ML 모델로 음성 종료를 결정할 수 있도록 음성 종료 민감도 설정 값이 사용됩니다.

        반면 음성 끝 민감도 설정은 기본적으로 en-US 언어 태그만 지원하며 제한 시간 기반의 고급 음성 끝 민감도 사용 설정 설정을 사용하면 Dialogflow에서 지원하는 모든 언어와 음성 모델의 음성 종료 민감도를 구성할 수 있습니다.

      • 스마트 엔드포인트 사용 설정

        이 설정을 사용하면 Dialogflow는 부분적인 사용자 입력을 분석하여 음성 종료를 결정합니다. 예를 들어 사용자가 '내가 원하는 것은'이라고 말하고 잠시 멈추면 Dialogflow는 사용자가 문장을 계속 말할 때까지 기다립니다.

        이는 사용자가 '1234'라고 말한 후 '5678'이라고 말하기 전에 잠시 멈출 수 있는 숫자 파라미터 수집에 특히 유용합니다. 특정 파라미터에 이 설정을 적용하려면 파라미터 형식으로 스마트 엔드포인트를 설정해야 합니다.

        en-US 언어 태그에만 사용할 수 있습니다.

        이 설정은 기본적으로 사용 중지되어 있습니다.

      • 음성 중지 제한 시간

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

      • 통화 참여

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

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

      • 부분 응답 재생 취소 허용

        부분 응답을 사용 설정하면 이 설정으로 부분 응답 재생을 취소할 수 있습니다. 메시지 큐의 메시지가 취소를 허용하는 fulfillment에 의해 생성된 경우 다른 메시지가 큐에 추가되면 메시지 재생이 취소됩니다. 초기 메시지의 재생이 시작되기를 원하지만 초기 메시지 재생이 완료되기 전에 작동 중인 웹훅에서 다른 메시지를 생성하면 재생을 취소하려는 경우에 유용합니다.

      • 오디오 내보내기 버킷

        제공되는 경우 요청과 연결된 모든 오디오 데이터가 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 제공 역할 부여 포함 옵션을 선택합니다.

      • DTMF: 전화 통합용 DTMF를 참조하세요.

멀티모달

통화 컴패니언을 참조하세요.

공유 설정

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

언어 설정

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

언어 자동 감지

언어 자동 감지를 구성하면 채팅 에이전트가 최종 사용자의 언어를 자동으로 감지하여 해당 언어로 전환합니다. 자세한 내용은 언어 자동 감지 문서를 참조하세요.

보안 설정

보안 설정을 참고하세요.

고급 설정

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

에이전트 내보내기 및 복원

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

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

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

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

  • 환경: 모든 커스텀 환경은 대상 에이전트에서 변경되지 않습니다. 대상 에이전트의 커스텀 환경에서 참조되는 흐름 버전은 연결된 환경이 존재하는 한 계속 존재합니다. 그러나 이러한 비활성 흐름 버전은 나열되지 않거나 에이전트에 대해 선택 가능한 흐름 버전이 아닙니다.
  • Vertex AI Agents 앱: Vertex AI Agents 앱과의 연결은 대상 에이전트에서 변경되지 않습니다. (즉 GenAppBuilderSettingsengine 값) 결과 에이전트는 Vertex AI Agents 앱에도 연결해야 하므로 이는 데이터 스토어 에이전트는 다른 기존 데이터 스토어 에이전트에만 복원할 수 있다는 것을 의미합니다.
  • Vertex AI Agents 데이터 스토어: 데이터 스토어에 대한 모든 참조는 다음 규칙에 따라 대상 에이전트에서 덮어쓰기됩니다.

    • 대상 에이전트가 앱과 연결되지 않은 경우 데이터 스토어 참조로 에이전트를 복원할 수 없습니다. 그렇게 하면 오류 메시지가 표시됩니다. 이 문제를 해결하려면 처음부터 새 데이터 스토어 에이전트를 만드세요. (또는 데이터 스토어 상태 핸들러를 추가하여 기존 에이전트를 데이터 스토어 에이전트로 전환할 수 있습니다. 이 경우 에이전트에 연결된 앱을 추가하는 과정을 안내합니다.
    • 대상 에이전트가 앱과 연결된 경우 복원 시 모든 데이터 스토어 참조가 업데이트됩니다. Google Cloud 프로젝트 ID와 위치는 대상 에이전트의 앱과 일치하도록 업데이트됩니다. 컬렉션 ID와 데이터 스토어 ID는 변경되지 않습니다. 즉, 복원 작업 전에 대상 에이전트의 앱에 일치하는 유형의 모든 ID에 대한 데이터 스토어를 추가해야 합니다.

    예를 들어 소스 에이전트가 projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1이라는 데이터 스토어를 참조하고 대상 에이전트의 앱 이름이 projects/321/locations/us-east1/collections/default_collections/engines/app123인 경우 결과 대상 에이전트의 데이터 스토어 참조는 projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1이 됩니다.

내보낼 때 내보내기 파일 형식을 선택할 수 있습니다. 에이전트 데이터에 소스 제어 버전 관리를 사용하는 경우 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 에이전트와 데이터가 즉시 삭제됩니다.