GPTScript 로 로컬 CLI 와 대화하기

GPTScript 로 로컬 CLI 와 대화하기

GPTScript 는 로컬 워크스테이션에 설치된 CLI 나 실행 파일과 AI 연동을 쉽게 만듭니다. 복잡한 요청을 평범한 영어로 적으면 GPTScript 가 그 목적에 맞는 CLI 명령을 스스로 골라 실행합니다.

이 가이드는 GitHub 의 gh CLI 와 연동하는 스크립트를 만듭니다. gh 는 이 스크립트가 설치하지 않으니, gh auth login 으로 로그인돼 있다고 가정합니다.

출처: Chat with a Local CLI — 공식문서

엔트리포인트 도구 만들기

cli-demo.gpt 파일을 만들고 메인 도구를 적습니다.

Context: learn-gh

You have the gh cli available to you. Use it to accomplish the tasks that the user asks of you.
  • Context: 줄은 이 도구가 실행되기 전에 먼저 실행될 컨텍스트 도구를 가리킵니다. 컨텍스트 도구는 LLM 이 자신의 능력과 해야 할 일을 이해하도록 도와주는 출력을 냅니다.
  • Chat: true 로 두면 이 도구가 '채팅 가능한' 에이전트가 되어 사용자 입력을 받으며 대화형으로 동작합니다. false(또는 미지정)면 사용자 상호작용 없이 한 번만 실행되고 끝납니다.

learn-gh 컨텍스트 도구

---
Name: learn-gh

#!/usr/bin/env bash

echo "다음은 gh cli 와 그 하위 명령의 도움말입니다. 새 명령을 만들 때 참고하세요."
gh --help
gh repo --help
gh issue --help
gh pr --help
  • 파일 맨 위의 --- 는 블록 구분자로, 한 파일 안에서 도구들을 구분합니다.
  • Name: 필드로 앞선 Context: learn-gh 와 연결됩니다.
  • 본문이 #! 로 시작하면 GPTScript 는 이를 프롬프트가 아니라 스크립트(쉘)로 인식해 실제 실행하고, 그 출력을 LLM 에게 제공합니다.

실행

gptscript cli-demo.gpt

채팅이 시작되면 "gptscript-ai/gptscript 리포에 제목과 본문이 있는 이슈를 하나 열어줘" 같은 요청을 해 봅니다. GPTScript 는 각 명령을 실행하기 전에 확인을 요청하므로, 의도한 명령만 실행되는지 제어할 수 있습니다.

더 알아보기