@langchain/google 包支持 Gemini 的内置工具,这些工具提供了诸如网络搜索锚定、代码执行、URL 上下文检索等功能。这些工具作为 Gemini 原生对象,通过 bindTools() 或 tools 调用选项传递给 ChatGoogle。
您不能在同一请求中混合使用 Gemini 原生工具(Google Search、Code Execution 等)和标准 LangChain 工具(基于 Zod 的函数工具)。有关标准工具调用的用法,请参阅 ChatGoogle 页面。
googleSearch 工具利用实时 Google 搜索结果来锚定模型的响应。这对于有关当前事件或特定事实的问题非常有用。
您可以选择将搜索结果过滤到特定的时间范围:
googleSearchRetrieval 工具为保持向后兼容性而保留,但推荐使用 googleSearch。
更多信息,请参阅 Google 的 Google Search 锚定文档。

代码执行

codeExecution 工具允许 Gemini 生成并运行 Python 代码来解决复杂问题。模型编写代码、执行代码并返回结果。
响应在 contentBlocks 字段中包含生成的代码及其执行结果:
更多信息,请参阅 Google 的代码执行文档。

URL 上下文

urlContext 工具允许 Gemini 获取并使用 URL 中的内容来锚定其响应。
更多信息,请参阅 Google 的 URL 上下文文档。

Google Maps

googleMaps 工具利用来自 Google Maps 的地理空间上下文来锚定响应。这对于与地点相关的查询非常有用。
您可以启用小部件上下文令牌来渲染 Google Maps 小部件:
更多信息,请参阅 Google 的 Google Maps 锚定文档。

文件搜索

fileSearch 工具从文件搜索存储中执行语义检索。文件必须首先使用 Gemini File API 导入。
配置选项:
  • fileSearchStoreNames (必需) — 要进行检索的文件搜索存储的名称
  • metadataFilter (可选) — 应用于检索的元数据过滤器
  • topK (可选) — 要返回的语义检索块数量
更多信息,请参阅 Google 的文件搜索文档。

计算机使用

computerUse 工具使 Gemini 能够与浏览器环境交互。该模型可以查看屏幕截图并执行点击、输入和滚动等操作。
配置选项:
  • environment (必需) — 正在操作的环境(例如 "ENVIRONMENT_BROWSER")
  • excludedPredefinedFunctions (可选) — 要从操作空间中排除的预定义函数
更多信息,请参阅 Google 的计算机使用文档。

MCP 服务器

mcpServers 字段允许 Gemini 连接到远程 MCP(模型上下文协议)服务器。与其他原生工具不同,MCP 服务器在工具对象上被指定为数组。
更多信息,请参阅 Google 的 MCP 文档。

Vertex AI Search 数据存储

如果您正在使用 Vertex AI(platformType: "gcp"),则可以使用 Vertex AI Search 数据存储来锚定响应。
更多信息,请参阅 Google 的 Vertex AI Search 锚定文档。