플렉스튜디오에서 OpenAI API 설정하기

이전 강의에서는 OpenAI API를 사용하기 위한 API Key 발급 방법을 살펴봤어요. 이번에는 발급받은 키를 활용해 플렉스튜디오에서 API를 연동하는 과정을 단계별로 소개할게요.

플렉스튜디오 유튜브에서 영상 강의 보러 가기 ▼

1단계 : API 연동 기본 설정

1. 플렉스튜디오 워크스페이스 - 좌측 메뉴에서 데이터 - API 연동 버튼 클릭

2. ‘+’ 모양의 버튼(API 생성 버튼) 클릭

3. 팝업에 나타난 템플릿 중 ChatGPT API를 선택 - API 명을 입력한 뒤 확인 버튼 클릭

4. 자동으로 생성된 모듈 확인

2단계 : OpenAI API 종류 선택

OpenAI에서는 크게 두 가지 방식으로 대화형 AI를 만들 수 있습니다. Assistants API와 Chat Completions API예요. 이번 강의에서는 Chat Completions API를 활용할 예정이에요. 참고로 API의 상세한 명세는 OpenAI 공식사이트 - API reference 페이지에서 확인할 수 있어요.

• Assistants API
  • Threads, Messages 등을 활용해 맥락을 자동으로 관리할 수 있는 구조
  • 러닝 커브가 높지만 고객센터 챗봇처럼 복잡한 기능 구현에 적합
    

• Chat Completions API
  • 입력 메시지를 모델에 직접 전달하고 응답을 받는 방식
  • 구현이 단순해 간단한 챗봇, 질의응답, 프롬프트 기반 작업을 빠르게 가능

3단계 : Secret Key 설정

1. 자동으로 생성된 모듈 중 chatGPTChating 모듈 클릭
   

1. • API 호출 시 Header에 발급받은 키를 전달 필요
     

3. 플렉스튜디오에서는 Header 탭에 토큰 값을 대체표현식으로 정의해 동적으로 반영 가능

4. Advanced Key Setting 탭에서 Secret Key로 토큰을 등록

• • 이 방법은 키 값이 클라이언트에 노출되지 않아 안전하게 사용할 수 있어요.

4단계 : API 호출/응답 구조 설정

1. Body 탭에서 사용할 AI 모델 (예: gpt-3.5)을 지정하고 messages 정보를 대체표현식으로 정의
   • 보내는 데이터로 설정한 값을 messages로 전달한다는 의미

2. API마다 호출과 응답에 대한 구조가 다르기 때문에 명세를 반드시 확인하고 플렉스튜디오의 컬렉션과 호환되도록 전처리·후처리 작업 필요
   • 데이터 처리를 위해 Body 탭에서 JSON 구조를 변경하거나 Response, Script 탭 활용 가능
   • 전처리 스크립트 : 시나리오에서 보내는 데이터는 paramBlocks 변수에 이중배열 형태로 구성
     • 반복문으로 각 섹터를 순회하면서 특정 키 값을 API에서 요구하는 데이터 형식으로 변환
   • 후처리 스크립트 : 컬렉션에 맞게 필요한 데이터만 전달
     
     

5단계 : 테스트와 API 배포

1. 테스트 탭으로 이동

2. Test Param Blocks 항목에 user와 content 정보 추가해서 ParamData 구성

3.  하단의 TEST CALL 버튼 클릭

• • Test Result에서 API를 호출했을 때 어떤 데이터를 주고 받는지 확인 가능

4. 정상적으로 동작한다면 우측 하단의 배포 버튼을 눌러 반영

다음 강의 : 시나리오에서 OpenAI API 호출하기

플렉스튜디오에서 OpenAI API를 모듈로 등록하는 과정을 완료했어요. 다음 글에서는 실제 시나리오에서 API를 호출하고 활용하는 방법을 이어서 소개할게요.