Actions API — GPT를 외부 서비스와 연동하기 | FindSkill.ai

🔄 지난 레슨에서 지식 파일로 GPT에 전문 지식을 부여하는 방법을 배웠습니다. 한국어 토큰 문제와 파일 최적화까지. 이번에는 GPT가 외부 서비스와 직접 소통하게 만듭니다.

배울 내용

이 레슨을 마치면 Actions API의 구조를 이해하고, 코딩 없이 외부 서비스와 GPT를 연동하는 방법을 적용할 수 있습니다.

Actions가 뭔가

지금까지 만든 GPT는 “대화"만 합니다. 질문하면 텍스트로 답합니다. Actions를 추가하면 GPT가 실제 작업을 수행합니다:

Actions 없음	Actions 있음
“오늘 날씨가 좋을 것 같아요” (추측)	실제 기상청 API에서 오늘 서울 날씨를 가져옴
“일정을 추가하세요” (텍스트만)	Google Calendar에 직접 일정 생성
“이 내용을 정리했어요” (대화 안에서)	Notion 페이지에 직접 작성

Actions = GPT가 외부 API를 호출하는 능력입니다.

Actions의 작동 원리

사용자가 자연어로 요청합니다 (“내일 오후 2시에 팀 회의 일정 잡아줘”)
GPT가 요청을 분석합니다
GPT가 OpenAPI 스키마에 정의된 API를 호출합니다
API 응답을 받아서 사용자에게 자연어로 전달합니다

핵심은 OpenAPI 스키마입니다. API의 엔드포인트, 파라미터, 인증 방식을 JSON 또는 YAML로 정의하면, GPT가 자연어를 올바른 API 호출로 변환합니다.

✅ Quick Check: Actions에서 GPT는 사용자의 자연어를 무엇으로 변환하나요? (OpenAPI 스키마에 정의된 API 호출로 변환합니다. 사용자는 “내일 회의 잡아줘"라고 말하고, GPT는 이를 올바른 API 엔드포인트와 파라미터로 변환해서 호출합니다.)

3가지 인증 방식

외부 API에 접근하려면 인증이 필요합니다. Actions는 3가지 방식을 지원합니다:

인증 방식	언제 사용	예시
None	공개 API	날씨 API, 환율 API, 위키백과
API Key	공유 리소스	뉴스 API, 주식 데이터, 지도 API
OAuth	개인 데이터	Google Calendar, Notion, Slack, 이메일

원칙: 개인 데이터에 접근하면 OAuth, 공유 데이터면 API Key 또는 None.

OAuth를 설정하면 사용자가 GPT를 처음 사용할 때 “이 앱이 내 캘린더에 접근하는 것을 허용하시겠습니까?” 같은 인증 화면이 나타납니다.

코딩 없이 Actions 연동하기

Actions 연동에 코딩이 필수는 아닙니다. 자동화 플랫폼을 활용하면 됩니다.

Zapier + GPT 연동

Zapier는 GPT Actions와의 직접 연동을 제공합니다:

Zapier에서 “AI Actions” 기능 활성화
연동할 서비스 선택 (Gmail, Sheets, Slack 등)
Zapier가 생성한 OpenAPI 스키마를 GPT의 Actions에 붙여넣기
테스트

Zapier를 통해 5,000개 이상의 앱과 GPT를 코딩 없이 연결할 수 있습니다.

Make (구 Integromat) + GPT

Make도 비슷한 기능을 제공합니다. 시나리오(워크플로우)를 만들고, 웹훅 URL을 GPT Actions에 연결합니다.

OpenAPI 스키마 기초 (개발자용)

코딩이 가능하다면 직접 스키마를 작성하는 것도 어렵지 않습니다. 기본 구조:

openapi: 3.1.0
info:
  title: 회의실 예약 API
  description: 회사 회의실 예약 및 조회
  version: v1.0.0
servers:
  - url: https://api.example.com
paths:
  /rooms:
    get:
      operationId: getRooms
      summary: 사용 가능한 회의실 목록 조회
      responses:
        "200":
          description: 회의실 목록
  /rooms/{room_id}/book:
    post:
      operationId: bookRoom
      summary: 회의실 예약
      parameters:
        - name: room_id
          in: path
          required: true
          schema:
            type: string

이 스키마를 Configure 탭 → Actions → “스키마 추가"에 붙여넣으면 됩니다.

OpenAI Actions Library에서 Notion, Google Sheets 등의 사전 빌드 스키마를 제공합니다. 처음부터 작성할 필요 없이 복사해서 수정하면 됩니다.

✅ Quick Check: 코딩을 모르는 사람이 GPT에 Actions를 추가하는 가장 쉬운 방법은? (Zapier나 Make 같은 자동화 플랫폼의 GPT 연동 기능을 사용하는 것입니다. 이 플랫폼들이 OpenAPI 스키마를 자동 생성해주므로, 코딩 없이 수천 개의 앱과 GPT를 연결할 수 있습니다.)

실전 활용 시나리오

시나리오 1: 회의록 → Notion 자동 정리

회의 내용을 GPT에 입력
GPT가 요약 + 액션 아이템 정리
Actions로 Notion 페이지에 자동 작성

시나리오 2: 고객 문의 → Google Sheets 기록

고객이 GPT에 문의
GPT가 분류(문의/불만/요청) + 답변
문의 내용을 Google Sheets에 자동 기록

시나리오 3: 일정 관리 봇

“내일 오후 2시에 팀 회의 잡아줘”
GPT가 Google Calendar에 직접 일정 생성
“이번 주 일정 보여줘” → 캘린더에서 조회

Actions 설정 시 주의사항

테스트 먼저: Actions를 추가한 후 프리뷰에서 충분히 테스트하세요
에러 처리: API 호출 실패 시 GPT가 어떻게 대응할지 인스트럭션에 명시하세요
권한 최소화: 필요한 권한만 요청하세요 (전체 읽기/쓰기 대신 특정 기능만)
비용 확인: 외부 API에 따라 사용량 기반 비용이 발생할 수 있습니다
개인정보 주의: 사용자 데이터가 외부 API로 전송됩니다. 개인정보 처리에 주의하세요

핵심 정리

Actions = GPT가 외부 API를 호출해서 실제 작업을 수행하는 기능
OpenAPI 스키마(JSON/YAML)로 API 엔드포인트와 파라미터를 정의
3가지 인증: None(공개), API Key(공유), OAuth(개인 데이터)
코딩 없이: Zapier, Make 등 자동화 플랫폼으로 5,000+ 앱 연동 가능
개발자: OpenAI Actions Library의 사전 빌드 스키마 활용

다음 레슨

다음 레슨에서는 지금까지 배운 모든 것을 합쳐서 실전 프로젝트 3개를 만듭니다. 업무봇(회의록 + Notion 연동), 학습봇(논문 분석 + 퀴즈 생성), 마케팅봇(블로그 키워드 분석). 각각 인스트럭션 + 지식 파일 + Actions를 조합합니다.

Actions API — GPT를 외부 서비스와 연동하기