用途:当需要编写调用 Gemini API 的代码,用于文本生成、多轮聊天、多模态理解、图像/视频生成、流式响应、后台研究任务、函数调用或结构化输出,或从旧版 generateContent 迁移时,可使用本技能。
主要能力:当前模型包括 gemini-3.5-flash、gemini-3.1-pro-preview、gemini-3.1-flash-lite,以及图像模型 gemini-3-pro-image 等;托管智能体有 antigravity-preview-05-2026(通用型,含代码执行、文件管理与网页访问)和 deep-research-preview-04-2026、deep-research-max-preview-04-2026(深度研究,需 background=True)。支持状态化对话(previous_interaction_id)、流式(stream=True)与自定义智能体(client.agents.create)。
SDK:Python 用 google-genai >= 2.3.0,安装 pip install -U google-genai;JS/TS 用 @google/genai >= 2.3.0,安装 npm install @google/genai。旧版 google-generativeai 与 @google/generative-ai 已弃用。
使用方式:交互默认存储(store=true),付费层保留 55 天、免费层 1 天;设 store=false 会禁用 previous_interaction_id 和 background。tools、system_instruction、generation_config 按交互作用域,每轮需重新指定。托管智能体需 environment="remote"。写代码前应先抓取对应官方文档页面,示例仅为最小用法。
限制:gemini-2.5-、gemini-2.0-、gemini-1.5-* 已弃用不应使用;命令、行为、价格、配额与凭据需以官方最新文档核实,不要将示例替代环境测试、安全审查或用户授权。