> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ko/llms.txt

# 마이크로소프트 팀즈

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

## 어댑터 설치

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

**npm**:

```bash
npm install @chat-adapter/teams
```

**pnpm**:

```bash
pnpm add @chat-adapter/teams
```

**Yarn**:

```bash
yarn add @chat-adapter/teams
```

**Bun**:

```bash
bun add @chat-adapter/teams
```

## Agent 구성

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

```typescript
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를 등록합니다.

```typescript
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 어댑터 문서](https://chat-sdk.dev/adapters/official/teams)를 따르세요. 어댑터는 다음과 같은 환경 변수에서 Teams 자격 증명을 읽습니다.

```bash
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 웹후크 경로를 생성합니다.

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

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

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

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

## 관련된

- [채널 개요](https://mastra.zisheng.pro/ko/docs/capabilities/channels/overview)
- [더](https://mastra.zisheng.pro/ko/docs/capabilities/channels/other-adapters)