에이전트

대화형 에이전트(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

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

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

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

에이전트 내보내기 및 복원

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

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

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

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

  • 환경: 모든 커스텀 환경은 대상 에이전트에서 변경되지 않습니다. 대상 에이전트의 커스텀 환경에서 참조하는 흐름 버전은 연결된 환경이 존재하는 한 계속 존재합니다. 그러나 이러한 비활성 흐름 버전은 나열되지 않거나 에이전트에 대해 선택 가능한 흐름 버전이 아닙니다.
  • 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)와 데이터가 즉시 삭제됩니다.

이전
Agent Builder 콘솔 개요
다음
플레이북