ChatGPT API 액션 파라미터 활용

이번 글에서는 더 고급 단계로 나아가며, 아직 다루지 않았던 마지막 매개변수, 즉 action(액션) 파라미터에 대해 살펴봅니다. 이 액션 파라미터는 GPT 챗을 다른 서비스의 API와 연결할 수 있게 해줍니다.

 

예를 들어, 이 기능을 사용하면 Spotify 계정과 연결하여 인공지능을 활용해 플레이리스트를 생성할 수 있습니다. 또는 캘린더 API와 연결하여 GPT가 일정을 추가, 수정, 취소할 수 있게 할 수도 있습니다. 또 금융시장 API를 통해 실시간 주식 정보를 받아오고, 심지어 거래까지 실행하게 만들 수도 있습니다. 소셜미디어 API를 활용해 GPT가 게시물 작성, 수정, 삭제 등의 작업을 자동화할 수도 있죠.

 

이전 예시였던 여행 추천 GPT 같은 경우, 항공권 예약 API를 연결해 자동으로 비행편을 검색하고 예약할 수 있게 만들 수도 있습니다.

---

 

액션 구성 실습 예시

 

이번에는 완전히 새로운 GPT를 하나 만들고, action 설정 부분부터 바로 살펴보겠습니다.

 

새 액션 만들기 버튼을 누르면 창이 열리고, 첫 번째로 API 인증 방식을 선택해야 합니다. 세 가지 방식이 있습니다:

 

1. 인증 없음: 누구나 API에 접근할 수 있으며, 인증 정보 없이 자유롭게 호출할 수 있습니다.
2. API 키 사용: 제공자가 주는 고유한 키를 사용해 인증합니다. 이 방식은 사용자 추적, 요청 제한, 오용 방지 등에 활용됩니다.
3. OAuth (오픈 인증): 사용자의 로그인 정보를 공유하지 않고 외부 애플리케이션이 특정 자원에 접근할 수 있게 해주는 보다 안전한 프로토콜입니다. 사용자는 필요 시 접근 권한을 취소할 수 있습니다.

 

이번 예시에서는 인증 없음을 선택하고 계속 진행합니다.

 

---

 

API 스키마(schema)

 

두 번째 필드는 스키마 입력란입니다. 여기엔 OpenAPI 스키마를 입력해야 합니다.

이는 GPT에게 API를 어떻게 호출할지, 어떤 방식으로 다른 서비스와 통신할지 알려주는 명세서입니다. 직접 코드 형식으로 작성하거나, URL을 통해 불러올 수도 있습니다.

 

조금 복잡하게 느껴질 수 있으나, GPT는 기본적으로 예시 스키마 세 가지를 제공해 줍니다. 이를 참고하면 형식을 이해하는 데 도움이 됩니다.

 

---

 

실습: 무료 공개 API 연결

 

실습을 위해 인증이 필요 없는 간단한 무료 API를 사용합니다. 구글에서 “free public open API”라고 검색하면 다양한 목록이 나오며, 그중 하나인 GitHub 페이지에서는 여러 분야의 API들이 카테고리별로 정리되어 있습니다.

 

예시로 선택한 API는 Foodish API로, 무작위 음식 사진을 생성해주는 매우 단순한 API입니다. 사용법이 간단하고, 인증도 필요 없으며, 샘플 응답값도 제공해 줍니다.

 

---

 

액션 스키마 생성하기

 

GPT에 액션 스키마를 생성해달라고 요청하기 위해 세 가지 정보를 준비합니다:

 

1. 설명(description): 예) 무작위 음식 사진을 생성합니다.
2. URL: API 호출 주소
3. 샘플 응답(example response): API가 반환하는 JSON 형식 응답 예시

 

이 세 가지를 GPT에게 제공하고, 액션 GPT를 활용해 스키마를 생성합니다. GPT는 이를 바탕으로 아래와 같은 구조로 자동 생성합니다:

 

• 제목(title): foodie@api
• 설명: 음식 사진 생성 목적
• 호출 URL
• 스키마 구조
• 응답 예시

 

생성된 스키마가 정상적으로 동작할 수 있도록 꼭 확인하고, 복사하여 액션 설정란에 붙여넣기합니다.

 

---

 

GPT 구성 마무리

 

• 이름: 랜덤 음식 이미지 생성기
• 설명: 무작위 음식 사진 생성
• 시작 프롬프트: “음식 사진 하나 만들어줄래?”
• 로고 생성: DALL·E를 사용해 간단히 생성 가능
• 공개 범위 설정: 나만 사용으로 설정

 

모든 설정을 저장하고, GPT를 실행시켜 보면 API 호출이 정상적으로 이루어지고, 실제 음식 이미지가 생성됩니다. 중요한 점은, 이 이미지는 DALL·E가 생성한 것이 아니라, 우리가 연결한 Foodish API에서 받아온 것이라는 것입니다.

 

---

 

요약

 

이 예시는 실용성은 떨어질 수 있으나, GPT와 API를 연결하여 액션을 실행하는 구조를 이해하기에 매우 적합한 학습 예시입니다.

복잡한 인증, 다단계 요청 등은 나중에 연습하고, 먼저 단순한 구조로 동작 방식부터 익히는 것이 좋습니다.

 

필요하면 더 복잡한 API로도 확장해볼 수 있습니다.