Jin’s Dev Notes
About

Google Dialogflow API 사용법

태그
DevelopmentTool
생성일
Feb 17, 2025
날짜
Last updated February 17, 2025

Dialogflow API 소개

notion image
Google Dialogflow API는 Google Cloud에서 제공하는 자연어 처리(NLP) 기반 대화형 AI 서비스로, 음성 또는 텍스트 입력을 이해하고 자동으로 응답할 수 있는 챗봇 및 가상 비서를 구축하는 데 사용됩니다.
이 API를 활용하면 고객 지원 챗봇, 스마트 스피커 음성 비서, AI 고객 상담원 등을 쉽게 개발할 수 있습니다.

Dialogflow API 주요기능

  1. 자연어 이해(NLU, Natural Language Understanding)
    1. 사용자의 발화(텍스트 또는 음성)을 분석하여 의도(Intent)와 엔터티(Entity)를 추출하고 처리할 수 있습니다.
      2. ex)
      • “오늘 날씨 어때?” → “날씨 확인” 의도(Intent) 인식
      • “서울 날씨 알려줘” → Entity(“서울”) 값을 인식하여 특정 도시의 정보 조회
  1. 멀티 채널 지원
    1. Google Assistant, Facebook Messenger, WhatsApp, Slack 등 다양한 메시징 플랫폼과 통합 가능
  1. 음성 및 텍스트 입력 처리
    1. Google Cloud Speech-to-Text(STT) 및 Text-to-Speech(TTS)와 통합하여 음성 기반 대화 처리 가능
  1. 다국어 지원
    1. 한국어, 영어 등 30개 이상의 언어를 지원하여 글로벌 챗봇 구축 가능
  1. Webhook을 통한 동적 응답 처리
    1. Webhook을 사용하면 API 또는 데이터베이스에서 실시간 데이터를 가져와 사용자 질문에 동적으로 응답 가능
  1. Dialogflow ES vs Dialogflow CX
    1. Dialogflow ES(Standard Edition) : 단순한 FAQ 챗봇 및 기본적인 대화형 AI 구축용
    2. Dialogflow CX(Advanced Deition) : 복잡한 다단계 대화 흐름을 위한 구조적 대화 설계 기능 지원

Google Dialogflow API 키 얻는 방법

Google Dialogflow는 자연어 이해(NLU)를 기반으로 하는 챗봇 및 AI 인터페이스 개발을 위한 강력한 도구입니다. Google Dialogflow API를 사용하려면 서비스 계정을 생성하고 API 키(credentials.json)를 다운로드 해야합니다.

API Key 발급 절차

  1. Google Cloud Console 에 로그인(https://console.cloud.google.com)
notion image
notion image
  1. 프로젝트 생성 또는 기존 프로젝트를 선택합니다.
notion image
  1. 좌측 메뉴에서 "API 및 서비스" → "라이브러리" 로 이동합니다.
notion image
notion image
  1. "Dialogflow API" 검색한 후 사용 설정을 클릭합니다.
notion image
  1. 좌측 메뉴에서 "API 및 서비스" → "인증 정보" 메뉴로 이동합니다.
  1. "서비스 계정 만들기" 버튼 클릭 후 필요한 정보 입력합니다.
notion image
  1. 생성된 서비스 계정의 키(Key) 생성 합니다.
notion image
  1. 키 유형을 JSON으로 선택하고 다운로드
  1. 다운로드된 credentials.json 파일을 프로젝트 폴더에 저장
  1. 생성된 API Key를 복사한 후 .env 파일에 저장합니다.
GOOGLE_APPLICATION_CREDENTIALS=./credentials.json
이것은 생성된 “credentials.json”파일의 예시입니다. "xxxx"로 표시되어 있는 부분을 사용자의 정보에 맞게 변경 해주시면 됩니다.
{
"type": "service_account",
"project_id": "xxxxxxxxxxxx",
"private_key_id": "xxxxxxxxxxxx",
"private_key": "xxxxxxxxxxxx",
"client_email": "xxxxxxxxxxxx",
"client_id": "xxxxxxxxxxxx",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "xxxxxxxxxxxx",
"universe_domain": "googleapis.com"
}

주의 사항

  • Key 정보는 외부에 유출되지 않도록 철저히 보안 관리해야 합니다.
  • 코드 저장소(GitHub 등)에 API Key가 포함되지 않도록 “gitignore”를 설정해야한다.