에이전트

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

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

에이전트 만들기

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

콘솔

  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 CX)는 가상 에이전트의 설정 및 데이터를 위한 최상위 컨테이너 역할을 합니다.

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

콘솔

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

API

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

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

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

에이전트 설정

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

콘솔

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

API

Agent 유형은 get 및 patch/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. defaultLanguageCode 및 supportedLanguageCodes 필드를 원하는 값으로 업데이트합니다.
    5. 1단계부터 동일하거나 다른 에이전트로 에이전트를 복원합니다.
    6. 필요에 따라 언어별 학습 문구와 항목 값을 업데이트합니다.

  • 에이전트 잠금

    • 에이전트 잠금

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

  • 로깅 설정

    • Cloud Logging 사용 설정

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

    • 상호작용 로깅 사용 설정

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

    • 동의 기반 최종 사용자 입력 수정 사용 설정

      이 설정을 사용 설정하면 특수 세션 파라미터를 사용하여 대화 기록 및 Cloud Logging에서 최종 사용자 입력과 파라미터가 수정되는지 여부를 제어할 수 있습니다. 기본적으로 세션 파라미터는 true입니다. 이 설정을 중지하면 수정이 수행되지 않습니다.

      불리언 세션 파라미터 $session.params.conversation-redaction을 사용하여 사용자 동의를 수집합니다. 이 설정이 사용 설정되어 있고 세션 파라미터가 false로 설정되면 수정이 수행되지 않습니다(다른 수정사항 전략은 계속 적용됨). 이 설정이 사용 설정되어 있고 세션 파라미터가 true로 설정되면 수정이 수행됩니다.

      동의 요청 흐름 예시는 다음과 같습니다. 먼저 사용자에게 최종 사용자 입력을 유지할지 묻고 응답을 인텐트 2개(하나는 '인텐트 있음'이고 다른 하나는 '인텐트 없음')와 일치시킵니다. 그런 다음 fulfillment에 있는 '인텐트 있음' 경로의 파라미터 사전 설정에서 세션 파라미터를 false(수정 없음)로, '인텐트 없음' 경로의 파라미터 사전 설정에서 true(수정 수행)로 설정합니다.

  • BigQuery 내보내기

    • BigQuery 내보내기 사용 설정

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

    • BigQuery 데이터 세트

      BigQuery 데이터 세트 이름

    • BigQuery 테이블

      BigQuery 테이블 이름

  • 인텐트 추천

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

  • 커스텀 페이로드 템플릿

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

머신러닝(ML) 설정

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

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

  • ML의 맞춤법 교정 허용

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

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

    경고 및 권장사항:

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

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

  • NLU 유형

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

  • 자동 학습

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

  • 분류 기준점

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

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

    에이전트에 사용 설정된 각 언어의 모든 흐름에 별도의 분류 임곗값을 설정할 수 있습니다. 이는 다양한 분류 임곗값에서 가장 우수한 성능을 보이는 언어를 수용하기 위함입니다. 다국어 에이전트를 만드는 방법에 대한 자세한 내용은 다국어 에이전트 문서를 참조하세요.

  • 학습 상태

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

  • NLU 학습

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

생성형 AI 설정

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

  • 일반

    • 차단된 문구

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

    • 안전 필터

      다양한 책임감 있는 AI(RAI) 카테고리에 따라 안전 필터 민감도 수준을 구성합니다. 콘텐츠는 다음과 같은 4가지 카테고리에 따라 평가됩니다.

      카테고리 설명
      증오심 표현 ID 또는 보호 속성을 대상으로 하는 부정적이거나 유해한 댓글
      위험한 콘텐츠 유해한 상품, 서비스, 활동을 홍보하거나 이에 대한 액세스를 지원
      음란물 성적 행위 또는 기타 외설적인 콘텐츠에 대한 언급 포함
      괴롭힘 다른 사람을 대상으로 위협하거나 괴롭히거나 모욕하는 악성 댓글

      유해할 가능성에 따라 콘텐츠가 차단됩니다. 카테고리마다 소수 차단, 일부 차단, 대부분 차단 중 하나를 선택하여 민감도 수준을 맞춤설정할 수 있습니다. 프로젝트에 대한 위험 확인 요청을 제출하고 승인을 받은 후에는 해당 카테고리의 RAI 검사를 중지하는 차단 안 함 제한 옵션에 액세스할 수도 있습니다.

      자세한 내용은 안전 속성 구성을 참조하세요.

    • 프롬프트 보안

      프롬프트 보안 검사 사용 설정 설정을 선택하여 프롬프트 보안 검사를 사용 설정할 수 있습니다. 사용 설정하면 에이전트가 프롬프트 인젝션 공격을 방지하려고 합니다. 이러한 공격은 에이전트 프롬프트의 일부를 공개하거나 에이전트가 제공해서는 안 되는 응답을 제공하는 데 사용될 수 있습니다. 이는 사용자 검색어가 악의적인지 확인하는 추가 LLM 메시지를 전송하여 실행됩니다.

      새 에이전트의 경우 이 설정은 기본적으로 사용 설정되어 있습니다. 이 설정이 출시되기 전에 에이전트가 생성된 경우에는 설정이 사용 설정되지 않습니다.

  • 생성형 에이전트

    • 생성형 모델 선택

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

  • 생성형 폴백

  • 데이터 저장소

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

음성 및 IVR 설정

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

  • Text-to-Speech

    • 음성 선택

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

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

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

  • Speech-to-Text

DTMF

자세한 내용은 전화 통합용 DTMF를 참조하세요.

멀티모달

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

공유 설정

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

언어 설정

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

언어 자동 감지

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

보안 설정

보안 설정을 참고하세요.

고급 설정

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

에이전트 내보내기 및 복원

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

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

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

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

  • 환경: 모든 커스텀 환경은 대상 에이전트에서 변경되지 않습니다. 대상 에이전트의 커스텀 환경에서 참조하는 흐름 버전은 연결된 환경이 존재하는 한 계속 존재합니다. 그러나 이러한 비활성 흐름 버전은 나열되지 않거나 에이전트에 대해 선택 가능한 흐름 버전이 아닙니다.
  • Vertex AI Agents 앱: Vertex AI Agents 앱과의 연결은 대상 에이전트에서 변경되지 않습니다. (즉 GenAppBuilderSettings의 engine 값) 결과 에이전트는 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 CX)에서 파일 형식을 자동으로 결정합니다.

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

콘솔

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

API

Agent 유형은 export 및 restore 메서드를 참조하세요.

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

프로토콜 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)와 데이터가 즉시 삭제됩니다.

이전
콘솔 개요
다음
흐름