실습 노트
AstrBot으로 메신저 에이전트 구성하기: 채널·도구·샌드박스 분리
AstrBot 공식 README와 문서를 바탕으로 여러 메신저에 AI 에이전트를 붙일 때 나눠 설계할 계층을 정리합니다.
AI 에이전트를 메신저에 붙일 때 채널마다 모델과 도구를 따로 구현하면 운영이 빠르게 복잡해집니다. AstrBot 공식 README는 메시지 플랫폼, LLM·에이전트, 플러그인, 샌드박스를 분리해 연결하는 오픈소스 구조를 제시합니다.
메신저는 입력 표면으로 분리한다
AstrBot은 Telegram·Slack·DingTalk·Feishu 등 여러 플랫폼을 지원한다고 설명합니다. 이때 플랫폼별 메시지 형식과 인증은 채널 계층이 맡고, 모델 선택과 도구 호출은 공통 에이전트 계층에서 관리하는 편이 좋습니다.
| 계층 | 책임 |
|---|---|
| 채널 | 메시지 수신·응답·권한 |
| 모델 | LLM·멀티모달 호출 |
| 에이전트 | 계획·도구 사용·대화 맥락 |
| 플러그인 | 외부 서비스와 기능 연결 |
| 샌드박스 | 코드·셸 실행 격리 |
이렇게 나누면 채널을 바꾸어도 업무 흐름을 다시 만들 필요가 줄어듭니다.
도구 연결은 읽기부터 시작한다
공식 기능 목록에는 MCP, 스킬, 지식 베이스, 웹 검색, 플러그인 확장이 함께 포함됩니다. 처음부터 쓰기 권한을 넓히기보다 검색·조회처럼 부작용이 적은 도구로 에이전트의 호출 흐름을 확인하는 것이 안전합니다.
- 모델과 채널 하나 연결
- 읽기 전용 검색 도구 추가
- 호출 로그와 응답 형식 확인
- 별도 샌드박스에서 제한된 실행 테스트
- 승인 뒤에만 쓰기 작업 추가
샌드박스는 권한 경계다
AstrBot 문서는 에이전트 샌드박스를 격리된 코드·셸 호출과 세션 단위 자원 재사용을 위한 기능으로 소개합니다. 샌드박스가 있다고 해서 모든 위험이 사라지는 것은 아니므로 네트워크·파일·비밀값 권한을 별도로 제한해야 합니다.
적용 판단
메신저 에이전트의 핵심은 채널 수가 아니라 계층 분리입니다. AstrBot은 여러 채널과 플러그인, 웹 화면, 샌드박스를 한 프레임워크에서 검토할 수 있는 사례입니다. 작은 채널 하나와 읽기 전용 도구로 시작해 권한과 운영 로그를 단계적으로 넓히는 구성이 현실적입니다.