복잡한 대화상자에는 여러 가지 대화 주제가 포함되는 경우가 많습니다. 예를 들어 피자 배달 에이전트는 음식 주문, 고객 정보, 확인을 별도의 주제로 가질 수 있습니다. 각 주제마다 에이전트가 최종 사용자로부터 관련 정보를 얻기 위해 여러 차례 대화를 해야 합니다.
흐름은 이러한 주제와 연결된 대화 경로를 정의하는 데 사용됩니다. 모든 에이전트에는 기본 시작 흐름이라는 흐름이 있습니다. 간단한 에이전트에는 이 단일 흐름만 필요할 수 있습니다. 보다 복잡한 에이전트에 추가 흐름이 필요할 수 있으며, 다른 개발팀이 이러한 흐름을 빌드하고 유지관리할 수 있습니다. 예를 들어 피자 배달 에이전트의 흐름은 다음과 같습니다.
기본 시작 흐름
에이전트를 만들 때 기본 시작 흐름이 자동으로 생성됩니다. 간단한 에이전트의 경우 이 흐름을 유일한 흐름으로 사용할 수 있습니다. 보다 복잡한 에이전트의 경우 흐름을 더 추가할 수 있으며 기본 시작 흐름을 대화의 간단한 진입점으로 사용할 수 있습니다.
API를 사용할 경우 다음 흐름 ID로 기본 시작 흐름을 참조할 수 있습니다.
00000000-0000-0000-0000-000000000000
흐름 시작 페이지
모든 흐름에는 콘솔에 시작이라는 특별한 페이지가 있습니다. 콘솔에서 흐름을 선택하면 시작 페이지가 그래프의 노드로 표시됩니다. 흐름이 처음 활성화되면 이 페이지는 현재 활성 페이지가 됩니다.
시작 페이지에는 일반 페이지와 같은 매개변수나 응답 메시지가 없습니다. 그러나 다음 방법 중 하나를 사용하여 메시지를 보낼 수 있습니다.
- 인텐트 전파
- fulfillment 응답 또는 전환 타겟이 있는 경로에서 간단한
true조건을 사용하거나 항목 fulfillment가 있는 일반 페이지로 이동합니다. - 커스텀 이벤트
API 요청의 참조 시작 페이지
런타임 API 요청에서 흐름의 시작 페이지를 참조하려면 START_PAGE를 페이지 ID로 사용하세요.
API를 통해 시작 페이지를 디자인 시 변경하려면 Flow 유형에 get 및 patch/update API 메서드를 사용합니다.
흐름 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 흐름 리소스 | 흐름 리소스 |
| RPC | 흐름 인터페이스 | 흐름 인터페이스 |
| C++ | FlowsClient | 해당 사항 없음 |
| C# | FlowsClient | 해당 사항 없음 |
| Go | FlowsClient | 해당 사항 없음 |
| 자바 | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | FlowsClient | FlowsClient |
| Ruby | 없음 | 해당 사항 없음 |
흐름 만들기
흐름을 만들려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 흐름 섹션에서 추가 add 버튼을 클릭합니다.
- 흐름 만들기를 선택합니다.
- 흐름의 표시 이름을 입력합니다.
- 방금 만든 흐름을 클릭합니다.
API
Flow 유형은 create 메서드를 참조하세요.
흐름 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 흐름 리소스 | 흐름 리소스 |
| RPC | 흐름 인터페이스 | 흐름 인터페이스 |
| C++ | FlowsClient | 해당 사항 없음 |
| C# | FlowsClient | 해당 사항 없음 |
| Go | FlowsClient | 해당 사항 없음 |
| 자바 | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | FlowsClient | FlowsClient |
| Ruby | 없음 | 해당 사항 없음 |
흐름 데이터
흐름 데이터에 액세스하려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- 에이전트의 Google Cloud 프로젝트를 선택합니다.
- 목록에서 에이전트를 찾습니다.
- 에이전트 표시 이름을 클릭합니다.
- Flows(흐름) 섹션에서 흐름을 클릭합니다.
- 흐름 페이지는 페이지 섹션에 입력됩니다. 페이지 수정 방법에 대한 자세한 내용은 페이지 가이드를 참조하세요.
- 그래프에서 흐름을 클릭합니다.
- 흐름 수정 패널이 나타납니다. 이 패널을 사용하여 추가 흐름 데이터를 찾아보고 수정합니다.
- 저장을 클릭하여 변경사항을 저장합니다.
API
흐름의 경우 Flow 유형은 get 및 patch/update를 참조하세요.
흐름 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 흐름 리소스 | 흐름 리소스 |
| RPC | 흐름 인터페이스 | 흐름 인터페이스 |
| C++ | FlowsClient | 해당 사항 없음 |
| C# | FlowsClient | 해당 사항 없음 |
| Go | FlowsClient | 해당 사항 없음 |
| 자바 | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | FlowsClient | FlowsClient |
| Ruby | 없음 | 해당 사항 없음 |
Page 유형의 get 및 patch/update 메서드를 참조하세요.
페이지 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 페이지 리소스 | 페이지 리소스 |
| RPC | 페이지 인터페이스 | 페이지 인터페이스 |
| C++ | PagesClient | 해당 사항 없음 |
| C# | PagesClient | 해당 사항 없음 |
| Go | PagesClient | 해당 사항 없음 |
| 자바 | PagesClient | PagesClient |
| Node.js | PagesClient | PagesClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | PagesClient | PagesClient |
| Ruby | 없음 | 해당 사항 없음 |
다음 데이터는 흐름과 연결되어 있습니다.
- 페이지: 흐름을 구성하는 페이지 목록입니다.
- 경로: 흐름의 시작 페이지가 활성화되면 이러한 모든 경로가 호출될 수 있습니다. 흐름의 다른 페이지가 활성화되면 인텐트 요구사항이 있는 경로를 따를 수 있습니다. 자세한 내용은 상태 핸들러 범위와 흐름 수준 경로를 참조하세요.
- 이벤트 핸들러: 이러한 핸들러는 흐름이 활성화되면 호출될 수 있습니다. 자세한 내용은 흐름 수준 이벤트 핸들러를 참조하세요.
다양한 수준에서 데이터가 적용되는 방식에 대한 자세한 내용은 데이터 애플리케이션 수준을 참조하세요.
흐름 설정
다음 설정을 흐름에 사용할 수 있습니다.
- 표시 이름: 인간이 읽을 수 있는 흐름의 이름입니다.
- 설명: 흐름에 대한 설명입니다.
- ML 설정: 흐름 ML 설정도 에이전트 ML 설정에 액세스하고 설명합니다.
- 언어 자동 감지: 언어 자동 감지를 사용하면 대화형 에이전트(Dialogflow CX)에서 자동으로 인식하고 응답해야 하는 최종 사용자 언어를 지정할 수 있습니다. 자세한 내용은 언어 자동 감지 문서를 참조하세요.
흐름 잠금: 하위 리소스에 대한 다음과 같은 변경사항을 포함하여 잠긴 흐름을 수정할 수 없습니다.
- 페이지는 생성, 수정, 삭제할 수 없습니다.
- 버전은 생성, 수정, 삭제할 수 없습니다.
- 흐름 수준 경로 그룹은 생성, 수정, 삭제할 수 없습니다.
- 잠긴 흐름 또는 잠긴 흐름의 모든 페이지에서 참조되는 에이전트 수준 경로 그룹은 삭제할 수 없지만 수정할 수는 있습니다.
고급 음성 설정: 이러한 고급 음성 설정은 선택적으로 동일한 에이전트 음성 설정을 재정의할 수 있습니다.
음성 적응 설정: 흐름 레벨 음성 적응 설정에 대한 자세한 내용은 수동 음성 적응을 참조하세요.
다양한 수준에서 데이터가 적용되는 방식에 대한 자세한 내용은 데이터 애플리케이션 수준을 참조하세요.
흐름 설정에 액세스하려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 흐름 섹션의 흐름 위로 마우스를 가져갑니다.
- 옵션 more_vert 버튼을 클릭합니다.
- 흐름 설정을 선택합니다.
- 설정을 찾아보거나 수정합니다.
- 저장을 클릭하여 변경사항을 저장합니다.
API
Flow 유형은 get 및 patch/update 메서드를 참조하세요.
흐름 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 흐름 리소스 | 흐름 리소스 |
| RPC | 흐름 인터페이스 | 흐름 인터페이스 |
| C++ | FlowsClient | 해당 사항 없음 |
| C# | FlowsClient | 해당 사항 없음 |
| Go | FlowsClient | 해당 사항 없음 |
| 자바 | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | FlowsClient | FlowsClient |
| Ruby | 없음 | 해당 사항 없음 |
흐름 삭제
흐름을 삭제하려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 흐름 섹션의 흐름 위로 마우스를 가져갑니다.
- 설정 more_vert 버튼을 클릭합니다.
- 삭제를 선택합니다.
API
Flow 유형은 delete 메서드를 참조하세요.
흐름 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 흐름 리소스 | 흐름 리소스 |
| RPC | 흐름 인터페이스 | 흐름 인터페이스 |
| C++ | FlowsClient | 해당 사항 없음 |
| C# | FlowsClient | 해당 사항 없음 |
| Go | FlowsClient | 해당 사항 없음 |
| 자바 | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | FlowsClient | FlowsClient |
| Ruby | 없음 | 해당 사항 없음 |
흐름 학습
흐름을 학습하려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 에이전트 설정을 클릭합니다.
- ML 탭을 엽니다.
- 단일 흐름을 학습하려면 해당 행에서 학습을 클릭합니다.
- 여러 흐름을 학습하려면 체크박스로 흐름을 선택한 후 선택한 흐름 NLU 모델 학습을 클릭합니다.
API
Flow 유형은 train 메서드를 참조하세요.
흐름 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 흐름 리소스 | 흐름 리소스 |
| RPC | 흐름 인터페이스 | 흐름 인터페이스 |
| C++ | FlowsClient | 해당 사항 없음 |
| C# | FlowsClient | 해당 사항 없음 |
| Go | FlowsClient | 해당 사항 없음 |
| 자바 | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | FlowsClient | FlowsClient |
| Ruby | 없음 | 해당 사항 없음 |
흐름 내보내기
다음 2가지 방법으로 흐름을 내보낼 수 있습니다.
데이터 내보내기: 흐름을 원시 데이터로 내보내므로 모든 에이전트로 가져올 수 있습니다. 흐름을 내보내면 흐름에서 참조하는 리소스(인텐트, 항목, 웹훅)도 내보냅니다. 아래 단계에서 원시 데이터 데이터 형식을 선택하세요.
다이어그램 내보내기(미리보기): 흐름을 시각적 다이어그램으로 내보냅니다. 내보내기 형식은 draw.io XML이므로 Lucidchart, diagrams.net 또는 draw.io 형식을 가져올 수 있는 기타 다른 다이어그램에서 가져올 수 있습니다. 아래 단계에서 XML 데이터 형식을 선택하세요.
다음 옵션을 사용하여 흐름을 내보낼 수 있습니다.
- 참조된 흐름 포함: 대상 흐름과 참조된 흐름의 모든 수준을 내보냅니다. 참조된 흐름에는 최대 깊이 없이 후속 참조된 흐름에서 참조하는 흐름 외에 대상 흐름에서 참조하는 흐름도 포함됩니다. 가져오는 동안 내보낸 모든 흐름을 가져오고 이러한 흐름 간의 전환이 보존됩니다.
흐름을 내보내려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 흐름 섹션의 흐름 위로 마우스를 가져갑니다.
- 옵션 more_vert 버튼을 클릭합니다.
- 흐름 내보내기를 선택합니다.
- 안내에 따라 완료합니다.
API
Flow 유형은 export 메서드를 참조하세요.
흐름 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 흐름 리소스 | 흐름 리소스 |
| RPC | 흐름 인터페이스 | 흐름 인터페이스 |
| C++ | FlowsClient | 해당 사항 없음 |
| C# | FlowsClient | 해당 사항 없음 |
| Go | FlowsClient | 해당 사항 없음 |
| 자바 | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | FlowsClient | FlowsClient |
| Ruby | 없음 | 해당 사항 없음 |
흐름 가져오기
소스 에이전트에서 대상 에이전트로 흐름을 가져오면 흐름에서 참조하는 전역 리소스(인텐트, 항목, 웹훅)를 흐름별 데이터와 함께 가져옵니다. 대상 에이전트에 소스 에이전트에 찾은 표시 이름과 동일한 표시 이름이 있는 전역 리소스가 있으면 대화형 에이전트(Dialogflow CX)는 이러한 리소스에 대한 충돌을 해결하는 3가지 옵션과 함께 리소스에 대한 요약을 제공합니다.
- 기존 리소스 교체: 소스 에이전트 리소스가 대상 에이전트 리소스를 덮어씁니다.
- 새 리소스로 가져오기: 소스 에이전트 리소스가 이름에 고유한 접미사와 함께 추가됩니다.
- 원본 리소스 유지: 대상 에이전트 리소스기 변경되지 않습니다.
흐름을 가져오려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 흐름 섹션에서 추가 add 버튼을 클릭합니다.
- 흐름 가져오기를 선택합니다.
- 안내에 따라 완료합니다.
API
Flow 유형은 import 메서드를 참조하세요.
흐름 참조의 프로토콜 및 버전 선택:
| 프로토콜 | V3 | V3beta1 |
|---|---|---|
| REST | 흐름 리소스 | 흐름 리소스 |
| RPC | 흐름 인터페이스 | 흐름 인터페이스 |
| C++ | FlowsClient | 해당 사항 없음 |
| C# | FlowsClient | 해당 사항 없음 |
| Go | FlowsClient | 해당 사항 없음 |
| 자바 | FlowsClient | FlowsClient |
| Node.js | FlowsClient | FlowsClient |
| PHP | 없음 | 해당 사항 없음 |
| Python | FlowsClient | FlowsClient |
| Ruby | 없음 | 해당 사항 없음 |