> ## Documentation Index
> Fetch the complete documentation index at: https://datagen.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 4. 建立 Agent

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

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

## 開始之前

* 你已完成 [3. 建立知識庫](/zh/tutorial/03-build-context)。
* 要發布訊息到 Slack，Agent 需要 Slack 工具：在 Agent 使用的連線保險庫中加入 Slack MCP 伺服器憑證。使用工作區預設值時，就是 **Default** 連線保險庫。新增方式請參考[連線保險庫](/zh/foundation/vault)與[工具](/zh/agents/tools)。

## 1. 建立 Agent

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

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

## 2. 連結模型與知識庫

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

<Steps>
  <Step title="連結知識庫">
    在「**知識庫**」下開啟「**選擇知識庫…**」，選取第 3 部分的知識庫，然後點選「**+**」。Agent 現在可以讀取它，它會以唯讀方式掛載在 Agent 的沙盒中。
  </Step>

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

  <Step title="儲存">
    點選「**儲存設定**」。連結會從 Agent 的下一個回合開始生效。
  </Step>
</Steps>

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

## 3. 撰寫 Agent 的指示

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

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

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

## 4. 測試

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

```text 範例問題 theme={null}
<一個由模型回答的問題>
<一個需要知識庫中定義或規則的問題>
```

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

## 5. 發布

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

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

## 6. 排程每週報告

<Steps>
  <Step title="開啟自動化">
    開啟 Agent 的詳細頁面——點選建構器左上角的「**代理**」——並前往「**自動化**」分頁。點選「**新增自動化**」。
  </Step>

  <Step title="描述工作內容">
    輸入「**名稱**」，例如 `每週報告`。在「**要做什麼？**」中描述報告內容與要發布到哪裡：

    ```text 要做什麼？ theme={null}
    依照你的指示撰寫本週報告，然後發布到 Slack 的
    #<頻道> 頻道。開頭先列出與上週相比變化最大的三個數字。
    ```
  </Step>

  <Step title="加入每週觸發條件">
    在「**觸發條件**」下點選「**新增觸發條件**」，選擇「**定時排程**」。把「**頻率**」設為「**每週**」，選擇「**星期**」與「**時間**」，並把「**時區**」設為團隊所在的時區。
  </Step>

  <Step title="儲存">
    點選「**建立**」。
  </Step>

  <Step title="立即試跑">
    不必等待排程，直接點選該自動化列上的「**立即執行**」。到 Slack 頻道確認報告。
  </Step>
</Steps>

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

## 你完成了什麼

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

進一步了解：[建立 Agent](/zh/agents/build)、[觸發方式](/zh/agents/triggers)、[頻道](/zh/agents/channels)與[版本與紀錄](/zh/agents/versions-and-logs)。

<CardGroup cols={2}>
  <Card title="上一步：建立知識庫" icon="arrow-left" href="/zh/tutorial/03-build-context">
    把文件變成有版本的知識庫。
  </Card>

  <Card title="下一步：發布 App" icon="arrow-right" href="/zh/tutorial/05-ship-an-app">
    建立 marimo 儀表板並分享給團隊。
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.