Slack 에이전트, 이렇게 쉽게 만들 수 있습니다

Slack은 이미 팀이 일하는 공간입니다. 메시지, 스레드, 버튼, 이벤트 등 에이전트에 필요한 인터페이스가 기본으로 갖춰져 있어, 별도의 UI나 온보딩 플로우를 새로 만들 필요가 없습니다. 하지만 "Slack 에이전트를 만들고 싶다"는 생각을 실제 배포까지 이어가려면, 여러 시스템을 동시에 다뤄야 합니다.

Slack API 콘솔에서 앱 생성
OAuth 스코프 및 이벤트 구독 설정
웹훅 핸들러 작성 및 서명 검증 구현
Slack의 3초 응답 제한을 처리할 수 있는 인프라 배포

각 단계마다 별도의 문서가 있고, 이 모든 것이 하나로 맞물려 돌아가야 합니다.

Claude Code, OpenCode, Cursor, GitHub Copilot 같은 코딩 에이전트는 바로 이런 조율 작업에 적합합니다. 문서를 읽고, 의존성을 분석하고, 코드를 몇 초 만에 생성할 수 있기 때문입니다. 이 강점을 활용하기 위해 Slack 에이전트 스킬을 만들었습니다. 이 스킬은 Slack Agent Template을 기반으로 하며, 원하는 코딩 에이전트와 함께 사용할 수 있고, 한 번의 세션만으로 아이디어를 Vercel에 배포된 Slack 에이전트로 완성해 줍니다. 자동화할 수 있는 단계는 자동으로 처리하고, 자동화가 불가능한 부분은 정확히 어디를 클릭해야 하는지 안내합니다.

스킬 위저드로 아이디어에서 배포까지

스킬을 설치하고 위저드를 실행하세요:

그다음, 에이전트에서 스킬을 실행합니다. Claude Code를 사용하는 경우 다음과 같습니다:

위저드는 먼저 어떤 종류의 에이전트를 만들고 싶은지 물어봅니다. 예를 들어 "사내 문서를 기반으로 질문에 답하는 지원 에이전트"나 "매일 아침 팀원에게 업데이트를 수집하는 스탠드업 봇" 같은 답변을 줄 수 있습니다. 답변을 바탕으로 사용 사례에 맞는 맞춤형 구현 계획을 생성하며, 코드가 작성되기 전에 이 계획을 검토하고 승인할 수 있습니다.

이후 다섯 단계를 거치게 됩니다:

프로젝트 설정: LLM 프로바이더를 선택하면, 에이전트가 Slack Agent Template을 기반으로 프로젝트를 스캐폴딩합니다.
Slack 앱 생성: 에이전트가 앱 이름, 설명, 봇 표시 설정으로 manifest.json을 커스터마이징한 뒤, Slack 콘솔을 열고 앱 생성 및 워크스페이스 설치 과정을 안내합니다. OAuth 스코프, 이벤트 구독, 슬래시 커맨드는 템플릿에 미리 설정되어 있습니다.
환경 설정: 에이전트가 서명 시크릿, 봇 토큰, 프로젝트에 필요한 API 키 설정 과정을 안내합니다.
로컬 테스트: 에이전트가 개발 서버를 시작하고 Slack에 연결해 줍니다. 프로덕션에 배포하기 전에 봇에 메시지를 보내고 실시간으로 응답을 확인할 수 있습니다.
프로덕션 배포: 에이전트가 Vercel 배포와 환경 변수 설정을 안내합니다. 이 시점부터 git push를 할 때마다 자동으로 새 배포가 트리거됩니다.

스킬로 만들 수 있는 것

Slack 에이전트 스킬로 만든 에이전트는 다음과 같은 기능을 수행합니다:

메시지와 스레드를 넘나들며 멀티턴 대화 진행
민감한 작업 실행 전 사람의 승인을 대기
Slack에 실시간으로 응답 스트리밍
채널과 스레드를 자체적으로 읽기

에이전트는 도구(tools)를 통해 Slack 및 외부 시스템과 상호작용합니다. 도구란 에이전트가 특정 작업을 수행하거나 정보를 조회하기 위해 호출하는 함수입니다. 템플릿에는 다음 도구가 기본 포함되어 있습니다:

채널 메시지 읽기
스레드 컨텍스트 가져오기
채널 참여 (사람의 승인 필요)
이름, 토픽, 목적으로 채널 검색

코딩 에이전트에 자체 시스템과 연동하는 커스텀 도구를 추가하도록 지시할 수도 있습니다. 고객 정보 조회, 지원 티켓 생성, 데이터베이스 쿼리 등 원하는 기능을 도구로 만들면, 에이전트가 적절한 시점에 스스로 호출합니다.

Workflow DevKit은 에이전트를 안정적으로 유지해 주는 핵심 요소입니다. Slack 에이전트는 여러 메시지에 걸쳐 대화를 이어가거나, 누군가의 승인을 몇 시간이고 기다려야 할 때가 있습니다. Workflow DevKit을 사용하면 에이전트가 대화 중간에 일시 중단했다가, 외부 입력을 받은 뒤 정확히 멈춘 지점에서 다시 이어갈 수 있습니다. 도구 호출이 실패하면 자동으로 재시도하며, 응답은 실시간으로 Slack에 스트리밍됩니다.

휴먼 인 더 루프(Human-in-the-loop)가 기본으로 내장되어 있습니다. 에이전트가 채널 참여 같은 민감한 작업을 수행해야 할 때, 승인 및 거부 버튼이 포함된 메시지를 게시하고 일시 중단합니다. 과금은 실제 CPU 활성 시간 기준이므로, 승인이 며칠 걸리더라도 대기 중에는 비용이 발생하지 않습니다. 이 패턴은 메시지 전송, 데이터 수정, 외부 API 호출 등 승인이 필요한 모든 작업에 확장 적용할 수 있습니다.

AI Gateway를 통해 하나의 API 키로 주요 프로바이더의 수백 가지 모델에 접근할 수 있습니다. 모델 전환은 코드 한 줄만 바꾸면 되고, 특정 프로바이더에 장애가 발생하면 AI Gateway가 자동으로 다른 프로바이더로 라우팅하여 에이전트의 가동을 유지합니다.

더 깊이 알아보기

에이전트가 라이브로 동작하면, 기능을 확장하고 더 깊이 이해할 수 있는 몇 가지 방법이 있습니다.

Vercel Academy Slack Agents 과정은 Slack 앱 생성 및 설정부터 이벤트와 인터랙티브 메시지 처리, AI SDK를 활용한 에이전트 구축, 프로덕션 배포까지 전체 라이프사이클을 다룹니다.

Vercel 프리뷰 배포를 사용하면 프로덕션에 반영하기 전에 변경 사항을 테스트할 수 있습니다. Slack 봇의 경우, Slack의 웹훅 검증이 엔드포인트에 도달할 수 있도록 배포 보호를 우회해야 할 수 있습니다. 테스팅 가이드에서 설정 방법을 확인하세요.

Vercel Sandboxes를 사용하면 에이전트가 격리된 환경에서 코드를 실행할 수 있습니다. 스프레드시트 분석, 차트 생성, 데이터 변환 등 사용자가 제공한 스크립트를 인프라에 영향을 주지 않고 안전하게 실행할 수 있습니다.

시작하기

코딩 에이전트와 한 번의 세션이면 모든 과정을 완료할 수 있습니다.