工具

使用自訂工具和整合來擴展你的代理。

工具讓你的代理能與外部系統互動、取得資料和執行動作。LensOS 提供標準化框架用於定義、註冊和管理工具。

內建工具

LensOS 包含多個預建工具，可以立即啟用：

網頁搜尋 — 搜尋網路並回傳相關結果。
計算機 — 執行數學計算。
程式碼直譯器 — 在沙箱環境中執行程式碼片段。
檔案讀取器 — 讀取和解析上傳的文件。

自訂工具

定義自訂工具將你的代理連接到任何 API 或服務：

tool-definition.ts

await lens.tools.create({
  name: 'get-weather',
  description: '取得某地點的當前天氣',
  parameters: {
    type: 'object',
    properties: {
      location: {
        type: 'string',
        description: '城市名稱或座標',
      },
    },
    required: ['location'],
  },
  handler: async ({ location }) => {
    const data = await fetchWeather(location)
    return { temperature: data.temp, condition: data.condition }
  },
})

工具設定

身份驗證

工具可以設定驗證憑證來存取受保護的 API：

API 金鑰驗證
OAuth 2.0 流程
自訂 Header 驗證

權限

控制哪些代理可以存取哪些工具。你可以在代理層級指派工具或設定組織預設值。

Note

工具在伺服器端安全環境中執行。除非明確傳遞，否則用戶資料不會暴露給工具處理器。