讓員工用得到

員工最不想做的事，就是為了問一句話多開一個網站。這一章把助理接進公司本來就在用的通訊軟體。

開始之前

• 你有一個已發布的 Agent（見第 7 章）。草稿狀態接不了外部管道。
• 你在 Discord／LINE／Slack 其中一個平台上有建立應用程式的權限。多半是公司該平台的管理員，如果不是你，這一步需要請對方協助。
• 手邊有一份員工名單（姓名與公司 Email），Excel 另存成 CSV 即可。

步驟 1 · 選一個管道

一個 Agent 可以同時開多個管道，但第一次上線建議只開一個。

管道	適合	注意
Slack	公司已經用 Slack 辦公	設定最單純，平台可以幫你產生設定檔
Discord	有內部社群或工程團隊	需要在開發者後台多開三個開關
LINE	需要讓所有人用手機隨時問	需要一組公開網址，設定前先跟導入窗口確認

以下三種都先在對方平台建立一個 bot，再回 Office Power 貼上取得的憑證。

平台內建完整的圖文教學：進 Agent 的「對話管道」分頁，每張卡片右上角都有「📖 設定教學」，裡面有逐步指示、外部連結和常見錯誤對照表。設定時請把那份教學開著，以下是重點摘要。

步驟 2 · 在對方平台建立 bot

Slack（推薦先試這個）

1. 先回 Office Power：Agent →「對話管道」分頁 → 打開「啟用 Slack」→ 按「產生 App Manifest」→ 選「Socket Mode（免公網）」→ 按「複製」。
2. 到 Slack 的應用程式後台 api.slack.com/apps → 「Create New App」→ 選「From a manifest」→ 選你的工作區 → 貼上剛才複製的內容 → 「Create」。
3. 在該 App 的「Basic Information」→「App-Level Tokens」→「Generate Token and Scopes」→ 名稱隨意，scope 選 connections:write → 產生一組 xapp- 開頭的 token，複製起來。
4. 到「OAuth & Permissions」→「Install to Workspace」→ 允許 → 複製「Bot User OAuth Token」（xoxb- 開頭）。

Socket Mode 不需要 Signing Secret、也不需要任何公開網址。

Discord

1. 到 discord.com/developers/applications →「New Application」→ 左側選單點「Bot」。
2. 按「Reset Token」複製 token。只會顯示一次，請立刻複製起來。
3. 同一頁往下找到「Privileged Gateway Intents」，三個開關全部打開：PRESENCE INTENT、SERVER MEMBERS INTENT、MESSAGE CONTENT INTENT，然後按「Save Changes」。 三個沒有全開會連線失敗；只開一部分則會連上但 bot 已讀不回。這是最常見的卡點。
4. 到「OAuth2 → URL Generator」：scope 勾 bot，權限勾 Send Messages 與 Read Message History，用產生的邀請網址把 bot 加進你的伺服器。

LINE

1. 到 LINE Developers Console → 建立 Provider → 建立一個「Messaging API」channel。
2. 在「Basic settings」頁籤複製「Channel secret」。
3. 在「Messaging API」頁籤，把「Channel access token (long-lived)」按「Issue」發出來並複製。
4. 同一頁的 Webhook 設定：要填的 Webhook URL 寫在 Office Power 的「📖 設定教學」裡，照著複製貼上，然後打開「Use webhook」，按「Verify」測試。
5. 把「自動回應訊息（Auto-reply messages）」關掉，否則 LINE 官方的罐頭訊息會跟 AI 助理的回覆一起冒出來。

LINE 需要一組對外可連的公開網址。如果「Verify」一直失敗，先跟導入窗口確認你們這套環境對外的網址是什麼。

步驟 3 · 回平台貼上憑證並發布

回到 Agent →「對話管道」分頁，打開對應的開關（「啟用 Slack」／「啟用 Discord」／「啟用 LINE」），把剛才拿到的憑證貼進欄位：

管道	要貼的欄位
Slack	「Bot Token（xoxb-）」、「App Token（xapp-）」（Socket Mode 用這兩把，「Signing Secret」留空）
Discord	「Bot Token」
LINE	「Channel Secret」、「Channel Access Token（長期）」

貼過的欄位之後會顯示「已設定（留空＝不變更）」——要換一把才需要重貼，平常存檔不用重填。

Discord 還有一個「Mention 方式（何時回覆）」要決定：

• 「mention — 一律需 @提及（最嚴格）」：頻道很熱鬧時選這個。
• 「involved — 主頻道需 @；自有討論串免」：一般情況的建議值。
• 「all — 回覆所有訊息（不需 @）」：只有專門開給 AI 的頻道才選這個。

想限制範圍的話，「允許的頻道 ID」與「允許的使用者 ID」可以填（逗號分隔），留空代表全部。

按最上面工具列的「儲存設定」，然後確認這個 Agent 是「已發布」狀態。綁定是在發布時建立的，草稿狀態下 bot 收得到訊息也不會回。

步驟 4 · 匯入員工名單

點左側「員工名錄」。這裡是身分的錨點——員工名單裡沒有的人，綁不上任何管道。

找到「CSV 匯入」區塊。格式在畫面上有提示，第一行是欄位名：

name,email,department,manager
王小明,ming@company.com,業務部
李小華,hua@company.com,研發部/平台組,ming@company.com

• name 與 email 必填。
• department 選填，支援「研發部/平台組」這種路徑寫法，會自動幫你建立組織樹，不用先去「組織架構」建。
• manager 選填，填主管的 email 或員工 id。

你可以把 CSV 內容直接貼進文字框，或把 .csv 檔案拖進虛線框，也可以按「選擇檔案」。

按「匯入」。結果會顯示「已匯入 N 筆」；有問題的行會列在「略過 N 行：」底下，逐行告訴你第幾行、為什麼略過。修好那幾行再匯一次即可，已匯入的不會重複。

底下的「員工列表」會列出姓名、Email、部門、主管、狀態、綁定。也可以用上方的「新增員工」一筆一筆加。

步驟 5 · 讓員工完成身分綁定

這一步是員工自己做的，你只要把說明轉給他們——員工篇的〈完成身分綁定〉那一章就是寫給他們看的版本，可以直接轉貼連結。

1. 員工在 Discord／LINE／Slack 上第一次跟這個 bot 說話（私訊它，或在頻道 @ 它）。
2. bot 會回：「初次見面，請告訴我你的公司 Email 完成身分驗證」。
3. 員工回覆自己的公司 Email。
4. bot 回：「驗證碼已寄到你的信箱，請回覆 6 位數字」。
5. 員工去信箱收一封主旨「Office Power 身分驗證碼」的信，把 6 位數字回覆給 bot。驗證碼 10 分鐘內有效。
6. 完成。之後這個帳號就直接對話，不會再被要求驗證。

Slack 有個方便的地方：如果員工的 Slack 帳號 email 跟員工名錄裡的一致，會自動綁定，不用走驗證碼流程。

員工離職時，到「員工名錄」找到那個人按「停用」——所有管道綁定即刻失效，不需要一個一個去解綁。需要時可以按「復職」還原。

怎麼知道成功了

1. 「員工名錄」的員工列表裡看得到剛匯入的人，狀態是「在職」。
2. 你自己在 Discord／LINE／Slack 上跟 bot 說一句話，它會要求你完成身分驗證。
3. 走完驗證流程後，那位員工在「員工名錄」的「綁定」欄位不再是「未綁定」。
4. 再問一個公司規定的問題，bot 回答的內容跟你在網頁「對話」問到的一致。
5. 回「稽核紀錄」，看得到「Agent 使用」事件。

常見問題

症狀	原因 / 解法
Discord 顯示連線失敗	「Privileged Gateway Intents」三個開關沒有全開，或 Bot Token 貼錯。
Discord bot 已讀不回	MESSAGE CONTENT INTENT 沒開。
Slack bot 已讀不回	App 沒有做「Install to Workspace」（Bot Token 無效），或 bot 還沒被邀請進那個頻道。
Slack 連線狀態一直在重試	App Token 沒貼，或它的 scope 不是 connections:write。
LINE 的「Verify」失敗	網址不是對外可連，或 Channel Secret 貼錯。網址請以「📖 設定教學」上的為準，不確定就問導入窗口。
LINE 回覆變成兩則，一則是罐頭訊息	「Messaging API」頁籤的「自動回應訊息」沒關掉。
bot 回「請先完成身分驗證」	這是正常流程，員工第一次使用要綁定。照步驟 5 走完即可。
bot 回「查無此 Email，請確認或聯絡管理員」	那個 Email 不在員工名錄裡，或該員工已被停用。到「員工名錄」補一筆或按「復職」。
員工說沒收到驗證碼	先看垃圾郵件。連續要太多次會被限流，訊息會提示「請稍候一分鐘後再試」或「已達上限」，等一下再試。
驗證碼過期了	有效期 10 分鐘。重新提供一次公司 Email 就會重寄。
bot 收得到訊息但完全沒反應	那個 Agent 還是「草稿」。管道綁定是在發布時建立的，先按「🚀 發布」。
改了管道設定但行為沒變	頁頭若出現「⚠ 已部署的 Runtime 仍在使用舊設定」，按「🔄 套用新設定並重啟」。
想換一把 token	直接把新的貼進欄位再存檔。欄位顯示「已設定（留空＝不變更）」時留空代表不動它。