4. 建立 Agent

建立一個使用模型與知識庫、在聊天中回答問題，並每週把報告發到 Slack 的 Agent

現在要讓第 1 部分的分析模型與第 3 部分的知識庫開始工作。你會建立一個回答業務問題的 Agent，並為它加上每週自動把報告發到 Slack 頻道的自動化。

​

開始之前

• 你已完成 3. 建立知識庫。
• 要發布訊息到 Slack，Agent 需要 Slack 工具：在 Agent 使用的連線保險庫中加入 Slack MCP 伺服器憑證。使用工作區預設值時，就是 Default 連線保險庫。新增方式請參考連線保險庫與工具。

​

1. 建立 Agent

1. 在左側導覽列點選「AI 代理人」，再點選「建立新代理」。
2. 輸入「代理名稱」與「描述」。
3. 「執行環境」中的欄位——「保險庫」、「工具套件」、「預設模型」與「沙箱環境」——都維持預設值。
4. 點選「建立並開啟建構器」。

Agent Builder 會以三欄開啟：左側是「對話」、「設定」與「版本」，中間是建構器對話，右側是「沙箱檔案」。

​

2. 連結模型與知識庫

開啟左側的「設定」分頁。

1. 連結知識庫

   在「知識庫」下開啟「選擇知識庫…」，選取第 3 部分的知識庫，然後點選「+」。Agent 現在可以讀取它，它會以唯讀方式掛載在 Agent 的沙盒中。

2. 連結分析模型

   在「分析資料」下開啟「選擇分析資料…」，選取第 1 部分的模型，然後點選「連結分析資料」。只有已發布且實體化的模型可以連結。

3. 儲存

   點選「儲存設定」。連結會從 Agent 的下一個回合開始生效。

掛載的知識庫預設為唯讀。若要讓 Agent 寫回知識庫——也就是它對學到內容的記憶——請開啟知識庫的「代理」分頁，把「權限」設為「讀取與寫入」或「讀取與寫入（寫入前詢問）」。請參考使用知識庫與記憶。

​

3. 撰寫 Agent 的指示

在建構器對話中描述 Agent 要做什麼。建構器會在沙盒中撰寫 Agent 的指示與檔案；你可以在「沙箱檔案」中看到它們。

範例提示

這個 Agent 是 <團隊或業務> 的分析師。
- 涉及數字時，一律查詢已連結的分析模型，絕不估算。
- 涉及定義、政策與背景時，閱讀已連結的知識庫，
  並註明你使用的檔案。
- 先用幾句話回答，再用小表格列出數字。

它也會撰寫每週報告：<要涵蓋的指標、要做的比較，以及篇幅>。

​

4. 測試

點選頁首的「測試執行」。「測試執行」分頁會執行尚未發布的草稿，讓你在其他人看到 Agent 之前先確認回答。試試需要同時用到模型與知識庫的問題：

範例問題

<一個由模型回答的問題>
<一個需要知識庫中定義或規則的問題>

在建構器對話中持續調整指示，直到回答正確為止。點選「重新執行」再次測試。

​

5. 發布

點選頁首的「發布」。在「發布此代理」中填寫「版本說明（選填）」，然後點選「發布」。發布會儲存一個版本並部署 Agent：Agent 會被啟用，並出現在「聊天」中。

之後隨時都能向它提問：在導覽列點選「聊天」，用「選擇代理」選取這個 Agent，然後輸入問題。

​

6. 排程每週報告

1. 開啟自動化

   開啟 Agent 的詳細頁面——點選建構器左上角的「代理」——並前往「自動化」分頁。點選「新增自動化」。

2. 描述工作內容

   輸入「名稱」，例如 每週報告。在「要做什麼？」中描述報告內容與要發布到哪裡：

   要做什麼？

   依照你的指示撰寫本週報告，然後發布到 Slack 的
   #<頻道> 頻道。開頭先列出與上週相比變化最大的三個數字。
   
3. 加入每週觸發條件

   在「觸發條件」下點選「新增觸發條件」，選擇「定時排程」。把「頻率」設為「每週」，選擇「星期」與「時間」，並把「時區」設為團隊所在的時區。

4. 儲存

   點選「建立」。

5. 立即試跑

   不必等待排程，直接點選該自動化列上的「立即執行」。到 Slack 頻道確認報告。

因為提示要求這麼做，自動化會透過 Agent 連線保險庫中的 Slack 工具發布到 Slack。若想直接在 Slack 中與 Agent 對話——提及它並在討論串中得到回答——請在「頻道」分頁為它設定專屬的 Slack bot。請參考頻道。

​

你完成了什麼

• 一個已發布、能根據分析模型與知識庫回答問題的 Agent。
• 一個每週撰寫報告並發布到 Slack 的自動化。

進一步了解：建立 Agent、觸發方式、頻道與版本與紀錄。

上一步：建立知識庫

把文件變成有版本的知識庫。

下一步：發布 App

建立 marimo 儀表板並分享給團隊。