랭체인 매니지드 딥 에이전트로 만드는 자동 실행 AI 에이전트, 도구와 스킬부터 슬랙 연동과 배포까지

핵심 메시지

• 해커뉴스와 X를 훑어 매일 아침 소셜 게시물 초안 세 개를 슬랙으로 보내주는 에이전트를 빈 프로젝트 폴더에서부터 완성하는 과정을 보여준다.
• 에이전트의 행동 규칙은 짧은 기본 지침 파일과, 필요할 때만 불러오는 '스킬' 문서로 나눠 관리한다.
• 대화 스레드가 바뀌어도 기억이 이어지도록 별도의 메모리 설정을 두고, 이전에 뽑은 주제를 반복하지 않게 했다.
• 슬랙 채널 연결과 정해진 시각 자동 실행까지 코드로 선언해두면 배포 시 필요한 인프라가 함께 구성된다.
• 완성된 구조는 소셜 초안 말고도 엔지니어링 업데이트, 고객 조사, 장애 요약 같은 반복 업무에 그대로 재사용할 수 있다.

쉽게 이해하기

랭체인이 자사 매니지드 딥 에이전트로 실제 업무용 에이전트를 처음부터 끝까지 만드는 과정을 영상으로 공개했다. 만들려는 것은 해커뉴스와 X의 최신 대화를 훑어 매일 아침 소셜 게시물 초안 세 개를 슬랙으로 보내주는 도우미다. 발표자는 이 에이전트를 직접 매일 쓰고 있으며 업계 대화를 따라잡는 시간을 크게 줄였다고 말한다.

출발점은 빈 폴더다. 전용 명령줄 도구로 프로젝트 뼈대를 만들면 에이전트의 진입점 파일이 생기는데, 여기서 사용할 모델과 도구, 하위 에이전트, 미들웨어를 정의한다. 발표자는 조사와 초안 작성처럼 범위가 뚜렷한 작업이라 굳이 추론 능력이 큰 대형 모델을 쓰지 않고 더 작고 저렴한 모델로 바꿔 비용을 아꼈다고 설명한다.

도구는 평범한 파이썬 함수에 데코레이터를 붙여 만든다. 함수의 설명 문구가 그대로 도구 설명이 되어 모델에 전달되고, 함수 인자가 에이전트가 조절할 수 있는 입력값이 된다. 해커뉴스는 인증 없이 쓸 수 있는 검색 API를 이용했고, X는 별도 토큰이 필요해 선택적으로 동작하게 만들었다. X 쪽이 오류를 내면 에이전트는 해커뉴스만으로 계속 진행한다.

지시문은 두 층으로 나뉜다. 항상 읽히는 기본 지침 파일에는 역할만 짧게 적고, 조사·작성·전송 방법 같은 구체적인 절차는 '스킬' 폴더의 문서로 뺐다. 스킬은 이름과 설명이 담긴 머리말을 보고 필요할 때만 불러오는 방식이라, 매번 모든 규칙을 문맥에 올리지 않아도 된다. 여기에 스레드를 넘나드는 메모리를 붙여 이전에 다룬 주제를 다시 꺼내지 않도록 했다.

마지막은 소통 창구와 실행 시각이다. 슬랙 연결과 평일 오전 9시 실행 일정을 각각 파일로 선언한 뒤 로컬에서 동작을 확인하고 배포하면, 메모리와 일정, 채널 설정이 함께 패키징돼 운영 환경이 만들어진다. 슬랙 앱은 배포 후 생성되는 매니페스트로 등록하고 자격 증명을 채운 뒤 다시 배포하면 연결이 끝난다.

주요 인사이트

• 지시문을 전부 한 파일에 몰아넣지 않고 '항상 읽는 짧은 규칙'과 '필요할 때 불러오는 스킬'로 나누면, 에이전트가 매 실행마다 읽어야 할 분량을 줄이면서도 상세한 작업 절차를 유지할 수 있다.
• 도구를 만들 때 함수 설명과 인자 이름이 곧 모델이 보는 사용 설명서가 된다. 코드 주석을 잘 쓰는 습관이 그대로 에이전트 품질로 이어지는 셈이다.
• 외부 API 하나가 막혀도 멈추지 않도록 보조 출처를 두는 설계는 매일 자동으로 도는 작업에서 특히 중요하다. 사람이 지켜보지 않는 시각에 실행되기 때문이다.
• 샌드박스처럼 기본 제공되는 요소도 필요 없으면 지우는 편이 낫다. 이 사례에서는 에이전트가 직접 만든 도구만 호출하므로 코드 실행 환경이 과했다.
• 슬랙은 마크다운과 서식 규칙이 조금 달라 첫 출력이 어색하게 보였는데, 발표자는 이를 에이전트에게 알려주고 기억하게 하는 방식으로 고쳤다. 운영 중 발견한 사소한 규칙도 메모리로 흡수할 수 있다는 뜻이다.

자주 묻는 질문

관련 AI 소식