跳至主要内容

代理工具介紹

概述​

代理工具提供了一套全面的功能，可以與檔案互動、執行命令、搜尋內容，以及執行與網路相關的任務。這些工具旨在幫助您高效地完成各種計算和資訊收集任務。

可用工具​

1. 網路和 URL 工具​

webSearch​

  • 用途：從網路獲取最新資訊
  • 主要參數：
    • query：搜尋查詢（必填）
    • maxCharsPerPage：每頁字元限制（選填，預設值：6000）
    • numResults：搜尋結果數量（選填，預設值：4）

urlFetcher​

  • 用途：從特定 URL 提取內容
  • 主要參數：
    • url：要提取內容的 URL（必填）
    • maxCharsPerPage：提取的字元限制（選填，預設值：6000）

2. 檔案管理工具​

readFile​

  • 用途：讀取檔案內容
  • 主要參數：
    • relativeFilePath：要讀取的檔案路徑（必填）
  • 特殊功能：
    • 自動從 PDF 和 DOCX 檔案中提取文字
    • 將原始內容作為字串返回

writeToFile​

  • 用途：將內容寫入檔案
  • 主要參數：
    • relativePath：檔案將寫入的路徑（必填）
    • content：要寫入的完整內容（必填）
  • 特殊功能：
    • 如果目錄不存在，則建立目錄
    • 覆蓋現有檔案

searchFiles​

  • 用途：跨多個檔案執行正則表達式搜尋
  • 主要參數：
    • relativePath：要搜尋的目錄（必填）
    • regex：正則表達式模式（必填）
    • filePattern：可選的檔案類型篩選器（例如：'*.ts'）

listFiles​

  • 用途：列出指定路徑中的檔案和目錄
  • 主要參數：
    • relativePath：要列出內容的路徑（必填）
    • recursive：是否遞迴列出檔案（選填）

3. 程式碼和開發工具​

listCodeDefinitionNames​

  • 用途：列出目錄中的頂層程式碼定義
  • 主要參數：
    • relativePath：要分析的目錄（必填）
  • 見解：
    • 顯示頂層的類別、函數和方法
    • 幫助理解程式碼結構和架構

4. 系統和命令工具​

executeCommand​

  • 用途：在系統上執行 CLI 命令
  • 主要參數：
    • command：要執行的 CLI 命令（必填）
    • relativePath：執行命令的可選目錄
    • timeoutDuration：命令執行逾時時間（預設值：10 秒）

5. 網路互動工具​

inspectSite​

  • 用途：擷取網站的初始狀態
  • 主要參數：
    • url：要檢查的網站 URL（必填）
  • 功能：
    • 截取完整頁面螢幕截圖
    • 擷取初始主控台日誌
    • 在初始載入後不與頁面互動

6. 互動工具​

askFollowUpQuestion​

  • 用途：從使用者收集額外資訊
  • 主要參數：
    • question：要詢問的特定問題（必填）
  • 使用情境：釐清模糊之處或要求更多細節

attemptCompletion​

  • 用途：呈現任務結果
  • 主要參數：
    • result：最終任務結果（必填）
    • command：用於演示結果的可選 CLI 命令

使用指南​

  1. 根據您的特定任務選擇適當的工具
  2. 仔細提供必要的參數
  3. 以循序漸進的邏輯方式使用工具
  4. 請注意檔案路徑和系統限制

最佳實踐​

  • 使用 relativePath 維持上下文
  • 在執行命令之前驗證輸入
  • 妥善處理潛在錯誤
  • 利用工具組合執行複雜任務

限制​

  • 有些工具具有字元或結果限制
  • 依賴網路的工具可能會有連線問題
  • 系統特定的命令可能無法在所有環境中運作

安全注意事項​

始終驗證命令和 URL，以防止意外操作或安全風險。