ADK로 에이전트 만들기

ADK로 에이전트 만들기

Botpress ADK(Agent Development Kit)는 TypeScript로 에이전트를 코드에서 만드는 라이브러리예요. 비주얼 스튜디오가 드래그 앤 드롭이라면, ADK는 코드로 워크플로와 에이전트 로직을 직접 작성하는 개발자 중심 경로예요.

출처: https://botpress.com/docs/adk-v2/get-started/introduction/

왜 코드로 만들까요

비주얼 에디터가 편한 경우도 있지만, 에이전트 로직이 복잡해지면 코드로 표현하는 편이 버전 관리와 재사용에 유리해요. ADK는 그런 팀을 위해 설계된 TypeScript SDK예요.

로컬 개발과 CLI

Botpress는 로컬 개발을 위한 CLI를 제공해요. 전역으로 설치하고 버전을 확인하는 기본 흐름은 이래요.

npm install -g @botpress/cli
bp --version

이 CLI로 에이전트 코드를 만들고, 실행하고, Botpress Cloud에 배포할 수 있어요. @botpress/cli 패키지의 bp 명령이 로컬 개발과 배포의 핵심 진입점이에요.

워크플로 작성

ADK에서 에이전트의 행동은 워크플로(workflow)로 표현해요. 상태, 조건, 도구 호출을 코드로 구성하고, 필요하면 외부 API와 연동해요. 특히 웹훅(webhook)을 에이전트에 추가하면 외부 서비스가 특정 이벤트로 에이전트를 호출하게 만들 수 있어요.

  • 상태 관리: 대화의 흐름을 코드로 관장해요.
  • 도구·통합: 외부 도구와 채널에 연결해서 실제 행동을 수행해요.
  • 배포: CLI로 작성한 코드를 클라우드 환경에 올려 운영해요.

더 알아보기

  • 비주얼로 만들고 싶다면 «Studio로 에이전트 만들기»를 보세요.
  • 앱에서 에이전트를 호출하는 방식은 «Platform API 호출하기»에서 다뤄요.