1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | gemini-interactions-api-google-skills（合集仓库 google/skills 内的子技能） |
| 作者/维护方 | Google（google 官方 GitHub 组织） |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/gemini-interactions-api |
| 许可证 | Apache-2.0（GitHub API 实测，仓库级） |
| GitHub Stars | 18,717（GitHub API 实测；为合集仓库整体数据，非本技能单独热度） |
| Forks | 1,503（同上，合集仓库整体数据） |
| 最新版本 | 无独立 Release/Tag，随 main 分支滚动更新（实测最近一次内容提交 2026-07-13） |
| 安装方式 | npx skills add google/skills（安装时选择 gemini-interactions-api 子技能） |
2. 功能介绍与亮点
本技能是 Gemini Enterprise Agent Platform（GEAP）上新一代有状态 Interactions API 的开发指南，覆盖单轮问答、多轮有状态对话、实时流式输出、结构化输出（Pydantic/JSON Schema）与函数调用五大场景，Python、TypeScript/JS 双语言 SDK 均给出可直接复制的代码，另附一节纯 REST/curl 调用方式供无 SDK 环境使用。
亮点：
① 状态由服务端托管：对话历史通过 previous_interaction_id 引用，无需客户端每轮拼接完整历史，store=True 为默认行为；
② 明确的迁移警示：正文强制要求编程助手在生成代码时主动提醒用户——传统 google-cloud-aiplatform/google-generativeai 等旧版 SDK 与 gemini-2.5-* 等旧模型不再支持 Interactions API，避免助手照搬训练数据里的过时用法；
③ 完整的数据模型参考：文档末尾给出全部 step 类型（function_call/thought/google_search_call 等）与流式事件类型对照表，帮助编程助手正确处理“最后一步不一定是文本”这类边界情况；
④ 面向 Agent Platform 的定向说明：明确指出本平台调用需用 agent="<ID>" 定位已配置的 Agent 而非直接传 model=，并点明这是与公开版 ai.google.dev 文档的关键差异，避免张冠李戴。
3. 适用场景
所属分类：工程效率与代码质量
适用于在 Google Cloud / Gemini Enterprise Agent Platform 环境中开发多轮对话类 AI 应用的工程师——尤其是需要后台长任务、流式输出、工具调用等能力，且希望编程助手写出的调用代码从一开始就符合最新 SDK 与模型规范、不踩已弃用接口的团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持——标准 SKILL.md 格式，可直接放入
.claude/skills/或经npx skills add安装。 - Codex：原生支持——
npx skills官方支持列表明确列出 Codex 及专用安装路径。 - OpenClaw：原生支持——同一安装器官方支持列表列出 OpenClaw，并有专用路径。
- Hermes Agent：原生支持——同一安装器官方支持列表列出 Hermes Agent，并有专用路径。
（核验依据：npx skills/skills.sh 项目 README 的受支持 agent 列表与路径映射表。）
5. 推荐理由
多数 AI SDK 类技能只是把官方文档照抄一遍，本技能的价值在于主动拦截“用旧知识写新代码”——它不只是教怎么调用，还强制要求编程助手在生成代码时明确警告用户哪些 SDK 版本、哪些模型已不再适用，这对训练数据存在滞后性的编程助手尤其重要。数据模型参考表也直接解决了流式/工具调用场景下“最后一个 step 到底是什么类型”这个常见的实现错误来源。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 Google 官方发布；所属仓库为多技能合集，18,717 星是仓库整体数字，不代表本技能自身热度；未查到该技能自身的独立第三方讨论 |
| 可用性 | 8 | 单文件 SKILL.md 结构完整、双语言代码示例齐全，另附纯 REST 调用路径；最近一次提交 2026-07-13，仍在维护窗口内；仅有主文档、无独立 references 子目录，内容深度低于同仓库部分附带多篇参考文档的技能 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：① 全篇不涉及本地 shell 命令执行，仅 gcloud auth/gcloud services enable 两条标准 GCP 认证与开 API 命令，用途明确 ② 无外部网络外发，全部调用官方 Google Cloud/Gemini API 端点，目标透明 ③ 认证走 Application Default Credentials，正文未要求手工粘贴或硬编码密钥 ④ 通读全文未发现可疑指令、混淆代码或诱导性文案 ⑤ 作者为 Google 官方仓库，信誉最高档 ⑥ 许可证明确（Apache-2.0） ⑦ 最近一次提交 2026-07-13，维护活跃
7. 跟同类 Skills 相比的优势
| 技能 | 平台/范围 | 与本技能的差异 |
|---|---|---|
| gemini-api-google-skills | 同仓库，Gemini 五语言 SDK 通用指南（文本/多模态/Embedding/Live 等） | 覆盖传统的一次性 generateContent 风格调用与更广的功能面，不涉及服务端托管对话状态；本技能专攻新一代有状态 Interactions API，两者官方定位为互补而非替代 |
| gemini-api-dev-google-gemini-gemini-skills | 不同仓库（google-gemini/gemini-skills），面向 AI Studio/开发者版 Gemini API | 服务对象是直接调用公开 ai.google.dev 接口、用 model= 参数的个人开发者场景；本技能服务企业级 Agent Platform，用 agent= 定位已配置 Agent，认证与调用路径均不同 |
| claude-api-anthropics-skills | Anthropic 官方，Claude API SDK 使用指南 | 服务对象是 Claude 模型 API 本身，覆盖工具调用、流式、prompt caching 等，与本技能面向不同厂商的模型 API，功能面存在结构性相似但服务对象不同 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 安装使用方式
- 命令行安装：
npx skills add google/skills，安装时勾选gemini-interactions-api - 手动安装：将
skills/cloud/gemini-interactions-api目录复制进所用 agent 的 skills 目录 - 使用前提：需已通过
gcloud auth application-default login完成认证，并启用aiplatform.googleapis.comAPI；需使用google-genai>=2.3.0（Python）或@google/genai>=2.3.0（JS/TS）等受支持 SDK 版本 - 安装后无需重启，在对话中提出 Interactions API 相关的开发需求即会触发
10. 注意事项
- 目前仅支持面向已配置的 Agent（
agent="<ID>"）调用，Gemini Enterprise Agent Platform 上暂不支持直接对基础模型发起调用 - 若传入
store=False关闭服务端状态保留，则previous_interaction_id与后台任务能力同时失效，需自行在每轮请求中携带完整对话历史 - 仅覆盖 Interactions API 本身的调用方式，不涉及 Agent 本身的创建、部署或调优，这些需配合同仓库的 Agent Platform 系列技能使用