일부 제품과 기능의 이름이 변경되고 있습니다. 생성형 플레이북 및 흐름 기능도 단일 통합 콘솔로 마이그레이션되고 있습니다. 세부정보를 참조하세요.

API로 인텐트 관리
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

일반적으로 콘솔을 사용하여 인텐트를 만들고 삭제합니다. 그러나 일부 고급 시나리오에서는 API를 사용하는 것이 더 쉬울 수 있습니다.

인텐트 만들기

다음 예시에서는 Intent 유형에 대해 Create 메서드를 호출하는 방법을 보여줍니다.

인텐트 참조의 프로토콜 및 버전 선택:

프로토콜	V3	V3beta1
REST	인텐트 리소스	인텐트 리소스
RPC	인텐트 인터페이스	인텐트 인터페이스
C++	IntentsClient	해당 사항 없음
C#	IntentsClient	해당 사항 없음
Go	IntentsClient	해당 사항 없음
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	없음	해당 사항 없음
Python	IntentsClient	IntentsClient
Ruby	없음	해당 사항 없음

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID
REGION_ID: 리전 ID
AGENT_ID: 에이전트 ID

HTTP 메서드 및 URL:

POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents

JSON 요청 본문:

{
  "displayName": "My intent display name"
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID",
  "displayName": "My intent display name",
  "priority": 500000
}

인텐트 업데이트

필드 마스크 가이드는 인텐트의 개별 필드 업데이트 방법을 보여줍니다.

인텐트 삭제

다음 예시에서는 Intent 유형에 대해 Delete 메서드를 호출하는 방법을 보여줍니다.

인텐트 참조의 프로토콜 및 버전 선택:

프로토콜	V3	V3beta1
REST	인텐트 리소스	인텐트 리소스
RPC	인텐트 인터페이스	인텐트 인터페이스
C++	IntentsClient	해당 사항 없음
C#	IntentsClient	해당 사항 없음
Go	IntentsClient	해당 사항 없음
Java	IntentsClient	IntentsClient
Node.js	IntentsClient	IntentsClient
PHP	없음	해당 사항 없음
Python	IntentsClient	IntentsClient
Ruby	없음	해당 사항 없음

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

PROJECT_ID: Google Cloud 프로젝트 ID
REGION_ID: 리전 ID
AGENT_ID: 에이전트 ID
INTENT_ID: 만들기 응답에서 발견된 인텐트 ID

HTTP 메서드 및 URL:

DELETE https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/intents/INTENT_ID" | Select-Object -Expand Content

성공 상태 코드(2xx)와 빈 응답을 받게 됩니다.

API로 페이지 관리

FieldMask로 데이터 업데이트

API로 인텐트 관리 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

인텐트 만들기

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

인텐트 업데이트

인텐트 삭제

REST

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

API로 인텐트 관리
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.