Skip to main content
Google AI 提供了多种不同的对话模型,包括强大的 Gemini 系列。有关最新模型、其功能、上下文窗口等信息,请访问 Google AI 文档。 这将帮助您开始使用 ChatGoogleGenerativeAI 对话模型。有关所有 ChatGoogleGenerativeAI 功能和配置的详细文档,请访问 API 参考。
此库将被弃用此库基于 Google 已弃用的库,将被 ChatGoogle 库取代。 新实现应使用 ChatGoogle 库,而现有实现应考虑迁移。

概述

集成细节

模型功能

请查看下表标题中的链接,了解如何使用特定功能。

设置

您可以通过 ChatGoogleGenerativeAI 类在 @langchain/google-genai 集成包中访问 Google 的 gemini 和 gemini-vision 模型,以及 LangChain 中的其他生成模型。
您还可以通过 LangChain 的 VertexAI 和 VertexAI-web 集成访问 Google 的 gemini 模型系列。请参阅 Gemini 企业智能体平台文档。

凭证

在此处获取 API 密钥:https://ai.google.dev/tutorials/setup 然后设置 GOOGLE_API_KEY 环境变量:
如果您想获得模型调用的自动跟踪,也可以通过取消注释以下内容来设置您的 LangSmith API 密钥:

安装

LangChain 的 ChatGoogleGenerativeAI 集成位于 @langchain/google-genai 包中:

实例化

现在我们可以实例化我们的模型对象并生成对话完成:

调用

安全设置

Gemini 模型具有默认的安全设置,可以覆盖。如果您从模型中收到大量“安全警告”,可以尝试调整模型的安全设置属性。例如,要关闭对危险内容的阻止,可以导入 @google/generative-ai 包中的枚举,然后按以下方式构建您的 LLM:

工具调用

使用 Google AI 的工具调用与使用其他模型的工具调用基本相同 但 schema 有一些限制,但有一些 schema 限制。 Google AI API 不允许工具 schema 包含具有未知属性的对象。例如,以下 Zod schema 会引发错误: const invalidSchema = z.object({ properties: z.record(z.unknown()) }); 和 const invalidSchema2 = z.record(z.unknown()); 相反,您应该明确定义对象字段的属性。以下是一个示例:

内置 Google 搜索检索

Google 还提供了一个内置的搜索工具,您可以使用它将内容生成与真实世界信息相结合。以下是如何使用它的示例:
响应还包括有关搜索结果的元数据:

代码执行

Google 生成式 AI 也支持代码执行。使用内置的 CodeExecutionTool,您可以让模型生成代码、执行代码,并在最终完成中使用结果:
您还可以将此生成内容作为对话历史回传给模型:

上下文缓存

上下文缓存允许您将某些内容一次性传递给模型,缓存输入 Token,然后在后续请求中引用缓存的 Token 以降低成本。您可以使用 GoogleAICacheManager 类创建一个 CachedContent 对象,然后使用 enableCachedContent() 方法将 CachedContent 对象传递给您的 ChatGoogleGenerativeAIModel。
注意
  • 上下文缓存的最低输入 Token 数为 32,768,最高值与给定模型的最高值相同。

Gemini 提示词常见问题解答

截至本文档编写时(2023/12/12),Gemini 对其接受的提示词的类型和结构有一些限制。具体来说:
  1. 当提供多模态(图像)输入时,您最多只能提供 1 条“人类”(用户)类型的消息。您不能传递多条消息(尽管单个人类消息可以包含多个内容条目)
  2. 系统消息不受原生支持,如果存在,将与第一条人类消息合并。
  3. 对于常规聊天对话,消息必须遵循人类/ai/人类/ai 交替模式。您不能连续提供 2 条 AI 或人类消息。
  4. 如果消息违反 LLM 的安全检查,可能会被阻止。在这种情况下,模型将返回空响应。

API 参考

有关所有 ChatGoogleGenerativeAI 功能和配置的详细文档,请访问 API 参考。
官方原文:src/oss/javascript/integrations/chat/google_generative_ai.mdx · 非官方翻译,译文由 AI 生成,以英文原文为准。
Last modified on November 3, 2026