昨天先定下「Discord AI 公司」的專案方向與 MVP,今天開始處理 Discord 端的設定。
這篇會建立 Discord 應用程式、設定 Bot、取得 Token、開啟訊息權限,最後把 Bot 加入測試伺服器。完成後,Bot 會出現在成員列表中;目前顯示離線是正常的,因為 Python 程式還沒啟動。
開始前,需要準備一個 Discord 帳號,以及一個自己可以管理的測試伺服器。如果還沒有,可以先建立私人伺服器專門測試 Bot。
開啟 Discord Developer Portal,登入後進入「應用程式」頁面。

點擊「新增應用程式」,輸入名稱後確認建立。

名稱與頭像之後都能修改,不必在這一步決定最終版本。

現在建立的是 Discord 應用程式,接下來還要設定裡面的 Bot,才能把機器人帳號加入伺服器。
在左側選單點擊「機器人」。

Discord 通常已經替應用程式建立 Bot。這個頁面可以修改名稱、頭像、公開狀態、Token 和訊息相關權限。
在「機器人」頁面找到 Token 設定區域:
Token 的格式大致如下:
ABCD1234.xxxxx.xxxxxxxxx

[!CAUTION]
Bot Token 就像機器人的登入密碼。不要貼到 Discord、不要傳給其他人,也不要直接上傳到 GitHub。畫面中的「公開金鑰」不是 Bot Token。
如果 Token 不小心公開,請立即回到這個頁面按下「重設權杖」,讓舊 Token 失效。之後寫 Python 程式時,Token 會放在 .env,不會直接寫進程式碼。
在「機器人」頁面往下滑,找到「特權閘道意圖」,開啟:
訊息內容意圖(Message Content Intent)
這項設定讓 Bot 可以讀取一般文字訊息。例如,使用者在頻道中輸入:
!hello
Bot 才能取得訊息內容並處理指令。

在左側選單點擊「安裝」,找到「安裝環境」,確認已開啟「公會安裝」。

如果畫面同時顯示「使用者安裝」,可以先保留;這個專案主要使用「公會安裝」。
在「安裝連結」中選擇:
Discord 提供的連結(Discord Provided Link)
選擇後,下方會出現「預設安裝設定」。

在「伺服器安裝」的 Scope 中加入:
applications.commands
bot
先勾選最基本的權限:
後續要顯示較完整的 Agent 回答,也可以加入:

權限不是越多越好。現階段只開啟專案需要的項目,不授予管理員權限。
回到「安裝」頁面,複製安裝連結,再依序操作:

如果清單中找不到測試伺服器,先確認目前登入的帳號是否有該伺服器的「管理伺服器」權限。
回到 Discord 測試伺服器,在成員列表中應該可以看到:
AI Agent Company

Bot 目前顯示離線,代表帳號已加入伺服器,但還沒有 Python 程式連線。下一篇啟動程式後,它才會正式上線。
Bot 已經加入測試伺服器,但目前仍是離線狀態。下一步要用 Python 連上 Discord,讓它開始接收指令。Bot Token 會放進 .env,不會直接寫在程式碼裡。