n8n Microsoft Agent 365 트리거 설정: 팀즈·이메일에서 AI 워크플로 호출하기

핵심 메시지

• n8n의 Microsoft Agent 365 트리거를 쓰면 워드 문서, 엑셀 시트, 팀즈에서 n8n 워크플로를 직접 호출할 수 있다.
• 시작 전에 Microsoft 365 Copilot, Teams, Agent 365 라이선스와 전역 관리자(global administrator) 권한을 갖췄는지 확인해야 한다.
• 테넌트 ID, 클라이언트 ID, 클라이언트 시크릿 세 가지 자격 증명 중 하나라도 어긋나면 실행이 아예 안 되거나 오류로 끝난다.
• 에이전트 블루프린트는 봇 기반이 아니라 API 기반으로 만들고, 알림 URL에 n8n 트리거의 웹훅 주소를 넣어야 양쪽이 연결된다.
• 팀즈 채팅뿐 아니라 이메일 본문으로도 워크플로가 실행되지만, 답장을 보내려면 별도의 이메일 발송 도구를 붙여야 한다.

쉽게 이해하기

n8n이 Microsoft Agent 365 트리거를 내놓으면서, 워크플로를 부르는 방식이 달라졌다. 그동안은 n8n 화면이나 별도 앱에서 워크플로를 실행했다면, 이제는 사람들이 이미 하루 종일 머무는 워드 문서와 엑셀 시트, 팀즈 채팅 안에서 바로 호출할 수 있다. 영상 진행자는 기업용 마이크로소프트 환경을 쓰고 있다면 일하는 방식 자체가 바뀔 만한 변화라고 말한다. 다만 설정 과정이 지루하고, 자신은 한 가지 실수로 두 시간 넘게 디버깅했다고 솔직히 덧붙인다.

가장 먼저 걸리는 관문은 라이선스와 권한이다. Microsoft 365 Copilot과 Teams 라이선스, Agent 365 라이선스가 있어야 하고, 작업하는 계정은 전역 관리자여야 한다. 이게 맞지 않으면 이후 단계에서 온갖 문제가 쏟아진다고 강조한다. 진행자는 문서를 따라 한 단계씩 수동으로 진행하는 방법과, 상당수 단계를 자동화한 스크립트를 실행하는 방법 두 가지를 소개하고 본인은 스크립트를 택한다. 스크립트는 사전 요구사항을 점검하고 CLI가 없으면 최신 버전을 설치하는 것부터 시작한다.

자동화된 구간이 끝나도 사람이 직접 해야 할 일이 남는다. 생성된 manifest.zip을 Microsoft 관리 센터의 에이전트 항목에 업로드해 승인·활성화하고, 개발자 포털에서 에이전트 신원 블루프린트를 만들어야 한다. 이때 에이전트 유형은 봇 기반이 아닌 API 기반을 선택하고, 알림 URL에는 n8n의 Microsoft Agent 365 트리거 노드에서 복사한 웹훅 주소를 넣는다. 이 연결이 끊겨 있으면 마이크로소프트 쪽에서 아무리 메시지를 보내도 n8n이 받지 못한다.

n8n 쪽 구성은 비교적 단순하다. 트리거 노드를 추가하고(공개 시점 기준 베타), 채팅 모델과 메모리를 붙인 다음 자격 증명을 넣는다. 진행자는 Anthropic 모델을 쓰고 있지만 OpenAI나 제미나이, 오픈라우터 등으로 바꿀 수 있다고 설명한다. 메모리도 우선 간단한 것으로 시작한다. 진짜 조심할 부분은 자격 증명으로, 테넌트 ID와 클라이언트 ID, 클라이언트 시크릿을 공백이나 빠진 글자 없이 정확히 옮겨야 한다. 스크립트가 만들어 준 자격 증명 파일에서 그대로 복사하는 편이 안전한데, 수동 경로로 가면 블루프린트 시크릿이 암호화돼 있어 그 값을 쓸 수 없고 다시 만들어야 하기 때문이다.

마지막은 실제 테스트다. 팀즈에서 앱 목록의 에이전트를 찾아 인스턴스를 만들고 질문을 던지면, 실행 기록에 모델 호출과 메모리 조회를 거쳐 답이 돌아오는 과정이 남는다. 왕복에 1~2분이 걸리기도 한다. 이메일로 보낸 경우에는 본문만 입력으로 들어가고 제목은 전달되지 않았으며, 답장을 보내는 도구를 붙이지 않아 결과가 메일로 회신되지는 않았다. 웹 검색 도구도 없어서 모델이 자기 지식 컷오프를 언급하는 모습도 그대로 나온다. 도구를 붙이지 않은 에이전트가 무엇을 못 하는지 보여 주는 장면이기도 하다.

주요 인사이트

• 에이전트의 가치는 모델 성능만이 아니라 '어디서 부를 수 있느냐'에서도 나온다. 워드·엑셀·팀즈·이메일이 트리거가 되면 사용자는 새 도구를 배우지 않고도 자동화를 쓰게 된다.
• 이런 연동에서 실제 시간을 잡아먹는 건 로직이 아니라 라이선스, 권한, 자격 증명 같은 관문이다. 진행자가 두 시간을 날린 지점도 여기였다.
• 수동 경로에서는 블루프린트 시크릿이 암호화돼 있어 나중에 값을 다시 꺼낼 수 없다. 시크릿은 생성 시점에 확보하지 못하면 재발급해야 한다는 원칙이 그대로 적용된다.
• 이메일로 실행했을 때 제목이 아니라 본문만 입력으로 넘어갔다는 관찰은, 트리거가 어떤 필드를 실제로 전달하는지 확인하지 않으면 프롬프트가 조용히 반쪽짜리가 될 수 있음을 보여 준다.
• 도구가 붙지 않은 에이전트는 모델의 학습 지식 안에서만 답한다. 최신 정보를 다뤄야 한다면 검색 도구를, 답장을 보내야 한다면 메일 발송 도구를 별도로 연결해야 한다.

자주 묻는 질문

관련 AI 소식