인텐트는 이해되는 사용자 요청과 수행할 작업을 판단합니다. 대부분의 경우 Dialogflow ES 콘솔을 사용하여 인텐트를 관리합니다. 고급 시나리오에서는 API를 사용하여 인텐트를 관리할 수 있습니다. 이 문서에서는 API를 사용하여 인텐트를 생성, 나열, 삭제하는 방법을 설명합니다.
시작하기 전에
시작하기 전에 다음 단계를 완료하세요.
- Dialogflow 기본사항 읽기
- 설정 단계 수행
에이전트 만들기
- Dialogflow ES 콘솔로 이동합니다.
- 메시지가 표시되면 콘솔에 로그인합니다. 자세한 내용은 Dialogflow 콘솔 개요를 참고하세요.
- 사이드바 메뉴에서 로딩 에이전트를 펼칩니다.
- 새 에이전트 만들기를 클릭합니다.
- 에이전트 이름, 기본 언어, 기본 시간대를 입력합니다.
- 기존 프로젝트를 입력합니다. Dialogflow 콘솔에서 프로젝트를 만들도록 하려면 새 Google 프로젝트 만들기를 선택합니다.
- 만들기를 클릭합니다.
IntentView를 사용하여 모든 인텐트 데이터 반환하기
기본적으로 API는 인텐트를 생성, 나열 또는 가져올 때 축약된 인텐트 데이터를 반환합니다. 다음 샘플은 이 기본값을 사용합니다.
모든 인텐트 데이터를 검색하려면 IntentView 매개변수를 INTENT_VIEW_FULL로 설정해야 합니다. 인텐트 데이터에 관한 자세한 내용은 인텐트 유형의 메서드를 참고하세요.
인텐트를 만듭니다.
다음 샘플은 인텐트를 만드는 방법을 보여줍니다. 인텐트에 관한 자세한 내용은 인텐트 참조를 확인하세요.
REST
에이전트의 인텐트를 만들려면 intent 리소스에서 create 메서드를 호출합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
HTTP 메서드 및 URL:
POST https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents
JSON 요청 본문:
{
"displayName": "ListRooms",
"priority": 500000,
"webhookState": "WEBHOOK_STATE_UNSPECIFIED",
"trainingPhrases": [
{
"type": "EXAMPLE",
"parts": [
{
"text": "What rooms are available at 10am today?"
}
]
}
],
"action": "listRooms",
"messages": [
{
"text": {
"text": [
"Here are the available rooms:"
]
}
}
]
}
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
intents 이후의 경로 세그먼트에는 새 인텐트 ID가 포함됩니다.
Go
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 다음 .NET용 Dialogflow CX 참고 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 다음 PHP용 Dialogflow CX 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Dialogflow CX 참고 문서를 참조하세요.
인텐트 나열
다음 샘플은 인텐트를 나열하는 방법을 보여줍니다. 자세한 내용은 인텐트 참조를 확인하세요.
REST
에이전트의 인텐트를 나열하려면 intents 리소스에서 list 메서드를 호출합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
HTTP 메서드 및 URL:
GET https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"intents": [
{
"name": "projects/PROJECT_ID/agent/intents/5b290a94-55d6-4074-96f4-9c4c4879c2bb",
"displayName": "ListRooms",
"priority": 500000,
"action": "listRooms",
"messages": [
{
"text": {
"text": [
"Here are the available rooms:"
]
}
}
]
},
...
]
}
intents 이후의 경로 세그먼트에는 인텐트 ID가 포함됩니다.
Go
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 다음 .NET용 Dialogflow CX 참고 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 다음 PHP용 Dialogflow CX 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Dialogflow CX 참고 문서를 참조하세요.
인텐트 삭제
다음 샘플은 인텐트를 삭제하는 방법을 보여줍니다. 자세한 내용은 인텐트 참조를 확인하세요.
REST
에이전트의 인텐트를 삭제하려면 intents 리소스에서 delete 메서드를 호출합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID
- INTENT_ID: 인텐트 ID
HTTP 메서드 및 URL:
DELETE https://dialogflow.googleapis.com/v2/projects/PROJECT_ID/agent/intents/INTENT_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.
Go
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Java
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Node.js
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
Python
Dialogflow CX에 인증하려면 애플리케이션 기본 사용자 인증 정보를 설정합니다. 자세한 내용은 로컬 개발 환경의 인증 설정을 참조하세요.
추가 언어
C#: 클라이언트 라이브러리 페이지의 C# 설정 안내를 따른 다음 .NET용 Dialogflow CX 참고 문서를 참조하세요.
PHP: 클라이언트 라이브러리 페이지의 PHP 설정 안내를 따른 다음 PHP용 Dialogflow CX 참고 문서를 참조하세요.
Ruby: 클라이언트 라이브러리 페이지의 Ruby 설정 안내를 따른 다음 Ruby용 Dialogflow CX 참고 문서를 참조하세요.