gemini-interactions-apiGoogle官方放心用让 AI 带你用新版 SDK 调用 GEAP 的 Gemini 交互 API,实现多轮对话与后台任务。
这个 Skill 是一份面向 Gemini Enterprise Agent Platform(GEAP)的 Gemini Interactions API 实战指南。它会告诉你怎么用 ADC 鉴权、启用 aiplatform API,然后用 google-genai SDK(≥2.3.0)初始化客户端,并通过 agent="你的 Agent ID" 调用已部署的智能体——注意 GEAP 目前不支持直接传 model= 调基础模型。它还会讲解单轮请求、用 previous_interaction_id 续接多轮对话、读取 steps/output_text 结果,以及每轮都必须携带 tools、system_instruction、generation_config 等参数。
适合想在 GEAP 上跑有状态多轮会话、后台研究任务、流式响应、结构化输出或 Function Calling 的开发者。前提是你已经有一个 GEAP 预配好的 Agent,并且项目开启了 aiplatform.googleapis.com;旧的 google-cloud-aiplatform、google-generativeai 等 SDK 和 gemini-1.5/2.0/2.5 及 3-flash-preview 等旧模型都不被支持,调用时务必升级到最新版 Gen AI SDK 并传入 agent ID。
在下面找到你用的工具,复制命令粘进终端就装好了:
npx skills add google/skills 装好后不用任何配置,直接在对话里说:
我已在 GEAP 部署 Agent,给段 Python 示例:调用 Gemini 单轮对话并打印结果。 AI 检测到任务匹配时会自动加载这个 Skill,不需要手动开关。
SKILL.md Interactions API 在 GEAP 尚未支持直接调用基础模型,必须先把能力封装成已预配的 Agent,再用 agent="<AGENT_ID>" 发起请求;参考 GEAP 文档创建并部署 Agent。
不能。Interactions API 要求使用 Unified Google Gen AI SDK(Python google-genai ≥2.3.0 或 JS @google/genai ≥2.3.0),google-cloud-aiplatform、google-generativeai 等旧包均不受支持。
每次调用 interactions.create 后记录返回的 interaction ID,下一轮换请求里传入 previous_interaction_id,服务端会保留对话状态,无需在本地维护完整历史。