[📪정보] 나만의 ChatGPT 플러그인 만들기 1편(프로그래밍 지식 없어도 가능)

[Ad_Astr..(peraspera83)]

내가 처음 플러그인을 만들고 싶다고 결심했을 땐 나와있던 한국어 자료도 없었고

영어 자룐 있었지만 만족스럽진 못했었음

그래서 앞으로 이걸 보는 이들은 ChatGPT 플러그인을 만드는 데에 더 이상 나같은 시행착오를 겪지 않도록 하고자 이 글을 작성함

이 글은 플러그인의 제작, 배포까지 모든 과정을 포함해 가이드할 예정이니 잘 따라오길 바람

Chapter 1. 아이디어 구상하기

이미 만들고 싶었던 플러그인이 있다면 이 챕터는 넘어가도 좋음

당연한 소리지만 만들고 싶은게 없으면 배울 의미도 없지

근데 생각보다 아이디어 짜는게 쉬운 일만은 아니기 때문에

따로 이 챕터를 만들어야 겠다고 결심함

내가 경험한 바로, 아이디어 짜는게 어려운 이유는 크게 두 가지임

1. OpenAI가 앞으로 내 플러그인의 기능을 자체적으로 구현해 버릴 수 있음

2. 채팅에 국한된 인터페이스에 뭘 더 넣어야 사용자가 만족할 수 있을 지가 막막함

그래서 아이디어를 구성하는데에 내가 추천하는 방법은,

다른 플러그인들을 두루두루 사용하고, 그곳에서 부족한 점을 찾아 그 기능을 보완해보기임

지금 이 글 작성 기준으로 정식으로 출시되어 plugin store에 나와있는 플러그인은 8*76 + 5 = 701개임

이걸 하나하나 다 보란 소린 아니고, 쓸만한 플러그인 몇 개 고르다보면 '아 이게 안되네' 하는게 나옴

내 경험을 얘기해주자면, 필자는 한 영어 다큐멘터리 채널의 영상을 한국어로 번역하는 봉사를 취미삼아 하고 있음

근데 유튜브 영상을 가져와 요약해주는 플러그인이 있다고 해서

'그럼 유튜브 영상 자막을 가져온 다음 요약하겠네?' > '그럼 번역도 가능하지 않을까?'

라는 사고가 돌아가기 시작했고

그 결과 ChatGPT는 내 예상대로 자막을 번역해서 줄줄이 읊어냈음

근데 문제는 이제 이걸 자막 파일로 만들어야 하는데,

아는 사람은 알겠지만, 자막 파일은 그 자막이 시작하는 시간과 끝나는 시간이 적힌 타임 스탬프가 포함되어야 함

단순히 번역기로 쓰기엔 너무 아깝다 싶어서, 자막 번역 작업 + 형식화 작업까지 알아서 해주면 얼마나 좋을까?

라는 생각이 듦

현재 나와있던 플러그인 중에 자막 타임스탬프까지 가져오는 기능이 있는 플러그인은 없었기 때문에, '아, 이거구나!'

싶어서 바로 작업 들어감

Chapter 2. 플러그인의 작동 방식 알아보기

순서대로 설명하자면 다음과 같다

1. 당신이 만든 플러그인에 대해 GPT가 이해할 수 있도록 설명을 해 놓은 파일을 GPT가 읽는다

• 이때, GPT에게 '그 설명을 해놓은 파일'을 '여기있어' 하고 줄 순 없다. 이 파일을 저장해 놓은 당신만의 사이트가 있어야 한다
• '그 파일'에는 당신의 플러그인을 어떻게 GPT가 쓰면 되는지에 대한 정보가 담겨 있다(필수)

2. 그렇게 제작한 플러그인을 plugin store에 등록한다

• plugin store에 당신의 플러그인이 정식으로 등록되려면 OpenAI 개발자 계정이 있어야 가능하다
• 개발자 계정은 여기에서 이름, 이메일, 주소 적고 How do you want to use plugins? 항목에 I am a developer and want to build a plugin에 체크하고 무슨 플러그인 만들고 싶은지 적는 란(What do you want to build a plugin for?)에 무슨 플러그인 만들지 적고 제출한 다음 택배 오는거 기다리는 거 마냥 이메일 존나 새로고침 하면서 OpenAI 로부터 온 메일을 손가락 쪽쪽 빨면서 기다리면 받을 수 있다(아래 사진은 미래의 당신이 보게 될 메일)

• 개발자 계정을 받았다면, 이제 plugin store에 새로운 버튼(Install an unverified plugin, Develop your own plugin)이 생겼을 것이다. Develop your own plugin 버튼을 누르고 제작한 플러그인을 제출하자(이 과정이 없으면 OpenAI는 당신이 무슨 플러그인을 만들었는지 모른다. 꼭꼭 제출마다, 업데이트마다 잊지말고 제출하자)

• OpenAI 계정으로 로그인하고 여기로 가서 맨 밑에 plugin submission bot이라 써진 초록색 글씨를 클릭한다
  
• 플러그인을 제작할 때에 지켜야할 수칙을 모두 지켰는가를 재확인 시켜주는 설문을 완료하면 다음과 같은 메일이 도착해 있을것이다

• 플러그인 검토 중, 플러그인 제작 약관에 위배되는 사항이 있었다면, 해당 사항을 고쳐달라는 내용의 메일을 받게 될 것이다. 무슨 사항 때문에 거부됐는지 친절하게 알려준다

• 아무 문제가 없이 넘어간다면, 보통 빠르면 24시간 내에, 느리면 이틀 안에 당신의 플러그인이 plugin store에 정식으로 등록되었다는 메일을 받게 된다

3. 유저들이 당신의 플러그인을 plugin store에서 다운 받고 실행 시킨다

4. 당신의 플러그인에 이용된 API에 대한 정보를 보고, 그에 따라 endpoint를 작성해 관련 정보를 요구한다 (나중에 설명할테니 모르면 일단 넘어가자)

5. 당신의 API가 호스팅된 웹사이트가 GPT가 적은 endpoint 내용에 따라 GPT가 요구한 정보를 가져다 준다 (나중에 설명할테니 모르면 일단 넘어가자)

6. 당신의 웹사이트의 응답을 바탕으로 해서 GPT가 자연어를 추가해 유저가 보기 좋게 가공해 전달한다

Chapter 3. 필요한 것 알아보기

ChatGPT 플러그인을 만드는데에 반드시 필요한것들이 있다

1. 플러그인 기능을 구현할 코드(언어 상관 없음)
2. 플러그인 기능 실현에 도움을 줄 API(프로그래밍 관련 지식이 없다면, 이 부분에 대한 설명을 자세히 읽는 것을 추천한다)
3. 내 플러그인이 뭐하는 플러그인인가를 GPT에게 알려줄 텍스트(ai-plugin.json)
4. 내 플러그인에 쓰인 API를 GPT가 어떻게 쓸 수 있는지 알려줄 텍스트(openapi.yaml)
5. 내 플러그인에 쓰인 API 요청을 GPT와 주고 받을 수 있는 나만의 웹사이트(호스팅 서버 필요)
6. OpenAI 개발자 계정(제출용임, 이거 없어도 '제작'은 가능함)

참고 : 99% 확률로 필요할 것들(이 글에서 이용할 것들이기도 함)

1. git
2. github 계정

대부분 왜 있어야 할 지 짐작은 가겠지만 프로그래밍에 경험이 없는 독자들에겐 이것만으로 이해하긴 어려울 수 있다

지금부터 각각이 무슨 역할을 하는지 알아보자(1번은 왜 있어야 하는지 너무 당연하므로, 6번은 앞 챕터에서 설명했으니 생략)

3)

모든 플러그인은 ai-plugin.json 파일이 요구된다. 이게 없으면 플러그인이 제출은 커녕 작동조차 못 한다

ai-plugin.json 파일이 하는 일은, 앞에서 말했듯이 간단히 말하면 '내 플러그인은 이런 플러그인이야~'를 GPT에게 가르쳐 주는 용도이다

다음은 ai-plugin.json 파일의 예시다

{

"schema_version": "v1",

"name_for_human": "TODO List",

"name_for_model": "todo",

"description_for_human": "Manage your TODO list. You can add, remove and view your TODOs.",

"description_for_model": "Help the user with managing a TODO list. You can add, remove and view your TODOs.",

"auth": {

"type": "none"

},

"api": {

"type": "openapi",

"url": "http://localhost:3333/openapi.yaml"

},

"logo_url": "http://localhost:3333/logo.png",

"contact_email": "[e-mail]",

"legal_info_url": "http://www.example.com/legal"

}

위에서 우리가 주목해야 할 부분은

• name_for_human
  
• name_for_model
  
• description_for_human
  
• description_for_model
  
• auth
  
• url
  
• logo_url
  
• contact_email
  
• legal_info_url
  

정도다

쓰고 놓고 보니 필요없는 부분을 알려주는게 훨 나았을 듯 싶지만 넘어가자

먼저

name_for_human : 이름 그대로, 일반 유저들에게 보일 플러그인의 이름이다. 우리가 plugin store에서 마주치는 이름들이 여기에 속한다. 위 예시에서 'Wolfram'에 해당한다

name_for_model : 이것 역시 이름 그대로, 언어모델(GPT)에게 보여질 이름, 즉, ChatGPT가 보게 될 당신의 플러그인의 이름이며, 일반 유저들은 이걸 볼 방법이 없다

description_for_human : 유저들에게 보여질 당신의 플러그인의 설명이다. 당신의 플러그인이 무슨 역할을 하는지 보여줄 짧은 설명이다. 'Access computation, math, curated knowledge & real-time data through Wolfram|Alpha and Wolfram Language.' 가 이에 해당한다.

description_for_model : 모델에게 보여질 당신의 플러그인의 설명이다. 사실 이게 무엇보다도 중요하니 이에 대한 자세한 설명은 뒤로 미뤄두겠다.

auth : 인증방식이다. 이 글을 쓰고 있는 현재 OpenAI에선 서비스 레벨인증, OAuth를 지원한다. 무슨 얘긴지 몰라도 좋다. 만약 당신의 플러그인이 실제 세계에 영향을 미친다면(예를 들어, 쇼핑 앱에서 장바구니에 품목을 담는 기능을 한다면) 반드시 설정해야 한다.

url : 당신이 플러그인이 호스팅 되고 있는 메인 주소 링크를 적는 란이다. 호스팅 챕터에서 자세히 설명하겠다.

logo_url : 당신의 플러그인의 로고를 호스팅하고 있는 주소이다. 없어도 될 것 같지만 아니다.

contact_email : 이름 그대로, 개발자인 당신의 이메일을 적는 란이다. 이 역시도 없으면 안된다.

regal_info_url : 당신의 플러그인의 법적 정보를 담고 있는 홈페이지의 주소를 적는 란이다. 또한 없어선 안된다.

각각의 항목을 적는데에는 반드시 지켜야할 수칙이 있으며, 이는 다음과 같다.

출처 : https://platform.openai.com/docs/plugins/getting-started/plugin-manifest

name_for_human : 최대 20자(알파벳 기준)

name_for_model : 최대 50자, 띄어쓰기 없이 문자와 숫자로만 구성

description_for_human : 최대 100자

description_for_model : 최대 8000자, 왜 이렇게 길게 쓸 수 있는지는 나중에 설명함

logo_url : GIF 포맷의 로고는 허용하지 않음, png 포맷으로 해야 함

가능한 기능만 제시할 것

올바른 문법으로 작성해야 하며, 구두법을 지킬 것

이름이나 설명에 plugin, chatgpt, gpt, openai 와 같은 내용이 들어가선 안 됨

지역 특색적(geographical limitations)인 기능이 있을 경우, 적어 놓을 것

이제 설명을 벼려왔던 description_for_model을 설명하겠다

description_for_model은 이름만큼 단순하지만, 결코 임팩트가 적지 않다. 예시로, 내가 만든 한 플러그인의 description_for_model은 6000자가 넘는다.

description_for_model은 당신의 플러그인이 플러그인이 무슨 역할을 하는지를 설명하는 공간이다.

OpenAI 오피셜로, ChatGPT는 플러그인을 언제 쓸지 알아서 알아먹는다고 나와있는데(Try a version of ChatGPT that knows when and how to use third-party plugins that you enable.), 다 개뻥이다. 이거보고 아는 거다.

플러그인이 무슨 역할을 하는지를 설명할 수 있다는 것은, 다음과 같은 내용을 당신이 적을 수 있음을 의미한다

• 당신이 언제(무슨 상황에) ChatGPT가 이 플러그인을 썼으면 하는가
• ChatGPT가 이 플러그인을 어떤 식으로 활용했으면 하는가

예시로, 내가 만든 한 플러그인의 description_for_model field를 공개하겠다

Plugin for retrieving YouTube video captions. You can retrieve captions from any YouTube video by providing its URL. You can also use the caption for translating and summarizing the video. You can select which language and type to retrieve, the type has set to manual by default, and retrieve language which user's language used for retrieving request if there's no mention of it. If there's no manually created captions available, retrieve auto generated one. When being asked to translate, try to retrieve English caption, if there's none, list available language and retrieve the easiest one you can translate, then translate it by yourself.

여기서 내가 ChatGPT에게 요청했던 사항은 다음과 같다

• 이 플러그인은 유튜브 영상 링크로부터 자막을 추출하는데에 사용할 것
• 자막을 추출한 뒤, 그 영상을 요약 또는 번역해달라는 유저에 요청에 응할 것
• 자막 포멧에 대해 아무 말도 없으면 그냥 내용만 추출할 것
• 자막을 srt 포멧(타임 스탬프가 있는 버전)으로 추출해달라 요청하면 그렇게 해줄 것
• 유저가 어떤 언어의 자막을 추출해달라 지정하지 않았다면, 유저가 요청을 할 때 이용했던 언어의 자막을 우선적으로 찾아볼 것
• 유저가 직접 제작한 자막이 없다면, 자동 완성 자막을 대신해서 추출할 것
• 번역을 해달라 요청을 받았을 경우, 영어 자막을 가져와 번역 할 것. 만약 영어 자막이 없다면, 너가 번역하기 제일 자신있는 자막을 가져올 것.

위의 요청 사항들은 크게 4가지로 나눌 수 있다

1. 언제 이 플러그인을 쓰는가

• 플러그인은 유튜브 영상 링크로부터 자막을 추출하는데에 사용할 것

2. 이 플러그인을 어떻게 활용 할 수 있는가

• 자막을 추출한 뒤, 그 영상을 요약 또는 번역해달라는 유저에 요청에 응할 것
• 번역을 해달라 요청을 받았을 경우, 영어 자막을 가져와 번역 할 것. 만약 영어 자막이 없다면, 너가 번역하기 제일 자신있는 자막을 가져올 것.

3. 세부적으로 요구하는 유저에게 어떻게 응하면 되는가

• 자막을 srt 포멧(타임 스탬프가 있는 버전)으로 추출해달라 요청하면 그렇게 해줄 것

4. 뭘 어떻게 해줘야 만족할 지 모르게 프롬프트를 준 유저를 대처하는 법

• 자막 포멧에 대해 아무 말도 없으면 그냥 내용만 추출할 것
• 유저가 어떤 언어의 자막을 추출해달라 지정하지 않았다면, 유저가 요청을 할 때 이용했던 언어의 자막을 우선적으로 찾아볼 것

description_for_model을 작성하는 것은 정말로 쉬운 일이니 걱정 말자.

예시에서 알 수 있듯이, 이걸 읽는 주체가 GPT이니 만큼, 이 부분은 자연어(그냥 평소에 GPT랑 대화하듯이)로 작성하기만 하면 된다!

2), 4), 5)

앞으로 설명한 내용은 플러그인 기능 구현에 필요한 'API'란 놈에 대한 거다

프로그래밍 지식이 없더라도 플러그인을 만들 수 있도록 하는 글을 쓰겠다고 제목에 떡하니 걸어놨으니 설명은 하겠다만,

딱 플러그인 제작 이해만 도울 정도로 알려줄테니, API에 대해 더 전문적으로 알아보고 싶으면 딴 데를 찾길 바란다

라며 직접 설명해보려고 호기롭게 시작했지만, 은연중에 GPT한테 물어보니 정작 내가 준비한 내용보다 설명을 너무 잘해서 그냥 복붙하겠다

음식점을 상상해봅시다. 음식점은 고객들이 원하는 음식을 만들어주는 공간입니다. 고객들은 메뉴를 보고 원하는 음식을 선택하고 주문하면, 주방에서 해당 요리가 만들어지고 고객에게 제공됩니다.

이 상황에서 API(Application Programming Interface)는 메뉴와 주문을 받는 서빙 직원으로 생각할 수 있습니다. 고객이 특정 요리를 선택하면, 그 요청을 주방으로 전달하고, 주방에서 만들어진 음식을 고객에게 가져다줍니다.

같은 방식으로, API는 프로그램 또는 애플리케이션 사이에 정보를 주고 받는 '중개자' 역할을 합니다. 프로그램이 특정 기능을 요청하면, API는 그 요청을 시스템으로 전달하고, 그 결과를 프로그램으로 반환합니다. 이런 과정을 통해 프로그램들은 다른 시스템의 기능을 이용할 수 있습니다.

따라서 API는 서로 다른 프로그램, 애플리케이션, 서비스 사이의 '통역사'나 '메신저' 같은 역할을 하며, 이들 사이에서 정보와 명령을 주고 받을 수 있게 해줍니다.

"특정 요리"는 API를 통해 요청되는 특정 기능이나 서비스를 의미합니다. 예를 들어, 날씨 정보를 가져오는 요청, 사용자 정보를 가져오는 요청, 또는 데이터베이스에서 정보를 검색하는 요청 등이 될 수 있습니다.

"주방"은 이런 요청을 처리하고 결과를 반환하는 백엔드 시스템을 의미합니다. 이 시스템은 데이터베이스, 서버, 클라우드 기반 서비스, 또는 다른 종류의 소프트웨어 애플리케이션일 수 있습니다.

요약하면, "특정 요리" 요청은 사용자(또는 다른 시스템)이 API를 통해 원하는 서비스, 데이터 또는 작업을 나타내고, "주방"은 그 요청을 처리하고 결과를 생성하는 시스템을 의미하는 것입니다.

다시 내 설명으로 돌아와서,

openapi.yaml은 이런 '요청'을 어떻게 하면 되는지에 관해 적어놓은 GPT를 위한 일종의 '설명서'다.

OpenAI가 직접 공개한 예시는 아래와 같다

openapi: 3.0.1

info:

title: TODO Plugin

description: A plugin that allows the user to create and manage a TODO list using ChatGPT.

version: 'v1'

servers:

- url: http://localhost:3333

paths:

/todos:

get:

operationId: getTodos

summary: Get the list of todos

responses:

"200":

description: OK

content:

application/json:

schema:

$ref: '#/components/schemas/getTodosResponse'

components:

schemas:

getTodosResponse:

type: object

properties:

todos:

type: array

items:

type: string

description: The list of todos.

관련 지식이 있다면 뭐가 어떻게 돌아가는 지는 알거라고 생각한다

관련 지식이 없어도 괜찮다! 미리 스포를 하자면, 어차피 이걸 적는 것은 당신이 아닐 것이다...

당신의 서버가 사용되는 용도는 다음과 같다

• ai-plugin.json, openapi.yaml, 플러그인 로고 파일 호스팅
• API 요청 백앤드 서버

이를 어떻게 하면 되는 지는 플러그인 제작 과정에 담도록 하겠다

(다음 편에 이어서)

[익명(211.57)]

글써준거 고마운데 나만 글이 희미하게 보이는거냐

[Ad_Astra(peraspera83)]

아 다크 모드로 써서 나만 선명하게 보이네 수정함

[Ad_Astra(peraspera83)]

아 참고로 내가 만든 플러그인은 plugin store에 yt caption retriever 치면 나와

[익명(119.207)]

플러그인이 많이 쓰여도 제작자한테 돌아가는 수익은 없는 거임?

[Ad_Astra(peraspera83)]

플러그인 중 구독료를 내도록 하는 플러그인이 몇 있던데 이거까진 내가 어떻게 하는지 모름... 일단 그거 없으면 플러그인은 그냥 무료임

[익명(119.207)]

플러그인 수익모델이 앞으로 어떻게 될지 관심이 가네요

[MoonChild(aowlr2001)]

[익명(landofooo)]

ㅁㅊ 왤케 정성글이냐 실.베츄

[익명(220.127)]

고맙읍니다..

[익명(221.140)]

정성정보글 개추