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

# 版本與紀錄

> 發布版本、回溯、查看 Agent 狀態，並在 AI 代理人日誌中檢視每一次執行與對話

每次發布都會產生一個可回溯的版本，每次執行都會連同完整對話記錄一起保存。本頁說明這兩者。

***

## 版本

在 [Agent Builder](/zh/agents/build) 中建立的 Agent 都有版本。每次「發布」都會產生下一個版本（`v1`、`v2`…），其中包含：

* 當下的 Agent 檔案
* 它的設定：工具、連線保險庫、模型、已連結的知識庫與分析分析資料
* 你填寫的「版本說明（選填）」（若有）

開啟 Builder 的「版本」分頁即可查看。Agent 目前提供服務的版本會標示「上線中」。

### 回溯

在任一版本上點選「回復到此版本」並確認。Agent 的檔案與記錄的設定會回到該版本，變更會立即對所有人生效。

有些設定不一定能還原。DataGen 會回溯其他所有內容，並告訴你略過了哪些，例如：

* 工具套件、沙箱環境、Harness 或某個已連結的知識庫已被刪除
* 工具套件現在屬於另一個連線保險庫
* 你已不再擁有該版本所連結之知識庫的編輯權限
* 某個已連結的分析分析資料已不再處於發布狀態
* 該版本使用「整個工作區」開放範圍；已改為「僅限已連結」的 Agent 無法改回

### 刪除版本

點選「刪除此版本」可移除不再需要的版本。刪除後無法復原。

<Note>
  從 GitHub 儲存庫連接的 Agent 以 Git 歷史作為版本：在儲存庫中推送或還原 commit，即可改變 Agent 執行的內容。
</Note>

***

## Agent 狀態

「AI 代理人」清單會顯示每個 Agent 的狀態：

| 狀態 | 意義 |
| - | - |
| **使用中** | 已啟用、設有自動化，且在過去 7 天內有執行 |
| **閒置** | 已啟用，過去 7 天內沒有活動 |
| **需要設定** | 已啟用，但還沒有任何自動化。它仍會在聊天與頻道上回應。 |
| **失敗中** | 過去 24 小時內有執行失敗 |
| **已停用** | 已關閉。重新啟用前不會在任何地方回應。 |

Agent 頁面會顯示「已啟用」或「已停用」按鈕，「總覽」分頁則列出「近期執行」。啟用與停用請參閱 [觸發方式](/zh/agents/triggers)。

***

## AI 代理人日誌

「AI 代理人日誌」（位於側邊欄的「更多」選單，可釘選到側邊欄）列出所有 Agent 的每一段對話與每一次執行。

| 分頁 | 顯示內容 |
| - | - |
| **對話** | 每段對話一列：標題、Agent、頻道、輪數與最後活動時間。可依頻道篩選。 |
| **執行** | 每次執行一列：Agent、觸發器、狀態、開始時間、持續時間與工作階段。可依狀態與觸發器篩選。 |

可依標題、提示詞、Agent、執行 ID 或工作階段搜尋。在「執行」分頁中，可選取執行中或排隊中的執行並一次停止。

### 執行狀態

| 狀態 | 意義 |
| - | - |
| **排隊中** / **待處理** | 等待開始 |
| **執行中** | Agent 正在工作 |
| **已完成** | 成功完成 |
| **失敗** | 以錯誤結束 |
| **已取消** | 在完成前被停止 |

### 觸發來源

每次執行都會記錄是什麼啟動了它，例如 **HTTP Webhook**、**Scheduled (Cron)**、**Manual Automation**、**Slack**、**Microsoft Teams**、**Discord**、**Email**、**Linear**、**Chat UI**、**Notebook chat**、**API key**、**Public Chat Link** 或 **Called by another agent**。若一段對話的執行來自多個來源，會顯示「混合」。

### 執行詳細資訊

點選一次執行即可開啟「執行詳細資訊」：

* 「執行狀態」、「開始時間」、「持續時間」，以及這次執行使用的「模型」與其來源（來自 API 呼叫、來自自動化、來自執行框架、代理預設值或系統預設值）
* 舊版儲存庫執行自動化開啟 PR 時的「拉取請求」連結，以及失敗執行的「錯誤」
* 「對話記錄」：依序列出每個事件——使用者訊息、推理、Agent 回覆、工具呼叫與工具結果。使用「顯示：」篩選事件類型，點選事件可查看完整內容。
* 摘要標籤：「牆鐘」（端到端時間，含沙盒啟動）、「API」（僅模型時間）、「TTFT」（首個 token 的時間）、「權杖」、「快取」命中率與「費用」
* 「執行環境快照」：模型與提示詞、載入的 Agent 與指令檔案、Harness 設定、時間瀑布圖、用量，以及上下文是否經過壓縮
* 「應用程式記錄」：沙盒生命週期事件，例如啟動、載入檔案與錯誤

點選「停止執行」可停止執行中的工作；其工作階段會保留。執行中的工作會在新事件產生時即時串流顯示。

### 對話詳細資訊

開啟一段對話即可看到「工作階段詳細資訊」：該工作階段中的每次執行、總持續時間與時間範圍，以及跨多輪的完整「對話記錄」。

<Tip>
  在排查工具問題？開啟該次執行的「對話記錄」，找到工具呼叫，比對它的輸入與工具結果。「執行環境快照」會顯示該次執行可用的 MCP 伺服器與工具數量。
</Tip>

你也可以從終端機讀取執行紀錄與輸出。請參閱 [CLI](/zh/developers/cli)。

## 下一步

<CardGroup cols={2}>
  <Card title="範本" icon="copy" href="/zh/agents/templates">
    從預先建好的 Agent 開始
  </Card>

  <Card title="應用（App）" icon="table-columns" href="/zh/apps/overview">
    在相同的資料與知識庫上建立筆記本與自訂 App
  </Card>
</CardGroup>


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