마이크로소프트 팀즈

Microsoft Teams 채널을 통해 Mastra Agent은 Teams로부터 멘션 및 대화 이벤트를 받을 수 있습니다. Mastra는 Agent 연결 및 웹훅 경로를 처리합니다. Chat SDK Teams 어댑터 문서에서는 Teams 앱 설정, 인증 및 권한을 다룹니다.

어댑터 설치

Chat SDK에서 Teams 어댑터를 설치합니다.

npm

npm install @chat-adapter/teams

pnpm

pnpm add @chat-adapter/teams

Yarn

yarn add @chat-adapter/teams

Bun

bun add @chat-adapter/teams

Agent 구성

Agent의 channels.adapters 객체에 createTeamsAdapter()를 추가하세요.

src/mastra/agents/teams-agent.ts

import { Agent } from '@mastra/core/agent'
import { createTeamsAdapter } from '@chat-adapter/teams'

export const teamsAgent = new Agent({
  id: 'teams-agent',
  name: 'Teams Agent',
  instructions: 'Answer questions and help with tasks in Microsoft Teams.',
  model: 'openai/gpt-5.6-sol',
  channels: {
    adapters: {
      teams: createTeamsAdapter({
        appType: 'SingleTenant',
      }),
    },
  },
})

Mastra 인스턴스에 Agent를 등록합니다.

src/mastra/index.ts

import { Mastra } from '@mastra/core'
import { teamsAgent } from './agents/teams-agent'

export const mastra = new Mastra({
  agents: { teamsAgent },
})

어댑터 설정

Azure 봇 등록, Teams CLI 사용법, 인증 옵션, 필수 권한을 포함한 Teams 전용 설정은 Chat SDK Teams 어댑터 문서를 따르세요. 어댑터는 다음과 같은 환경 변수에서 Teams 자격 증명을 읽습니다.

.env

TEAMS_APP_ID=your-azure-bot-app-id
TEAMS_APP_PASSWORD=your-azure-bot-app-password
TEAMS_APP_TENANT_ID=your-azure-tenant-id

웹훅 URL

Mastra는 Agent ID 및 어댑터 키에서 Teams 웹후크 경로를 생성합니다.

/api/agents/teams-agent/channels/teams/webhook

공개 Mastra 서버 URL을 기본 URL로 사용하십시오.

https://your-app.example.com/api/agents/teams-agent/channels/teams/webhook

Teams 어댑터 문서에서 봇 엔드포인트 또는 웹후크 URL을 요청하는 모든 위치에서 이 URL을 사용하세요. 로컬 개발의 경우 터널을 통해 Mastra 개발 서버를 노출하고 터널 URL을 기본 URL로 사용합니다.

관련된

• 채널 개요
• 더