본문으로 건너뛰기

불화

Discord 채널을 사용하면 Mastra Agent가 Discord 상호 작용 및 봇 메시지를 받을 수 있습니다. Mastra는 Agent 연결 및 웹훅 경로를 처리합니다. Chat SDK Discord 어댑터 문서에서는 Discord 애플리케이션 설정, 봇 권한 및 게이트웨이 동작을 다룹니다.

어댑터 설치
어댑터 설치에 대한 직접 링크

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

npm install @chat-adapter/discord

Agent 구성
Agent 구성에 대한 직접 링크

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

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

export const discordAgent = new Agent({
  id: 'discord-agent',
  name: 'Discord Agent',
  instructions: 'Answer questions and help with tasks in Discord.',
  model: 'openai/gpt-5.6-sol',
  channels: {
    adapters: {
      discord: createDiscordAdapter(),
    },
  },
})

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

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

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

어댑터 설정
어댑터 설정에 대한 직접 링크

애플리케이션 생성, 봇 토큰, 상호 작용 엔드포인트, 권한 및 Gateway 동작을 포함한 Discord 관련 설정은 Chat SDK Discord 어댑터 문서를 따르세요. 어댑터는 다음과 같은 환경 변수에서 Discord 자격 증명을 읽습니다.

.env
DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_PUBLIC_KEY=your-discord-application-public-key
DISCORD_APPLICATION_ID=your-discord-application-id

웹훅 URL
웹훅 URL에 대한 직접 링크

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

/api/agents/discord-agent/channels/discord/webhook

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

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

Discord 어댑터 문서에서 상호 작용 끝점 또는 웹훅 URL을 요청하는 곳이면 어디든 이 URL을 사용하세요. Discord의 일반 메시지 이벤트에는 생성된 웹훅 경로 외부에 게이트웨이 설정이 필요할 수 있습니다. 해당 경로에 대한 Chat SDK 어댑터 문서를 따르세요.

On this page