Microsoft Teams SDK, 기존 AI 에이전트용 HTTP 서버 어댑터 추가

Microsoft Teams SDK는 이제 개발자가 핵심 코드를 수정하지 않고도 기존 AI 에이전트를 Microsoft Teams에 연결할 수 있도록 HTTP 서버 어댑터를 제공합니다. 이 접근 방식은 Slack이나 LangChain과 같은 다른 플랫폼용으로 구축된 에이전트가 최소한의 변경으로 Teams에서 실행될 수 있게 합니다.

패턴

핵심 패턴은 Teams TypeScript SDK를 사용하는 세 단계로 구성됩니다:

import { App as TeamsApp, ExpressAdapter } from '@microsoft/teams.apps';

const adapter = new ExpressAdapter(expressApp); // 1. 서버 래핑
const teamsApp = new TeamsApp({ httpServerAdapter: adapter }); // 2. 앱 생성
teamsApp.on('message', async ({ send, activity }) => {
    // 3. 메시지 처리
    await send(/* 에이전트 응답 */);
});
await teamsApp.initialize(); // 서버에 POST /api/messages 등록

SDK는 기존 Express 앱에 POST /api/messages 경로를 주입합니다. 이는 Teams가 봇에 메시지를 전달하는 데 사용하는 엔드포인트입니다. 서버는 다른 부분은 변경되지 않으며, SDK는 해당 엔드포인트 하나만 추가합니다.

시나리오 1: Slack 봇 통합

Bolt로 구축된 Slack 봇이 있는 경우 동일한 Express 서버에서 Slack과 Teams 봇을 모두 실행할 수 있습니다. Teams SDK는 /api/messages에 마운트되고 Slack은 /slack/events를 사용하므로, 두 핸들러가 호출하는 일반 함수에 공유 에이전트 로직(LLM 호출, 데이터베이스 조회, 비즈니스 규칙)이 위치할 수 있습니다.

시나리오 2: LangChain 통합

기존 LangChain 체인의 경우 체인을 가져와 Teams에 연결하는 브리지 파일을 생성할 수 있습니다. Teams 메시지 핸들러는 LangChain 체인을 호출하고 Teams 사용자에게 응답을 반환할 수 있습니다.

SDK는 들어오는 요청이 Teams에서 온 것인지 확인하여 핸들러를 호출하기 전에 검증하고, 메시지를 올바른 이벤트 핸들러로 자동 라우팅합니다.