Bash와 curl, jq만으로 AI 코딩 에이전트를 만든다

Bash, curl, jq만으로 AI 코딩 에이전트를 만드는 튜토리얼입니다. OpenAI 호환 엔드포인트(endpoint) 가운데 도구 호출(tool calling)을 지원하는 곳에서 작동합니다. 로컬 모델도 연결할 수 있습니다. 저는 준비물이 적다는 점보다 모델이 실제 명령을 실행하게 되는 순간이 더 눈에 들어왔습니다.

파이썬 306줄과 requests로 코딩 에이전트를 만드는 튜토리얼도 소개됐습니다. 이 튜토리얼은 Bash, curl, jq로 에이전트의 요청·대화·명령 실행 흐름을 세 단계로 나눕니다. 두 사례 모두 모델에게 명령 실행 권한을 주는 구조를 다루므로, 간결한 구현이 곧 안전한 실행을 뜻하지는 않습니다.

처음에는 서버에 요청을 보내 답을 받고, 다음에는 대화를 이어 가는 반복 구조를 만듭니다. 마지막에는 모델이 요청한 명령을 실행하고 그 결과를 다시 돌려줍니다. 에이전트가 답변을 내놓는 데 그치지 않고 작업까지 이어지는 과정을 세 단계로 따라갈 수 있다는 점이 흥미롭습니다.

다만 도구 호출 기능을 지원하는 엔드포인트가 필요하므로, 로컬 모델도 모두 연결되는 것은 아닙니다. 더 큰 위험은 세 번째 스크립트가 모델이 요청한 명령을 확인 절차 없이 사용자 권한으로 실행한다는 점입니다. 실행 중 명령이 화면에 표시되더라도, 중요한 파일이 있는 곳에서 급히 넘기면 안전장치가 되지 못합니다.

따라 해 보려면 중요한 자료가 없는 임시 디렉터리에서 시작하고, 먼저 03-Harness.sh의 명령 실행 부분을 읽으십시오. 단계별로 실행하면서 화면에 나타난 명령이 예상과 다르면 멈추고, 파일을 만들거나 실행하는 범위가 의도한 디렉터리 안에 머무는지 확인하십시오.

AI 도구에 명령 실행 권한을 줄 때, 어떤 작업은 허용하고 어떤 작업은 직접 확인하십니까?