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
- USERREADME 的第一行寫什麼?
使用者的要求是對話的第 1 則訊息。
沒有工具請求,就停止迴圈
各家 API 用不同欄位表示停止原因,例如 Anthropic 的 stop_reason。下圖的簡化程式以 reply.tool_calls 是否為空,判斷是否結束。
工具失敗時,也要把錯誤訊息當成結果送回。模型讀到錯誤,才能換做法。
每一輪都送出完整的 messages。模型沒有記憶,只讀這次送來的內容。
workflow 與 agent 的差別
Anthropic 把固定步驟的流程稱為 workflow。agent 則由模型依工具結果決定下一步。
驗證也在迴圈裡
context 是一次請求送給模型的全部內容。Claude Code 的文件把工作分成收集 context、採取行動、驗證結果,三個階段共用同一個迴圈。
停止只代表模型認為做完了,任務是否完成仍要靠驗證判斷,見 怎樣才算完成。
來源
- Building effective AI agents Anthropic
- How tool use works Claude API docs
- How Claude Code works Claude Code docs
- How to Build an Agent Thorsten Ball
- 12-factor agents Dex Horthy