문제 해결

이 문서의 콘텐츠를 에이전트 유형 태그로 필터링합니다.

카테고리 태그로 이 문서 콘텐츠를 필터링합니다.

API 호출에서 거부된 권한을 가져옴

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: API, Auth

문제

API 호출에 대한 PERMISSION_DENIED 응답을 수신했습니다.

해결책

(대화형 에이전트(Dialogflow CX), Dialogflow ES) 인증 및 역할이 올바르게 설정되었는지 확인합니다. 특히 다음을 수행했는지 확인합니다.

  • 서비스 계정을 만들었으며 실수로 삭제하지 않았습니다.
  • 서비스 계정에 원하는 메서드를 호출할 수 있는 권한을 부여하는 역할을 할당했습니다.
  • 서비스 계정의 비공개 키 파일을 다운로드했습니다.
  • GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 비공개 키 파일에 설정했습니다.

API 호출에 알 수 없는 프로젝트가 멘션됨

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: API, 프로젝트

문제

API 호출에 대한 Dialogflow API has not been used in project 32555940559 오류가 수신되었습니다.

해결책

다음을 수행했는지 확인합니다.

  • GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정했습니다(PERMISSION_DENIED 참조).
  • API 호출에 올바른 프로젝트 ID를 제공했습니다.

API 호출에 잘못된 사용자 인증 정보 오류가 발생함

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: API, Auth

문제

API 호출에 대해 Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. 응답을 수신했습니다.

해결책

기본이 아닌 리전을 지정하면서 클라이언트 라이브러리를 사용하여 수동으로 사용자 인증 정보를 만들었기 때문일 수 있습니다. 다음 링크 중 하나를 참조하세요.

API 호출 응답이 다른 호스트로의 전환을 요청

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: API, Auth

문제

API 호출에 대한 Please switch to 'REGION-dialogflow.googleapis.com' to access resources located in 'REGION' 응답을 수신했습니다. 여기서 REGION은 특정 리전 ID입니다.

해결책

엔드포인트가 아닌 요청에서 리전을 지정할 때 이러한 문제가 발생합니다. 다음 링크 중 하나를 참조하세요.

API 호출 응답에서 필드 누락

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: API

문제

API 응답에서 일부 필드가 누락되었습니다.

해결책

API 응답에서 특정 필드에 숫자 값이 필요할 때 반환된 값이 0이면 응답에 해당 필드가 누락될 수 있습니다.

기본값 동작(비숫자 값 포함)에 대한 자세한 내용은 다음을 참조하세요.

선취권으로 인해 프로젝트를 삭제할 수 없음

에이전트 유형 태그: Dialogflow ES
카테고리 태그: 프로젝트

문제

Google Cloud 프로젝트를 삭제하려고 하면, 프로젝트에 선취권이 있고, 선취권 중 하나가 Dialogflow ES와 관련이 있으므로 프로젝트를 삭제할 수 없다는 알림을 받습니다.

해결책

  1. 프로젝트와 연결된 Dialogflow ES 에이전트가 더 이상 필요하지 않은지 확인합니다. 에이전트가 없다는 알림을 받으면 이미 삭제된 것입니다.

    Dialogflow ES 콘솔

    https://dialogflow.cloud.google.com/#/agent/project-id/intents를 엽니다.

    이 링크는 Google Cloud 프로젝트 삭제 대화상자의 링크와 다릅니다.

    Dialogflow API

    agent 유형의 search 메서드를 사용합니다.

  2. 선취권 이름을 가져옵니다.

    gcloud

    프로젝트의 선취권 나열 문서의 설명대로 gcloud alpha resource-manager liens list 명령어를 사용합니다.

    API 탐색기

    메서드: liens.list 페이지에서 API 사용해 보기 패널을 사용합니다.

    • 파라미터 설명의 제안대로 parent 필드를 작성합니다.
    • 실행을 클릭합니다.
  3. 선취권을 삭제합니다.

    gcloud

    프로젝트에서 선취권 삭제 문서의 설명대로 gcloud alpha resource-manager liens delete LIEN_NAME 명령어를 사용합니다.

    API 탐색기

    메서드: liens.delete 페이지에서 API 사용해 보기 패널을 사용합니다.

    • name 필드에 2단계에서 가져온 선취권 이름을 입력합니다.
    • 실행을 클릭합니다.
  4. 프로젝트를 종료합니다.

Dialogflow CX 웹훅이 기한 초과 오류로 실패

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 유형: 런타임

문제

Dialogflow CX에서 호출된 웹훅이 다음 오류 메시지와 함께 실패할 수 있습니다.

Webhook call failed. Error: DEADLINE_EXCEEDED

이 오류는 웹훅 호출이 웹훅 제한 시간 한도를 초과하기 때문에 발생할 수 있습니다. 다음과 같은 이유로 웹훅 호출이 제한 시간 한도를 초과할 수 있습니다.

  1. 존재하지 않는 인텐트를 트리거하려고 함

  2. 웹훅 백엔드의 콜드 스타트 문제(예: Cloud Functions)

  3. 웹훅이 다른 서비스를 호출하여 응답 시간을 늘림

  4. 에이전트와 웹훅 백엔드 간에 연결이 없음(예: 잘못 구성된 부하 분산기)

  5. 인그레스 트래픽 또는 Dialogflow 메서드 실행을 방지하는 조직 정책

해결 방법

웹훅에는 기본적으로 5초 제한 시간 한도가 있습니다. 웹훅 리소스를 만들거나 수정할 때 웹훅 제한 시간 한도를 늘리면 웹훅이 응답하는 데 더 많은 시간을 제공할 수 있습니다.

콘솔에서 프로젝트 설정 실패

에이전트 유형 태그: Dialogflow ES
카테고리 태그: 콘솔, 프로젝트

문제

콘솔로 에이전트를 만들 때 Failed to set up GCP project 오류가 수신되었습니다.

해결책

Google Cloud 프로젝트를 만들 권한이 없을 수 있습니다. Google Cloud 콘솔에서 직접 Google Cloud 프로젝트를 만들 수 있는지 확인합니다. 프로젝트를 만들 수 없는 경우 오류 메시지에 제공된 권장사항을 따르세요.

응답에 표시된 세션 파라미터 참조

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 태그: 콘솔

문제

Dialogflow에서 반환된 응답에는 파라미터 값 대신 파라미터 참조가 포함됩니다. 예를 들면 다음과 같습니다.
Hello, $session.params.customer_name

파라미터가 확인되지 않고 현재 세션에서 파라미터를 찾을 수 없거나 파라미터가 유형에 따라 사용되지 않는 경우 파라미터 참조가 표시됩니다.

해결책

이 문제는 사용 중인 파라미터가 대화에 포함되지 않았거나, 오타가 있거나, 사용된 유형과 다른 경우에 발생할 수 있습니다.

API가 사용 설정되지 않은 경우 콘솔에서 에이전트 생성 실패

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 태그: 콘솔

문제

콘솔로 에이전트를 만들 때 Dialogflow API has not been enabled for the project. Code: FAILED_PRECONDITION 오류가 수신되었습니다.

해결책

설정 단계에 따라 Dialogflow API를 사용 설정합니다.

조직 계정에서 콘솔에 액세스하려고 시도할 때 서비스 오류 수신

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: 콘솔

문제

조직 계정에서 콘솔에 액세스하려고 할 때 You don't have access to this service 오류가 발생합니다.

해결책

조직의 시스템 관리자에게 연락하여 조직 설정에 따라 콘솔에 액세스가 제공되는지 확인합니다.

조직 설정에 따라 액세스가 허용되고 다른 조직에서 계정을 마이그레이션한 경우에는 계정이 Google에서 제한된 계정으로 플래그 지정되었을 수 있습니다. 조직의 다른 사용자는 콘솔에 액세스할 수 있는데 사용자가 액세스할 수 없으면 이 문제 때문일 수 있습니다. 지원팀에 연락하여 지원을 받으세요.

흐름이 누락되어 JSON 형식으로 에이전트를 내보낼 수 없음

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 태그: 콘솔

문제

원시 바이트로 에이전트 내보내기가 성공적으로 완료되지만 JSON 형식으로 에이전트를 내보내면 다음과 유사한 오류 메시지가 표시되면서 실패합니다.

Flow 'projects/PROJECT_ID/locations/LOCATION_ID/agents/AGENT_ID/flows/FLOW_ID' does not exist
in the agent

이 문제는 삭제된 흐름을 참조하는 테스트 사례로 인해 발생할 수 있습니다.

해결책

이 문제를 해결하려면 사용되지 않은 테스트 사례를 살펴보고 오류 메시지에 참조된 흐름이 테스트 사례에 사용되고 있는지 확인합니다. 그런 다음 확인된 테스트 사례를 삭제합니다.

Phone Gateway 연결

에이전트 유형 태그: Dialogflow ES
카테고리 태그: 통합

문제

전화 게이트웨이를 사용하면 통화 중인 신호를 받거나 통화가 끊깁니다.

해결책

이 기능에는 할당량 및 한도가 있습니다. 통화 중 신호음이 들리거나 통화가 끊기면 할당량이 초과되었을 수 있습니다.

Dialogflow CX Messenger에서 응답 없음

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 태그: 통합

문제

Dialogflow CX Messenger 상호작용에 대한 에이전트 응답이 없습니다.

해결책

Dialogflow CX 메신저의 응답이 표시되지 않으면 프로젝트에서 결제와 Dialogflow API가 프로젝트에 사용 설정되었는지 확인합니다. 설정 안내를 참조하세요.

항목 동의어가 아닌데 파라미터 값이 일치함

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: NLU

문제

일반적인 사례: 파라미터에 해당하는 항목에 동의어로 일치하는 값이 포함되지 않은 경우에도 파라미터 값이 런타임에 추출됩니다.

보다 구체적인 사례: 동의어가 항목에서 삭제되고 에이전트가 다시 학습된 다음에도 이 동의어가 이 항목에 대한 파라미터 값으로 추출됩니다.

해결책

  1. 검색 옵션을 사용하여 일치하는 값이 에이전트에 암시적 항목(대화형 에이전트(Dialogflow CX), Dialogflow ES)으로 표시될 수 있는지 확인합니다. 이 파라미터와 항목이 포함된 주석이 있는 모든 인텐트를 찾습니다.

  2. 원치 않는 일치 값을 나타내는 텍스트에 이러한 주석이 적용되지 않도록 주석을 수정합니다.

  3. 런타임에 에이전트를 테스트하여 문제가 해결되었는지 확인합니다.

  4. 문제가 계속되면 고급 항목 설정에서 자동 확장퍼지 일치 옵션을 선택 해제하고 에이전트를 다시 테스트합니다.

음성 봇이 일부 응답을 건너뜀

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 태그: Text-to-Speech

문제

텍스트 및 음성 모두를 위해 설계된 에이전트의 경우 음성 봇이 일부 응답을 읽지 않습니다.

해결책

특정 대화 차례에 최소 하나 이상의 출력 오디오 텍스트 응답이 정의된 경우 이 대화 차례의 모든 단계에서 에이전트의 fulfillment 및 웹훅 응답을 통해 출력 오디오 텍스트 옵션이 일관되게 제공되었는지 확인합니다.

SSML 태그가 적용되지 않음

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: Text-to-Speech

문제

SSML 태그가 에이전트 fulfillment에 정의되었지만 음성 봇이 SSML 효과 없이 조합된 텍스트를 읽습니다.

해결책

Dialogflow 콘솔에서 <speak></speak> 쌍이 하나의 응답 카드별로 또는 응답이 API 또는 웹훅을 통해 제공된 경우 하나의 응답 메시지 객체별로 하나만 제공되었는지 확인합니다.

음성 에이전트가 0을 문자 O로 발음

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 태그: Text-to-Speech

문제

음성용으로 설계된 에이전트에서 음성 에이전트가 0을 숫자 0이 아닌 문자 O로 읽습니다.

해결책

  1. 출력 오디오 텍스트 대화 옵션을 사용하도록 에이전트 말하기를 변경합니다.
  2. SSML 체크박스를 선택합니다.
  3. 텍스트를 SSML 태그로 묶습니다.
      <speak>
        <say-as interpret-as='verbatim'>YOUR_TEXT</say-as>
      </speak>
  4. 저장을 클릭합니다.

예를 들어 신용카드 번호에서 0은 제로로 발음됩니다.

      <speak>
        <say-as interpret-as='verbatim'>5177 7702 8500 4578</say-as>
      </speak>
   

예기치 않은 조합 발음

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: Text-to-Speech

문제

에이전트 응답의 조합 발음(예: 고유 명사, 두문자어)이 예상과 다릅니다.

해결책

일반적으로 알려지지 않은 단어의 특정 발음을 보장하기 위해서는 에이전트 응답에서 SSML say-as 또는 phoneme 태그를 사용합니다.

허용되는 최대 상태 머신 실행 단계 도달

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 유형: 런타임

문제

에이전트에 런타임 요청을 전송할 때 대화형 에이전트(Dialogflow CX) 콘솔 또는 로그에 다음 오류 메시지가 수신되었습니다.

You have reached the maximum allowed state machine execution steps. You may consider simplifying your agent/flow design. Current execution steps are: [<array_of_objects>]

오류 메시지의 배열에는 요청의 실행 단계 목록이 포함됩니다. 단계 수가 너무 많으면 목록이 완전하지 않을 수 있습니다.

해결책

이 오류 메시지는 일반적으로 단일 대화 차례의 전환 수가 너무 많음을 나타냅니다. 일반적인 예시는 무한 루프를 발생시키는 동일한 페이지로의 전환입니다.

이 문제를 해결하려면 다음 안내를 따르세요.

  1. 오류 메시지에서 JSON 배열을 복사합니다.
  2. (선택사항) 가독성 향상을 위해 복사한 배열을 간결한 JSON 형식으로 지정합니다. 오류 메시지가 잘렸으면 마지막 "단계" 객체를 검색하고, 완전하지 않은 단계 객체 및 이전 쉼표를 삭제하고, 닫는 배열 브래킷을 추가한 후 JSON을 검증하고 간결하게 만듭니다.
  3. 각 단계에 대해 "TriggeredTransitionRouteId""TargetPage" 값을 확인합니다. 무한 루프의 경우 "TriggeredTransitionRouteId""TargetPage" 필드에 대부분의 단계에 대한 반복 값이 포함됩니다.
  4. 에이전트 설계를 수정하여 무한 루프 전환을 삭제하거나 단일 대화 차례의 전환 수를 줄입니다.

너무 광범위한 정규 표현식 일치

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: 정규식

문제

정규 표현식 항목(대화형 에이전트(Dialogflow CX), Dialogflow ES)을 만들 때 Regular expression match is too broad 오류가 발생했습니다.

해결책

다음과 같은 접근 방식을 고려해 보세요.

  • 정규 표현식에서 ^$를 사용하여 각각 텍스트의 시작과 끝을 나타냅니다.
  • 필수 파라미터와 함께 정규 표현식 항목을 사용합니다(대화형 에이전트(Dialogflow CX), Dialogflow ES).
  • 최종 사용자에게 주변 단어 없이 항목 값만 제공하도록 요청하는 필수 파라미터 프롬프트를 정의합니다.

음성 인식에 의해 삽입된 바람직하지 않은 영숫자 문자

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: Speech-to-Text

문제

영숫자 문자를 매칭할 때 원치 않는 영숫자가 아닌 문자(공백, 대시 등)가 음성 인식기에 삽입되므로 항목이 일치하지 않습니다.

해결책

  1. 일치하는 숫자에 시스템 항목을 사용하는 경우 정규 표현식 항목(대화형 에이전트(Dialogflow CX), Dialogflow ES)을 대신 사용하는 것이 좋습니다.
  2. 정규 표현식 항목에 의한 부정확한 영숫자 문자 음성 인식 섹션의 모든 관장 사항을 따릅니다.
  3. 전화 통합을 통한 번호 일치의 경우 음성 인식 외에도 DTMF 옵션을 고려합니다.

음성 입력에 빈 스크립트 반환

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: Speech-to-Text

문제

음성 입력에 대한 Dialogflow 응답이 빈 스크립트를 반환합니다. 요청이 입력 없음 또는 일치 없음으로 처리됩니다.

해결책

오디오 녹음을 듣고 음성이 포함되어 있는지 확인합니다.

에이전트 설정(대화형 에이전트(Dialogflow CX), Dialogflow ES)에서 음성 적응이 사용 설정되어 있는지 확인합니다.

음성 적응을 사용 설정해도 도움이 되지 않는다면 비프로덕션 설정에서 다음 음성 모델을 실험하고 최상의 결과를 렌더링하는 모델을 사용합니다.

  • latest_short
  • phone_call
  • command_and_search

영어 이외의 언어인 경우 Speech-to-Text 지원 언어 문서에서 지원되는 음성 모델을 찾습니다.

음성 모델을 지정하는 방법은 Dialogflow와의 상호작용을 설정하는 방식에 따라 다릅니다.

  • API 요청의 경우 InputAudioConfigmodel 필드에 모델 이름을 제공합니다(대화형 에이전트(Dialogflow CX), Dialogflow ES).

  • Phone Gateway(대화형 에이전트(Dialogflow CX), Dialogflow ES)를 사용하는 경우 통합을 사용 설정했을 때 Dialogflow에서 생성된 대화 프로필에서 음성 모델을 업데이트할 수 있습니다.

    1. 대화 프로필 ID를 검색합니다.

      • conversationProfiles.list 메서드를 사용하여 프로젝트에 연결된 모든 대화 프로필을 검색합니다.
      • 업데이트하려는 대화 프로필을 찾고 name 필드 값을 복사합니다.

      Dialogflow CX Phone Gateway의 경우 통합 설정에서 대화 프로필 표시 이름을 찾을 수 있습니다. Dialogflow ES Phone Gateway의 경우 대화 프로필 표시 이름은 통합이 사용 설정된 에이전트 이름에 해당합니다.

      표시 이름이 동일한 대화 프로필이 여러 개 있는 경우 conversationProfiles.list 메서드 응답의 automatedAgentConfig 필드에 있는 에이전트 ID를 확인합니다.

    2. conversationProfiles.patch API 메서드를 사용하여 SpeechToTextConfigmodel 필드를 업데이트합니다.

  • Contact Center AI 통합의 경우 전화 통합업체에 문의하여 통합 또는 개별 요청에서 음성 모델을 업데이트하는 방법을 확인하세요.

에이전트 버전을 비교할 때 '파일 크기가 2MB를 초과합니다'라는 오류가 표시된 빈 화면

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX)
카테고리 태그: 콘솔

문제

두 가지 에이전트 버전을 비교하려고 하면 다음과 같은 오류 메시지와 함께 빈 화면으로 바뀝니다.

File size exceeds 2MB

이 문제는 크기가 2MB를 초과하는 파일 중 하나로 인해 발생합니다.

해결책

파일 중 하나의 크기가 2MB를 초과하는 에이전트 버전을 비교하려면 API 메서드 compareVersion을 사용하는 것이 좋습니다.

정규 표현식 항목의 부정확한 영숫자 음성 인식

에이전트 유형 태그: 대화형 에이전트(Dialogflow CX), Dialogflow ES
카테고리 태그: Speech-to-Text, 정규식

문제

정규 표현식 항목(대화형 에이전트(Dialogflow CX), Dialogflow ES)과 일치하도록 설계된 영숫자 음성 입력에 대한 부정확한 텍스트 변환이 수신되었습니다.

해결책

  1. 에이전트 설정(대화형 에이전트(Dialogflow CX), Dialogflow ES)에서 음성 적응이 사용 설정되어 있는지 확인합니다.
  2. 적어도 하나의 항목이 모든 정규식 항목 요구사항(대화형 에이전트(Dialogflow CX), Dialogflow ES)을 따르는지 확인합니다.
  3. 특정 패턴에는 가장 구체적인 정규 표현식을 사용해야 합니다. 예를 들어 2자리 문자로 시작하고 5자리 숫자로 시작하는 영숫자 문자의 경우 [a-zA-Z0-9]{7} 대신 [a-zA-Z]{2}\d{5}를 사용합니다.
  4. 정규 표현식 항목이 음성 인식기에 의해 삽입될 수 있는 영숫자가 아닌 문자 일치(공백, 대시 등)를 허용하는지 확인합니다. 이 목록의 요구사항 #2를 충족하려면 여러 항목을 만듭니다. 하나는 이 목록의 요구사항 #2를 충족하는 항목이고 다른 하나는 영숫자 문자가 아닌 경우에 대한 항목입니다. 예를 들어 5자리 숫자를 일치시키고 영숫자가 아닌 문자를 허용하는 경우 다음과 같습니다.
     \d{5}
     (\d[^a-zA-Z0-9]*){5}
    
  5. 에이전트가 파라미터 정의 요구사항(대화형 에이전트(Dialogflow CX), Dialogflow ES)을 따르는지 확인합니다.

    대화형 에이전트(Dialogflow CX) 예시

    대화형 에이전트(Dialogflow CX)의 필수 매개변수

    Dialogflow ES 예시

    Dialogflow ES의 필수 매개변수
  6. 에이전트가 학습 문구 주석 요구사항(대화형 에이전트(Dialogflow CX), Dialogflow ES)을 따르는지 확인합니다.

    Dialogflow ES 예시

    Dialogflow ES의 학습 문구에 주석 없음
  7. 테스트가 테스트 가이드라인(대화형 에이전트(Dialogflow CX), Dialogflow ES)을 따르는지 확인합니다.
  8. 음성 인식기에 의해 삽입되었을 수 있는 영숫자가 아닌 문자를 삭제하려면 다음을 사용합니다.
  9. 음성 적응 제한(대화형 에이전트(Dialogflow CX), Dialogflow ES)을 확인합니다.