SlackProvider
SlackProvider 是將 Agent 連接至 Slack 的受管理方式。在 Mastra.channels 上註冊後，它會透過 Manifest API 佈建 Slack app、執行 OAuth 安裝流程、輪替設定 token，並將 Slack 事件路由至 Agent。若要由 Mastra 負責建立與安裝 app，請使用此方式。若要採用較低階的方式，自行建立 Slack app 並設定 scope 與 webhook，請在 Agent 的 channels.adapters 上使用 createSlackAdapter。
使用範例「使用範例」的直接連結
在 Mastra 建構函式上註冊 Provider。refresh token 只能使用一次，並會在啟動時輪替。產生的 access token 會持續儲存至 Mastra.storage。
import { Mastra } from '@mastra/core/mastra'
import { SlackProvider } from '@mastra/slack'
export const mastra = new Mastra({
storage,
channels: {
slack: new SlackProvider({
refreshToken: process.env.SLACK_APP_CONFIG_REFRESH_TOKEN,
baseUrl: process.env.MASTRA_BASE_URL,
}),
},
})
若建構時無法取得認證（例如透過 Editor UI 輸入，或從 vault 載入），可在建構 Provider 時省略認證，稍後再呼叫 configure()：
const slack = new SlackProvider()
await slack.configure({
refreshToken: process.env.SLACK_APP_CONFIG_REFRESH_TOKEN,
})
建構函式參數「建構函式參數」的直接連結
SlackProviderConfig 結合 Slack 專屬欄位、Slack adapter 覆寫（toolDisplay、streaming、typingStatus），以及會轉送給每個已連接 Agent 的精選 ChannelConfig 選項子集（例如 handlers、inlineMedia 與 state）。所有欄位皆為選填。
refreshToken?:
configure() 提供。省略時，Provider 會以未設定狀態啟動，必須呼叫 configure() 或從 storage 載入 token 後才能建立 app。請在 api.slack.com/apps 的 "Your App Configuration Tokens" 下產生此 token。token?:
refreshToken 輪替成新的 token。baseUrl?:
connect() 建立 app 時必須提供。也可以透過 setBaseUrl() 設定，或從 Mastra 伺服器設定自動偵測。本機開發請使用 cloudflared 等 tunnel。encryptionKey?:
MASTRA_ENCRYPTION_KEY 環境變數設定。省略時，secret 會以純文字儲存（不建議在正式環境使用）。storage?:
ChannelsStorage。如果沒有可用的持久性 storage，則擲回錯誤。redirectPath?:
onInstall?:
streaming?:
{ updateIntervalMs } 可自訂張貼及編輯間隔；傳入 false 則會將文字緩衝至 step-finish。停用串流會將 toolDisplay 限制為靜態模式。textFormat?:
'markdown'（預設值）會以 markdown 張貼回覆，讓 Slack 原生呈現粗體、連結與表格。'plain' 會張貼純文字，供提示 Agent 輸出 Slack mrkdwn 時使用。適用於緩衝回覆（streaming: false）與串流 fallback；原生串流一律使用 markdown。toolDisplay?:
'cards'、'text'、'timeline'、'grouped'、'hidden' 或函式。'hidden' 會完全隱藏 Tool 呼叫與結果。'timeline' 與 'grouped' 需要串流。設定 streaming: false 時只能使用靜態模式，預設為 'cards'。typingStatus?:
false 可停用；也可以傳入函式，針對每個 stream chunk 傳回自訂狀態文字（傳回 undefined 時，該 chunk 會使用預設值）。waitUntil?:
waitUntil。若使用 Hono 無法橋接平台 ExecutionContext 的 serverless 執行階段（Vercel、AWS Lambda），則必須提供。缺少此值時，叫用會在 200 ack 後凍結，導致執行作業中途終止。請從平台 SDK（例如 @vercel/functions）傳入未包裝的 waitUntil(promise)。Cloudflare Workers 與 Netlify 使用者通常不需要此選項。resolveWaitUntil?:
waitUntil，但 core 預設行為未涵蓋，則從要求的 Hono Context 解析此值。解析順序：waitUntil → resolveWaitUntil → core 預設值。handlers?:
onDirectMessage、onMention）。會轉送至透過此 Provider 連接之每個 Agent 的 AgentChannels。inlineMedia?:
inlineLinks?:
threadContext?:
tools?:
AgentChannels.getTools() 公開 channel Tool（add_reaction、remove_reaction）。這些 Tool 絕不會自動加入 Agent；若要使用，請透過 tools: { ...channels.getTools() } 明確傳入。state?:
MastraStateAdapter，因此 subscription 可在重新啟動後持續保留。chatOptions?:
logger?:
SlackAdapter 的 logger。預設為 adapter 的 ConsoleLogger。方法「方法」的直接連結
Agent connection「Agent connection」的直接連結
connect(agentId, options?)「connectagentid-options」的直接連結
透過 Manifest API 為 Agent 建立新的 Slack app，並傳回包含授權 URL 的 OAuth 結果，供使用者重新導向。必須設定 baseUrl。如果 Agent 已有待處理的 installation，則傳回現有授權 URL，而不建立重複的 app。
const result = await slack.connect('support-agent', {
name: 'Support Bot',
})
// Redirect the user to result.authorizationUrl to install the app
傳回：Promise<ChannelConnectResult>
interface ChannelConnectResult {
type: 'oauth'
installationId: string
authorizationUrl: string
}
SlackConnectOptions 可序列化，並可為已儲存的 Agent 加以儲存：
name?:
description?:
iconUrl?:
manifest?:
redirectUrl?:
redirectPath 或 /。disconnect(agentId)「disconnectagentid」的直接連結
刪除 Agent 的 app，並從 storage 移除 installation，以中斷 Agent 與 Slack 的連線。
await slack.disconnect('support-agent')
傳回：Promise<void>
getInstallation(agentId)「getinstallationagentid」的直接連結
傳回 Agent 的 Slack installation；若不存在則傳回 null。
const installation = await slack.getInstallation('support-agent')
傳回：Promise<SlackInstallation | null>
listInstallations()「listinstallations」的直接連結
列出所有 Slack installation（僅限公開資訊），包括作用中與待處理的項目。
const installations = await slack.listInstallations()
傳回：Promise<ChannelInstallationInfo[]>
設定「設定」的直接連結
configure(credentials)「configurecredentials」的直接連結
在執行階段提供或清除 Slack App Configuration 認證。若建構時無法取得認證，請使用此方法。傳入 null 可清除認證並刪除已儲存的 token。
// Provide credentials (persists to storage immediately)
await slack.configure({ refreshToken: 'xoxe-1-...' })
// Clear credentials and stored tokens
await slack.configure(null)
傳回：Promise<void>
setBaseUrl(baseUrl)「setbaseurlbaseurl」的直接連結
設定 webhook 與 OAuth callback 使用的公開基底 URL。若建構時無法得知 URL，且無法從伺服器設定自動偵測，請使用此方法。
slack.setBaseUrl('https://abc123.trycloudflare.com')
initialize()「initialize」的直接連結
為 storage 中每個作用中的 installation 重新建立 SlackAdapter，並將 AgentChannels 注入對應 Agent，使其在啟動時接收 Slack 事件。不會自動佈建新的 app；請使用 connect() 建立。Mastra 會自動呼叫此方法，因此幾乎不必直接呼叫。
await slack.initialize()
傳回：Promise<void>
預設 manifest「預設 manifest」的直接連結
connect() 建立 Slack app 時，產生的 manifest 會要求一組預設 bot scope 與 event subscription。可透過 connect() 的 manifest 選項覆寫。
| 預設 bot scope | 預設 bot 事件 |
|---|---|
chat:write | app_mention |
chat:write.public | message.channels |
im:write | message.groups |
channels:history | message.im |
channels:read | message.mpim |
groups:history | |
groups:read | |
im:history | |
im:read | |
mpim:history | |
mpim:read | |
app_mentions:read | |
users:read | |
reactions:write | |
files:read | |
assistant:write |
存取 Provider「存取 Provider」的直接連結
透過有型別的 channels getter 存取已註冊的 Provider，並以註冊時使用的 ID 作為 key：
const result = await mastra.channels.slack.connect('support-agent')
若只在執行階段才知道 key，請用字串 ID 查找並傳入具體型別：
const slack = mastra.getChannelProvider<SlackProvider>('slack')
const result = await slack.connect('support-agent')
Storage 需求「Storage 需求」的直接連結
SlackProvider 需要 Mastra 上的持久性 storage，以加密並持續儲存 installation 與輪替的設定 token。如果沒有可用的持久性 storage，也未傳入自訂 storage，建構函式會擲回錯誤。
相關內容「相關內容」的直接連結
- ChannelProvider：
SlackProvider實作的介面 - Channels：概念、平台設定與
createSlackAdapter路徑 - Channels 參考文件：
Agent建構函式上的channels設定