본문으로 건너뛰기

자체 도구를 작성하는 에이전트 구축하기

에이전트에게 OpenAPI 명세와 안전한 Deno 샌드박스를 제공하여, 정적 도구 래퍼 없이 스스로 필요한 도구를 작성하고 실행하는 NL 에이전트 패턴을 소개한다.

섹션별 상세

01
전통적인 에이전트 설계는 에이전트와 도구 레지스트리를 분리하여 관리하며, 이는 통합할 외부 시스템이 늘어날수록 관리 비용이 선형적으로 증가하는 구조적 한계를 가진다. API 엔드포인트가 변경될 때마다 래퍼를 수정해야 하므로 에이전트의 안정적인 운영이 어렵다.
02
NL 에이전트 패턴은 에이전트에게 사전 구축된 도구 대신 OpenAPI와 같은 원시 API 명세를 제공한다. 에이전트는 명세를 참조하여 필요한 기능을 수행하는 코드를 즉석에서 작성하고, 실행 결과에 따라 코드를 수정하며 학습한다.
에이전트 디렉토리에 포함된 GitHub OpenAPI YAML 파일 내용
Screenshot에이전트가 도구 작성을 위해 참조하는 원시 OpenAPI 명세 파일의 구조를 보여준다. 별도의 래퍼 없이 이 명세 자체가 에이전트의 컨텍스트로 활용됨을 나타낸다.
03
Deno는 이 패턴의 핵심 실행 환경으로, 파일 시스템 접근, 네트워크 허용 목록, 환경 변수 노출을 명시적으로 제어한다. NL_ 접두사가 붙은 환경 변수만 에이전트에 노출하는 방식으로 민감 정보 유출을 방지하며, 안전한 JavaScript 실행 환경을 제공한다.
GitHub 개인 액세스 토큰 생성 설정 화면
Screenshot에이전트가 외부 API에 접근하기 위해 필요한 최소 권한의 토큰 설정 과정을 보여준다. 보안을 위해 스코프를 제한하는 것이 중요함을 시사한다.
04
에이전트는 작성한 도구를 tools.js 파일에 저장하여 향후 작업에서 재사용한다. 이는 에이전트가 별도의 설계 없이도 스스로 도구를 생성하고 메모리화하는 창발적 패턴을 보여준다.
에이전트가 시스템 프롬프트를 읽고 도구를 작성하는 채팅 인터페이스
Screenshot에이전트가 사용자의 요청을 받아 시스템 프롬프트를 검토하고 연결성을 테스트하는 실제 상호작용 화면이다.
에이전트가 스스로 도구 코드를 작성하고 실행하는 채팅 로그
Screenshot에이전트가 getCodeownersFiles와 같은 도구를 직접 작성하고 실행하여 결과를 얻는 과정을 보여준다. 에이전트가 스스로 도구를 생성하는 능력을 입증한다.
05
에이전트가 도구 작성을 완료하면 런타임을 읽기 전용 모드로 전환하여 배포 가능한 아티팩트로 고정한다. 이 단계에서 tools.js와 시스템 프롬프트는 거버넌스가 적용된 완성된 에이전트 모델이 된다.
NL 에이전트 아키텍처의 데이터 및 워크플로 흐름도
Diagram에이전트가 모델, 커스텀 모델, 배포 단계로 이어지는 워크플로를 시각화한다. 에이전트가 어떻게 도구를 생성하고 배포까지 연결되는지 구조를 보여준다.

기술

  • Deno
  • OpenAPI
  • JavaScript
  • GitHub API

활용 사례

  • 코드베이스 유지보수 자동화
  • API 기반 데이터 수집 및 처리
  • 에이전트 도구 자동 생성
AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 06. 04.수집 2026. 06. 04.출처 타입 RSS

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.