用途：在编写调用 Gemini API 的代码时作为集成指南，涵盖文本生成、多轮聊天、多模态理解、图像生成、视频生成、语音合成、嵌入，以及托管智能体和深度研究。
主要能力：列出当前模型，如 gemini-3.7-flash、gemini-3.5-flash-lite、gemini-3.1-pro-preview、gemini-3.5-transcribe、gemini-3-pro-image（Nano Banana Pro）、gemini-omni-1.1-flash、gemma-4 系列与 gemini-embedding-2 等；提供 Python 与 JavaScript/TypeScript 的 SDK（google-genai >= 2.3.0，npm install @google/genai）；支持交互式 create/get、状态化多轮对话（previous_interaction_id）、流式输出（stream=True）、函数调用、Google 搜索、代码执行、URL 上下文、文件搜索、MCP、图像/音频/视频内容类型，以及 Deep Research 与 Antigravity 等托管智能体和自定义智能体。
使用方式：先按任务拉取对应官方文档页再写代码；交互默认存储（store=true），付费层保留 55 天、免费层 1 天；tools、system_instruction、generation_config 每次调用需重新指定；托管智能体需 environment="remote"；深度研究等后台任务需 background=True 并轮询状态。
限制：gemini-2.5-、2.0-、1.5-* 等为旧版且已弃用，不应使用；旧版 SDK google-generativeai 与 @google/generative-ai 也已弃用；store=false 会禁用 previous_interaction_id 与 background=true。迁移与模型替换需参考迁移文档，且应在修改前与用户确认范围。