GPTScript 도구 사용하기 — 스크립트를 확장하는 세 가지 방법

GPTScript 도구 사용하기

GPTScript 가 강력한 이유는 '도구(tool)' 입니다. AI 는 어떤 작업에 대해 매우 구체적인 지시를 받을 때 더 잘 동작하므로, 문제를 작고 명확한 조각으로 쪼개고 각각을 도구 하나에 맡깁니다.

출처: Using Tools — 공식문서

도구의 세 가지 종류

  1. 시스템 도구(System tools) — 모든 스크립트가 기본으로 쓸 수 있는 내장 도구(sys.read, sys.write 등). gptscript --list-tools 로 목록을 볼 수 있습니다.

    tools: sys.read, sys.write

현재 디렉토리의 파일을 모두 읽고, 하위 디렉토리로는 들어가지 말고, 이 디렉토리의 내용을 설명해 줘.

  2. 인스크립트 도구(In-script tools) — 같은 파일 안에서 정의하는 도구. 큰 스크립트를 작고 관리하기 쉬운 조각으로 쪼갤 때 유용합니다.

    tools: random-number

숫자를 하나 무작위로 골라서, 그 숫자에 관한 시를 써 줘.

---
name: random-number
description: 1에서 100 사이 무작위 숫자를 만든다.

1에서 100 사이의 숫자를 하나 골라 숫자만 반환해 줘.

  3. 외부 도구(External tools) — 웹에 올라와 있거나 로컬에 있는 도구 파일을 참조. 스크립트 여러 개에서 도구를 공유하거나, GPTScript 배포판에 없는 도구를 쓰고 싶을 때 사용합니다.

    tools: https://raw.githubusercontent.com/gptscript-ai/gptscript/refs/heads/main/examples/echo.gpt

"Hello, World!" 문구를 그대로 되풀이해 줘.

    OpenAPI 정의 파일도 GPTScript 도구처럼 참조할 수 있는데, 파일 안의 각 operation 이 하나의 도구로 취급됩니다.

GitHub 에 도구 패키징

도구를 GitHub 에 올려 github.com/... 형태의 URL 로 참조할 수도 있습니다. 이때 URL 앞에 http://나 https:// 를 붙이면 안 됩니다. 실행 시 GPTScript 가 해당 저장소를 로컬로 클론해 그 안의 도구를 실행합니다.

더 알아보기