본문으로 건너뛰기

Slack 어시스턴트 구축

이 가이드에서는 Slack의 메시지 및 멘션에 응답하는 Mastra Agent를 구축합니다. 채널 어댑터를 구성하고, 올바른 권한으로 Slack 앱을 설정하고, 웹후크를 통해 Agent에 연결하고, 상호 작용을 테스트하는 방법을 배우게 됩니다.

전제조건
전제조건에 대한 직접 링크

Agent 만들기
Agent 만들기에 대한 직접 링크

Slack 어댑터를 설치합니다.

npm install @chat-adapter/slack

새 파일 만들기src/mastra/agents/slack-agent.ts and define your agent:

src/mastra/agents/slack-agent.ts
import { Agent } from '@mastra/core/agent'
import { createSlackAdapter } from '@chat-adapter/slack'

export const slackAgent = new Agent({
  id: 'slack-agent',
  name: 'Slack Agent',
  instructions:
    'You are a helpful assistant. Answer questions, help with tasks, and have natural conversations.',
  model: 'anthropic/claude-opus-4-7',
  channels: {
    adapters: {
      slack: createSlackAdapter(),
    },
  },
})

그만큼channels 속성은 Mastra가 각 adapter의 webhook endpoint를 생성하도록 합니다. 이 경우 Slack adapter가 이벤트 확인, 서명 검증 및 메시지 형식 지정을 자동으로 처리합니다.

귀하의 대리인을 등록하십시오.src/mastra/index.ts file:

src/mastra/index.ts
import { Mastra } from '@mastra/core'
import { slackAgent } from './agents/slack-agent'

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

Slack 앱 만들기
Slack 앱 만들기에 대한 직접 링크

Agent를 작업 공간에 연결하려면 Slack 앱이 필요합니다.

이동https://api.slack.com/apps and select Create New App > From scratch. Give it a name and select your workspace.

다음으로 이동OAuth & Permissions and scroll to Bot Token Scopes. Add the following scopes:

  • app_mentions:read
  • channels:history
  • channels:read
  • chat:write
  • users:read

상단에는OAuth & Permissions, select Install to Workspace. Copy the Bot User OAuth Token (xoxb-...).

이동Basic Information > App Credentials and copy the Signing Secret (e.g. c3a4...).

보장하다Socket Mode is turned off under Settings > Socket Mode.

자격 증명을.env file:

.env
SLACK_SIGNING_SECRET=your-signing-secret
SLACK_BOT_TOKEN=xoxb-your-bot-token

어댑터는 기본적으로 이러한 환경 변수를 읽습니다. 참조Chat SDK Slack adapter docs for more details.

웹훅 연결
웹훅 연결에 대한 직접 링크

Slack은 웹훅을 통해 Agent에 이벤트를 전달합니다. Mastra는 각 채널 어댑터에 대해 이 끝점을 자동으로 생성합니다.

개발 서버를 시작합니다:

npm run dev

로컬 개발 중에 Slack이 로컬 서버에 연결하려면 공개 URL이 필요합니다. 새 터미널을 열고 터널을 시작합니다.

npx cloudflared tunnel --url http://localhost:4111

그러면 다음과 같은 임시 공개 URL이 출력됩니다.https://triple-arms-solutions-kit.trycloudflare.com. 터널을 다시 시작할 때마다 URL이 변경됩니다.

Slack 앱 설정에서 다음으로 이동하세요.Event Subscriptions and toggle Enable Events to On.

설정Request URL 을 Agent webhook 경로가 포함된 터널 URL로 설정합니다:

https://<your-tunnel-url>/api/agents/slack-agent/channels/slack/webhook

Slack이 확인 요청을 보냅니다. 개발 서버가 실행 중인 경우 녹색 확인 표시로 응답합니다.

아래에Subscribe to bot events, add:

  • app_mention
  • message.channels

선택하다Save Changes. Slack에서는 이벤트 구독을 변경한 후 앱을 다시 설치해야 합니다. OAuth & Permissions and select Reinstall to Workspace to apply the updated permissions.

노트

터널 URL은 로컬 개발 전용입니다. 당신이deploy your application, update the Request URL in your Slack app's Event Subscriptions to your production URL (e.g. https://your-app.example.com/api/agents/slack-agent/channels/slack/webhook).

Agent 테스트
Agent 테스트에 대한 직접 링크

Slack으로 테스트하기 전에 다음에서 Agent의 동작을 개선할 수 있습니다.Studio. Open http://localhost:4111/ 에서 Agent와 채팅하고 지침을 조정합니다. 응답이 어떻게 생성되는지 확인하려면 Trace를 살펴보세요.

Agent의 응답이 만족스러우면 Slack 통합을 테스트하세요. Slack의 채널에 봇을 초대합니다.

/invite @your-bot-name

채널에서 봇을 언급하세요.

@your-bot-name What can you help me with?

Agent는 스레드에서 응답합니다. 출력은 Model 및 지침에 따라 다를 수 있습니다.

다음 단계
다음 단계에 대한 직접 링크

이 Agent를 다음으로 확장할 수 있습니다.

  • 애플리케이션 배포Slack을 업데이트하고Request URL to your production endpoint
  • 여러 플랫폼에서 응답할 수 있도록 동일한 Agent에 더 많은 어댑터(Discord, Telegram)를 추가하세요.
  • 구성multimodal content 을 사용해 Agent가 채팅에서 공유된 이미지, 동영상 및 오디오를 처리할 수 있도록 합니다
  • 추가하다tools 을 사용해 Agent가 외부 API와 데이터에 접근할 수 있도록 합니다

자세히 알아보기:

On this page