Dialogflow CX 에이전트는 최종 사용자와의 동시 실행 대화를 처리하는 가상 에이전트입니다. 이는 인간 언어의 미묘한 차이를 이해하는 자연어 이해 모듈입니다. Dialogflow CX는 대화 도중 최종 사용자의 텍스트나 오디오를 앱과 서비스가 이해할 수 있는 정형 데이터로 변환합니다. 시스템에 필요한 대화 유형을 처리하도록 Dialogflow CX 에이전트를 직접 설계하고 빌드할 수 있습니다.
Dialogflow CX 에이전트는 콜센터 상담사와 비슷합니다. 둘 다 예상되는 대화 시나리오를 처리하도록 학습해야 하며, 학습이 지나치게 명시적일 필요는 없습니다.
에이전트 만들기
에이전트를 만들려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- 프로젝트를 만들거나 선택합니다.
- 에이전트 만들기를 클릭합니다.
- 자동 생성을 선택하여 데이터 스토어 에이전트를 만들거나 자체 빌드를 선택하여 다른 종류의 에이전트를 만듭니다.
- 기본 에이전트 설정 양식을 작성합니다.
- 저장을 클릭합니다.
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 에이전트는 가상 에이전트의 설정 및 데이터를 위한 최상위 컨테이너 역할을 합니다. 다음 데이터는 에이전트와 연결됩니다.
다양한 수준에서 데이터가 적용되는 방식에 대한 자세한 내용은 데이터 애플리케이션 수준을 참조하세요.
스마트 엔드포인트
Speech-to-Text (STT)는 머신러닝을 사용하여 오디오를 텍스트로 변환하는 API로, 음성 인식을 애플리케이션에 통합할 수 있습니다.
지원되는 STT 모델에는 모든 긴 형식 모델 (예: phone_call)이 포함됩니다. en-US 언어만 지원됩니다.
에이전트에 스마트 엔드포인트가 사용 설정된 경우 대기 시간 초과를 설정하여 추가 시간을 지정함으로써 숫자 매개변수에 대해 스마트 엔드포인트 동작을 맞춤설정할 수 있습니다. 그러면 Dialogflow CX가 사용자가 추가 입력을 제공할 때까지 기다립니다.
대기 시간 제한은 음성 시간 제한이 트리거되기 전에 STT 스크립트에 무언가를 추가할 수 있는 유예 기간입니다. Dialogflow CX는 휴리스틱을 사용하여 스크립트를 기반으로 선택해야 하는 제한 시간을 지정합니다. 예를 들어 의도가 성공적으로 일치한 경우 매우 짧은 제한 시간을 선택할 수 있습니다. 인텐트가 일치하지 않으면 다른 말을 할 수 있도록 제한 시간을 늘리고 인텐트 일치를 다시 시도할 수 있습니다.
기타 STT 기능은 다음과 같습니다.
- 더 빠른 엔드포인팅: 실시간 분석은 오디오 텍스트 변환 스트리밍을 사용하여 STT 스트림이 열린 상태에서 자연스러운 일시중지와 발화 완료를 구분합니다. 사용자가 말을 마친 경우 Dialogflow CX는 더 빠른 응답을 제공하기 위해 스트림을 일찍 종료합니다.
- 자연스러운 대화형 피드백: 사용자가 발화 도중에 멈추면 Dialogflow CX가 STT 제한 시간을 동적으로 연장하여 조기 중단을 방지하거나 가상 에이전트가 계속 듣고 있음을 확인하기 위해 자연스러운 백채널링 신호 (예: '음', '네')를 삽입할 수 있습니다.
에이전트 내보내기 및 복원
에이전트를 파일로 내보낸 후, 이 파일로 에이전트를 복원할 수 있습니다.
에이전트 내보내기에는 다음을 제외한 모든 에이전트 데이터가 포함됩니다.
에이전트 복원 시 다음을 제외한 모든 대상 에이전트 데이터 (모든 흐름 버전 포함)를 덮어씁니다.
- 환경: 모든 커스텀 환경은 대상 에이전트에서 변경되지 않습니다. 대상 에이전트의 커스텀 환경에서 참조하는 흐름 버전은 연결된 환경이 존재하는 한 계속 존재합니다. 그러나 이러한 비활성 흐름 버전은 나열되지 않거나 에이전트에 대해 선택 가능한 흐름 버전이 아닙니다.
- 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에서 파일 형식을 자동으로 결정합니다.
에이전트를 내보내거나 복원하려면 다음 단계를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- 에이전트의 프로젝트를 선택합니다.
- 목록에서 에이전트의 메뉴 옵션 more_vert을 선택합니다.
- 내보내기 또는 복원 버튼을 클릭합니다.
- 안내에 따라 완료합니다.
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 내보내기/복원 가이드도 참조하세요.
에이전트 삭제
에이전트를 삭제하려면 전체 액세스 권한 또는 수정 액세스 권한을 제공하는 역할이 필요합니다. 자세한 내용은 액세스 제어 가이드를 참고하세요.
에이전트를 삭제하려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- 에이전트의 프로젝트를 선택합니다.
- 목록에서 에이전트의 메뉴 옵션 more_vert을 선택합니다.
- delete 버튼을 클릭합니다.
- 대화상자에서 삭제를 확인합니다.
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 에이전트와 데이터가 즉시 삭제됩니다.