Agent Loop 讓模型提出請求,由程式執行並送回結果

觀念 L1 619 字 2 分鐘 v2.0.0 更新 2026-11-16

harness 是模型外圍的程式。模型讀進內容、輸出內容,不能直接讀檔或下指令。

工具呼叫就是模型提出的請求,指定工具與參數。Agent Loop 由 harness 問模型、執行工具,再把結果加入對話,交給模型決定下一步。

誰做什麼

模型沒有狀態,對話存在 harness 的 messages。同一段 messages 可以交給另一個模型接著做。

下圖呈現模型、harness 與工具的分工。

harness 把對話與工具定義送給模型。

讀檔請求如何變成答案

下圖從使用者問「README 的第一行寫什麼?」開始。模型提出 read_file 請求,參數指向 README.md。

harness 執行讀檔,把結果加進對話,再將整段對話送給模型。模型回答第一行是 # Hello,不再要求工具,迴圈結束。

請求的格式見 工具呼叫的格式。

1 / 5
  1. USERREADME 的第一行寫什麼?

使用者的要求是對話的第 1 則訊息。

沒有工具請求,就停止迴圈

各家 API 用不同欄位表示停止原因,例如 Anthropic 的 stop_reason。下圖的簡化程式以 reply.tool_calls 是否為空,判斷是否結束。

工具失敗時,也要把錯誤訊息當成結果送回。模型讀到錯誤,才能換做法。

每一輪都送出完整的 messages。模型沒有記憶,只讀這次送來的內容。

workflow 與 agent 的差別

Anthropic 把固定步驟的流程稱為 workflow。agent 則由模型依工具結果決定下一步。

驗證也在迴圈裡

context 是一次請求送給模型的全部內容。Claude Code 的文件把工作分成收集 context、採取行動、驗證結果,三個階段共用同一個迴圈。

停止只代表模型認為做完了,任務是否完成仍要靠驗證判斷,見 怎樣才算完成。

來源

讀完之後

HarnessLLM迴圈工具context快取KV接手協定權限沙箱層注入子 agent實作評測