얼마 전에 새롭게 업데이트된 오픈 AI API 중에서 어시스턴트 API 아는 게 있습니다. 이게 뭔지 간단하게

말씀드리면 나만의 어시스턴트, 그러니까 도움이, 나만의 AI 도우미를 만들어 놓고 계속 사용할 수 있는 거예요.

그동안 오픈 AI API 사용을 할 때 우리가 한번 실행을 해서 사용을 하고 종료를 하면은 실행할 때 사용한 설정과 대화 내용들이 싹 사라졌죠.

다시 실행을 하면은 이전 대화를 이어갈 수 없다는 거예요. 하지만 이 어시스턴트 API 사용하면은 설정도 그대로 유지를 시켜 놓을 수 있고

내가 AI와 나눴던 대화들도 그대로 이어갈 수 있습니다. 그리고 코드를 실행시키거나 문서를 업로드해서 여기에서 내용을 찾아 달라는 등 다양한 기능까지

사용할 수가 있습니다. 심지어 이 어시스턴트 API 현재 베타 버전이에요. 앞으로 더 좋아질 거라는 거죠. 그러면 제가 테스트로 만들어서

대화를 몇 번 했던 어시스턴트가 있어요 이거를 실행시켜서 보여 드릴게요 실행을 하면은 자 제가 이렇게 메시지

입력하게 되어 있어요 자 제 이름이 뭔가요라고 물어볼 건데 이전 대화에서 이전에 대화하고 종료한 거에서 제가 이름을

알려 준 적이 있어요 과연 기억을 할까요 자 제가 이름을 김이라고 알려줬는데 이거 잘하고 맞게 대답을

해줬습니다 이런 식으로 이전 대화들을 다 기억을 하고 있어요 굉장히 편리하게 사용할 수 있겠죠 자 그러면 아주 간단하게 한번

만들어 볼 건데요 사실 오픈 AI 사이트 들어오시면 문서가 잘 되어 있습니다 그리고 여기 API 레퍼런스

들어오면은 또 어떻게 사용하는지도 잘 되어 있어서 자신이 원하는 언어로 되어 있는 걸 복사해서 그대로 사용하시면 돼요 하지만

아무래도 이것만 봐 가지고 좀 헷갈릴 수 있겠죠. 그래서 가장 아주 간단하게 가장 기본적인 것만 한번 사용해

보겠습니다. 그러면 실제로 코드를 작성하기 전에 먼저 어시스턴트가 어떻게 실행이 되는지 어떻게 만들어지고 실행이 되는지를

한번 볼 건데요. 여기 맨 첫 페이지에 있어요. 오버뷰 부분에 있습니다. 이렇게 나와 있는 거를 번역을 해서 보면은 자 여기

이게 순서요. 통합 흐름은 다음과 같습니다. 되어 있죠. 사용자 지침을 정하고 모델 선택해서 API 도메인을 만듭니다. 그 어시스턴트를 만들고

대화를 시작할 때 쓰레드를 하나 생성을 해요. 그다음에 이 쓰레드에 메시지를 추가를 하고요. 그다음 실행을 한 다음에 결과를 받는 거예요.

그러면은 제가 방금 전에 제 이름을 물어봤을 때 대답을 해 줬잖아요. 그렇게 기억을 하고 있으려면 이 쓰레드

생성한 것 같은 쓰레드에 계속 메시지를 추가해서 물어보면 돼요. 그러면 이 쓰레드에 제가 보낸 메시지

그리고 이 AI가 대답한 메시지가 차곡차곡 저장이 되어 있는 거예요. 그리고 같은 어시스턴트를 사용하면은 항상 맨 처음에 설정한 지침이 그대로

사용이 되는 거고요. 자 이런 말만으로 아직 헷갈리죠. 하지만은 한 번만 만들어 보면은 아 이런 식으로 흘러가는구나

바로 아실 수 있어요. 지금 여기 API 참조하고 되어 있는 부분 있죠? 지금 전혀 번역을 해서 그런데 API 레퍼런스라고 되어 있어요. 이걸

클릭해서 들어오신 다음에 내려서 여기에 베타 어시스턴트 이 부분으로 오시면 돼요. 그러면 뭔가 메뉴가 많죠? 메뉴가

많은데 그중에서 맨 처음 있는 크리에이트 어시스턴트 자 이렇게 순서대로 되어 있는 겁니다. 이렇게 만들고 찾고 뭐 이렇게 지우는 거

이런 것들이 쭉쭉쭉 있어요 그다음에 쓰레드에 관련된 거 메시지에 관련된 거 런 아까 우리가 본 실행 순서죠

어시스턴트 하고 쓰레드 만들고 메시지 만들어서 실행하고 그러면은 당연히 맨 처음 만들어야 돼요 저처럼 만들어져 있으면은 그거를

그대로 사용할 수 있는데 처음이면 당연히 만들어야 됩니다 파이썬을 사용할 거니까 파이썬 요거를 해 가지고요 카피를

해 주세요 그리고 카피한 거를 붙여 놓게 하고 이렇게 API 키도 넣어 주세요 저는 물론이 영상 끝나고 이걸

삭제할 겁니다 그러니까 제 API 키가 유출됐다고 걱정하셔도 됩니다 그러면 다시 사이트로 돌아와서 한번 살펴볼게요 여기 리퀘스트

바디라는 부분 있죠 이 안에 들어가는 건데 자 필수는 모델밖에 없습니다 그러니까 나머지는 다 지워도 상관없어요

그리고 모델은 지금 GPT-4로 되어 있잖아요 아시겠지만 모델마다 가격이 다릅니다 그러니까 자신의 목적에 맞는

모델을 사용하시면 돼요 그 또 하나 지금 사용하지 않을 건데 일단 툴이라는 거 보면은 코드 인터프리터가 들어 있잖아요 지금

사용할 수 있는 게 세 가지예요 이 툴이 뭐냐면 여기 어시스턴트 설명 있는 거에서 '스'에 들어오면은 내용이 나와 있습니다

각각의 툴을 어떻게 사용하는지 그리고 어떤 역할을 하는지 번역해서 보시면 대충 아실 수 있는데 지금 보시는

거보다 일단 제가 하는 거 따라서 한번 다 만들어 보고 나서 보시면은 아마 훨씬 이해가 잘 되실 거예요 다시 아까 복사 붙여넣기한

코드로 돌아와서요 지금 그대로 되어 있는데 저는 모델을 바꿨습니다 GPT-3.5 터보 1106 이게 GPT-4보다

저렴하니까 저 일단 이걸 바꾼 거예요. 그 지금 보면은 여기 지침이 들어 있어 어떤 모델인지 너는 이제 뭐

수학 선생님이고 질문을 받으면은 파이썬 코드를 작성을 해서 대답을 해라, 실행을 해서 대답을 해라라는 거예요. 파이썬 코드를 실행을 하기

위해서 지금 스에 코드 인터프리터가 들어가 있는 겁니다. 그렇게 되면은 실행이 가능해요. 자, 하지만 지금 뭐 코드를 딱히 실행해 보진 않을 거예요.

그러니까 뭐 이거 없어도 되니까 이거는 그냥 없애고요. 투스는 그냥 더도 상관이 없습니다. 더도 기능이

들어가 있을 뿐이지 이게 있다고 뭐 파이썬 코드를 우리가 제공하지도 않았는데 코드를 실행하려고 하거나 코드를 찾는다거나 그러진

않아요. 단지 네임만 그냥 풀봇 요렇게 만들게요. 그다음에 실행을 해 봐야겠죠. 지금 요렇게 해서 만들고 마이

어시스턴트라는 걸 프린트하게 되어 있어요 그러면 아 실행시키면 좀 기다려야 돼요 요런 메시지가 출력이 됐습니다 자 여기에서

제일 중요한 부분은 이 아이디예요 그리고 그대로 한번 또 실행을 시켜 볼게요 지금 보시면은 우리가 넣은

세부 사항들 뭐 이름 이런 것들이 나오는 겁니다 지금 보면은 이름은 똑같은데 자 다른 아이디가 나왔어요 렇게 똑같은 이름으로 만들어졌다는

거예요 이거를 확인을 할 수가 있습니다 자 오픈 AI 사이트 오셔 가지고 여기 플레이그라운드 있죠 플레이그라운드를 들어가 보면은 자

여기 어시스턴트라고 되어 있어야 돼요 챗이 아니라 보시면은 쭉 있어요 그동안 제가 전에 만들었던 거 만들고

또 많이 지웠어요 그래서 지금 이거밖에 없는데 방금 만든 이름 똑같은 거 두 개가 있죠 이 밑에 아이디가 있는데 아까 코드에서

출력했을 때랑 비교해 보면은 어떤 건지 아실 수가 있어요. 물론 여기에서 삭제도 가능합니다. 여기 보면 어시스턴트 있죠.

요렇게 들어오면은 이렇게 있어요. 그다음에 언제 만들어졌는지도 있고요. 그러면 요렇게 눌러서 딜리트 해 주시면

돼요. 이렇게 지우면 만들어진 어시스턴트가 없어지는 겁니다. 그럼 저는 방금 두 개 다 지웠으니까 다시 한번 만들어 볼게요.

다시 한번 만든 다음에 자, 여기 아이디 있죠? 이 아이디만 복사해서 여기다 일단 복사 붙여 넣기 하고요. 요 부분은 주석 처리를 할

거예요. 그다음 다시 API 레퍼런스로 넘어와서 지금 뭐가 많지만은 제가 말씀드렸죠. 이번에는 아주 기본만 살펴볼

거예요. 어시스턴트 만들고 쓰레드 만들고 메시지 만들어 가지고 전송하고 대답 받는 거. 이렇게 워시는

만들었으니까 우리가 쓰레드를 만들어야 돼요 그러면은 똑같이 크리에이트 쓰레드 들어오셔 가지고 복사를 합니다

근데 위에 부분 필요 없죠 그 요렇게 3, 4번 4, 5번 줄만 복사를 할 거예요 그다음에 코드 돌아와서 붙여넣기 합니다 붙여넣기

하는데 아까 어시스턴트 만드는 부분 있죠 이거를 주석 처리한 이유가 있어요 이거를 만약에 주석 처리를 안

하면 계속 실행이 되겠죠 그러면은 계속 실행이 되고 어시스턴트가 계속 만들어지는 거예요 이거를 결과적으로는

나중에는 함수로 만들어 놓으면 좋겠죠 함수로 만들어 놓고 필요한 함수들 해서 실행을 하는 겁니다 그리고 어시스턴트 아이디는

나중에 쓰레드도 실행시키고 메시지 만들어 가지고 지 보낼 때 필요해요 이 아이디가 있어야지 이 어시스턴트한테

우리가 말을 걸고 뭐 기능을 사용할 수 있는 겁니다 자 지금은 요렇게 쓰레드를 하나 만드는 거야 빈 쓰레드를

만든다고 되어 있죠 그리고 실행을 시켜 볼게요 자 실행을 시키면 이렇게 출력이 됐습니다 여기도 마찬가지로 이

아이디가 중요해요 그러니까 아이디를 복사해서 요렇게 넣어 줄게요 자 그다음으로는 우리가 어시스턴트 만들고 쓰레드도

만들었으니까 이제 메시지를 만들 거예요 메시지 들어와서 똑같이 크리에이트 부분 들어갑니다 그다음에요 부분만 또

복사를 할게요 자 지금 보시면 여기는 필수인게 좀 있어요 쓰레드 아이디 필수 방금 우리가 복사 붙여 넣게 한 거 있죠 그리고 롤

우리가 이제 유저로 넣는 거예요 유저로 넣어서 내가 어떤 거 질문할 뭐 이제 여기도 보면 영어로 질문이

되어 있죠 이런 식으로 내 질문을 넣는 겁니다 자 방금 복사한 거 이렇게 붙여 넣기 하고요 우리가 롤은 유저 그대로 두고

컨텐츠는 그냥 인사 정도만 해 볼게요 그 지금 보시면 여기 쓰레드 하고 A, B, C, 1, 2, 3 되어 있는 거 있죠

이게 뭐냐면 쓰레드 아이디예요 그러니까 우리는 지금 여기 같은 경우는 요거를 이렇게 지우고 요렇게

넣어 주시면 됩니다 이제 실행을 하면은 쓰레드 메시지가 만들어집니다 그런데 그전에 여기 쓰레드를 만들었던 코드는 주석

처리를 해야겠죠 안 그러면은 새로운 쓰레드가 또 만들어지는 겁니다 그다음에 실행을 시키면 아 요렇게 제가 안녕하세요라고

메시지를 보내는 쓰레드 메시지가 만들어졌어요 그럼 이제 메시지 만들어졌으니까 실행을 할 겁니다 다시

사이트로 넘어오셔 가지고 API 레퍼런스에서 이런 부분 런스 부분 들어오셔 가지고 똑같이 마찬가지예요 크리에이트

런 들어오시면 돼요 이런 부분을 복사해서 코드에 넣어야죠 코드에 넣고 자 메시지는 또 만들 필요가 없으니까 요것도 주석 처리를

하고요 지금 이런 안에 보시면은 쓰레드 아이디 어시스턴트 아이디가 있죠 우리는 이미 이게 변수로 나와

있기 때문에 여기게 당연히 필요가 없어요가 이렇게 변수로 되어 있는 거로 넣어 주면 됩니다 이렇게 그다음에 이거를 저장을 하고

자 실행을 또 시켜 볼게요 실행을 시키면 이렇게 나왔습니다 이렇게 나온 거에서 우리가 크게 뭐

알아볼 만한 부분은 없어요 물론 뭐 이런 건 알 수 있죠 우리가 어떤 모델을 사용했는지 이런 것들이 있는데

여기서 또 중요한 게 이 런 아이디가 중요합니다 이게 필요한 거예요 런 아이디를 복사해서 요렇게 넣고요 이 런 부분은

주석 처리를 할게요 이 런에서 계속 실행이 되는 겁니다 주석 처리 안 돼 있으면은 우리가 방금 한 게 또 실행되고 또 실행되고 하는 건데

우리가 지금 한 과정 모든 거는 어시스턴트 만들었고 쓰레드 만들어서 이 쓰레드 안에서 이거를 실행을 이미 한

상태예요 아직 응답만 안 받은 거죠 그럼 다시 API 레퍼런스로 돌아와서 런에서는 해 줘야 될 게 하나

더 있습니다 이거 리트리브 런 이제 검색하다 거요 런을 검색을 해서 결과를 받아와야 돼요 그러면은 요걸도 복사를 해서 사용을

해야겠죠 자 생각을 해 보세요 우리가 챗 GPT 그냥 사용을 하거나 아니면 API 일반적으로 사용을 할 때도 우리가 말을 하면은 바로 대답을 해

주는 게 아니잖아요 돌아가는 시간이 필요한 거예요 그렇기 때문에 기다려야 됩니다 그럼 여기 코드를 복사해서

넣고 이번엔 런 아이디가 있잖아요 여기 이 런 아이디 요렇게 사용이 되는 거죠 쓰레드 아이디는 아까처럼

당연히 쓰레드 아이디가 들어가고요 그다음에 저장을 하고 실행을 시켜 볼게요 실행을 시키면 이렇게 나왔습니다 자 실행 시켰는데 여기에도

뭐 딱히 우리가 응답받은 메시지는 없죠 하지만 중요한 부분이 있습니다 여기 스테이터스라는 부분이 있는데 지금

완료가 된 상태예요 그 이유가 뭐냐면 우리가 실제로 만들어서 실행한지는 시간이 좀 지났잖아요 그러니까 이미

모든 응답이 끝났다라는 상태입니다 이거를 이거에 대해서 어떻게 보냐면 자 여기 이 부분 들어오시면 여기 런

있죠 여기를 클릭을 해 보세요 클릭을 하면은 스테이터스가 어떤 것들이 있는지 나옵니다 우리가 아직 실행을

하고 있을 때는 이게 떠요 이게 뜨고 지금 뭐 이런 거 실패하면 이런게 뜨겠죠 지금은 성공을 했으니까 이렇게

완료됐다고 나오는 겁니다 그럼 이제 메시지만 가져오면 되는데요 자 여기 메시지로 다시 들어가셔 가지고 여기 리스트

메시지라고 있습니다 이렇게 들어온 다음에 자 이렇게 있죠 이 부분을 복사를 하고요 자 여기다 이렇게 붙여 넣기를

할게요 붙여 넣기 하는데 여기 쓰레드 아이디가 들어가는 거예요 그러니까 요렇게만 넣어 주시면 돼요

자 지금 그리고 요것도 주석 처리 하셔도 되는데 이거는 주석 처리 안 한다고 별다른 문제가 생기는 게 아닙니다 이거는 만드는 게 아니라 말

그대로 검색을 하는 거예요. 지금 우리가 이 번호로 이 쓰레드 아이디에 이런 아이디를 검색을 해서 방금 이런 부분이 출력이 된

거잖아요. 어떤 정보를 갖고 있는지, 뭐 스테이터스가 어떤지 이렇게 출력이 된 거니까 뭐 꼭 주석 처리는 안 하셔도

되는데 우리가 지금 필요는 없으니까 주석 처리하고 지금 다시 실행을 시켜 볼게요. 자, 그럼 여기에서 우리가

응답을 받은 메시지, 이겁니다. "안녕하세요. 무엇을 도와드릴까요?" 그러면 우리가 요것만 출력을 해보고 싶잖아요.

OpenAI Assistants API 기초 사용법

초보자, 비전공자, 누구에게나 유익하고 재미있는 채널!
프로그래밍 관련 팁, IT 뉴스, 인공지능(챗GPT 등), 파이썬, 자동화, 웹 크롤링을 주로 다루고 있습니다.

광고, 비즈니스 문의: kimflstudio@gmail.com

강의 내용에 대한 질문은 댓글을 이용해 주세요.


프로그래머 김플 스튜디오

OpenAI Assistant API 소개 및 기존 API와의 차이점

새롭게 업데이트된 OpenAI Assistant API는 나만의 AI 도우미를 만들어 지속적으로 사용할 수 있게 해준다.

기존 API는 실행 종료 시 설정과 대화 내용이 사라져 대화를 이어갈 수 없었지만, Assistant API는 설정과 대화 내용을 유지한다.

코드 실행, 문서 업로드 등 다양한 기능을 사용할 수 있다.

현재 베타 버전이며 앞으로 더 개선될 예정이다.

이전 대화 내용을 기억하고 응답하는 기능을 시연한다.

Assistant API 사용 방법 설명 및 코드 구조

OpenAI 사이트의 문서와 API 레퍼런스를 참고하여 사용 가능하다.

Assistant API의 실행 과정(사용자 지침 설정, 모델 선택, 쓰레드 생성, 메시지 추가, 실행 및 결과 수신)을 설명한다.

API 레퍼런스를 통해 어시스턴트 생성, 쓰레드 관리, 메시지 전송 등의 기능을 확인할 수 있다.

파이썬 코드를 이용하여 Assistant API를 사용하는 방법을 설명한다.

모델 선택(GPT-4, GPT-3.5 Turbo 등)과 툴(코드 인터프리터 등) 사용에 대한 설명.

Assistant API를 이용한 어시스턴트 생성 및 쓰레드, 메시지 생성

어시스턴트 생성, 쓰레드 생성, 메시지 생성 및 전송, 응답 수신 과정을 코드와 함께 설명한다.

쓰레드 생성 코드를 설명하고, 어시스턴트 생성 코드를 주석 처리하는 이유를 설명한다.

메시지 생성 코드를 설명하고, 쓰레드 ID와 롤(유저), 콘텐츠를 설정하는 방법을 보여준다.

메시지 생성 후 쓰레드 생성 코드를 주석 처리한다.

런(실행) 코드를 설명하고, 메시지 생성 코드를 주석 처리한다.

런 검색을 통해 결과를 가져오는 과정을 설명한다.

런 아이디와 쓰레드 아이디를 사용하여 응답을 가져온다.

메시지 리스트를 통해 응답 메시지를 가져오는 방법을 설명한다.

리스트 형식의 데이터에서 응답 메시지를 추출하는 방법을 설명한다.

반복문을 사용하여 런의 상태를 확인하고 응답을 가져오는 방법을 설명한다.

이전 대화 내용을 기억하는 기능을 다시 확인한다.

향후 파일 업로드 및 처리 등의 응용 예시를 언급한다.

API 사용 비용에 대한 설명과 꼼꼼한 확인을 당부한다.

본인의 경험을 바탕으로 API 사용에 대한 추가적인 조언을 제공한다.