載入中
載入中

在建構 AI 代理(agent)時,有一個常被忽略的關鍵概念:環境檢查。Claude 是盲目運作的——它需要能夠觀察並理解其行動的結果,才能有效地工作。

為什麼環境檢查很重要

想想 Claude 如何使用電腦使用(computer use)功能。每次 Claude 執行像是輸入文字或點擊按鈕這樣的動作時,它會立即收到一張截圖以了解發生了什麼事。這不僅僅是個「有也不錯」的功能——它是不可或缺的。

Claude 使用電腦工具輸入「Did you read @」,而回傳的截圖顯示頁面文字框中出現「Did you re」。

從 Claude 的角度來看,點擊按鈕可能會導航到新頁面、開啟選單,或觸發任何數量的變化。如果無法看到結果,Claude 就沒有辦法理解其動作是否成功,或環境的新狀態是什麼樣子。

先讀取再寫入

同樣的原則也適用於檔案操作。在 Claude 修改任何檔案之前,它需要了解目前的內容。這看似顯而易見,但這是您在建構代理時應該始終遵循的模式。

被要求新增一個「/items」路由後,Claude 先讀取 main.py 的 31 行程式碼,然後以新增 5 行定義 get_items 的方式更新它。

在上面的範例中,當被要求為 Python 檔案新增一個新路由時,Claude 首先讀取現有的程式碼以了解目前的結構。只有這樣,它才能在不破壞現有功能的情況下,安全地進行所要求的變更。

用於環境檢查的系統提示

您可以透過系統提示引導 Claude 檢查其環境。對於像影片生成這樣的複雜任務,這一點變得特別重要。

建立一支關於 Python 的影片並發佈到社群媒體的任務、像 bash 這樣的工具,以及一則傳送給 Claude 的系統提示。

考慮一個需要執行以下工作的影片建立代理:

  • 使用像 FFmpeg 這樣的工具生成影片內容
  • 驗證音訊對白是否正確放置
  • 檢查視覺元素是否如預期般出現

您可能會包含像這樣的系統提示指示:

  • 使用 bash 工具執行 whisper.cpp 並生成帶有時間戳記的字幕檔,以驗證對白放置位置
  • 使用 FFmpeg 以固定間隔從影片中擷取截圖,以便對輸出進行視覺檢查
  • 將生成的內容與原始需求進行比較

環境檢查的好處

當 Claude 能夠檢查其環境時,有幾件事會變得更好:

  • 更好的進度追蹤 - Claude 可以評估自己完成任務的進度
  • 錯誤處理 - 可以偵測並修正非預期的結果
  • 品質保證 - 可以在將任務視為完成之前驗證輸出
  • 適應性行為 - Claude 可以根據其觀察結果調整自己的做法

實務實作

在設計您自己的代理時,請務必問:「Claude 要如何知道這個動作是否成功?」無論您是在處理檔案、API 還是使用者介面,都請提供工具與指示,讓 Claude 能夠觀察其行動的結果。

這可能包括:

  • 在修改之前讀取檔案內容
  • 在使用者介面互動之後拍攝截圖
  • 檢查 API 回應是否包含預期的資料
  • 根據需求驗證生成的內容

環境檢查讓 Claude 從一個盲目執行指令的執行者,轉變為一個能夠真正理解並適應其工作環境的代理。