Wiki 知识库

全部文档 / 作者: Roger Martinez

25 篇
清除

3 markdown architecture patterns that boost agentic productivity

本文介绍了三种提升编码代理(Agentic)生产力的 Markdown 架构模式:AGENTS.md、DESIGN.md 和 SKILL.md。AGENTS.md 为代理提供项目全局指导,基准研究显示可减少 26% diff 大小、27% 耗时和 25% token 消耗,建议保持约 12 行简洁内容。DESIGN.md 由 Google 于 2026 年推出,通过描述性文字和 YAML 设计 token 固化设计系统,保证 UI 一致性。SKILL.md 提供可复用的任务流程指令,按需渐进加载以节省 token,且可复用于非编码业务场景。作者建议将规范纳入版本控制,像对待源码一样严格管理 Markdown,并警惕第三方 skill 的安全风险,从而规模化提升团队的智能体工作流效率。

技术 › Agent Google Cloud Tech 2026-10-266.7 KB 59.2K 698 81

The Jevons Paradox of AI coding agents: How reducing developer friction scales AI adoption

文章以杰文斯悖论类比:降低 AI 编码代理的使用摩擦反而会大幅提升其使用规模。Google Cloud Developer Plugin(基于开放的 Agent Plugins 规范)通过四层架构消除上下文瓶颈:多层级渐进式披露(约1680 token 的发现路由器)、通过 Developer Knowledge MCP 服务器获取实时有据可查的官方文档、严格的 gcloud CLI 执行护栏(leaf help 验证、非交互标志、输出投影压缩)以及凭据安全引导(ADC 与短期 IAM 模拟)。文章最后演示了端到端场景,引导 AI 代理一次性构建并部署跨 Cloud Run、Firestore 和 BigQuery 的实时事件分类管道,支持 Antigravity、Claude Code 和 Codex。

技术 › Agent Balaji Subramaniam 2026-09-3013.6 KB 21.9K 101 84

在安全边界内运行私有本地 AI 的四种架构

文章指出企业 AI 部署并非只有'公有 API 或自建推理平台'的二选一,私有 AI 实际是一个从客户端设备到完全物理隔离的连续谱系。作者提出四种隔离层级:1) 使用 LiteRT、Gemini Nano 等在移动 NPU 和浏览器上进行零外泄客户端推理;2) 通过 Confidential Computing(机密虚拟机与 NVIDIA H100 TEE)对云端 CPU/GPU 内存硬件级加密;3) 在私有 VPC 内用 GKE + vLLM/JetStream 自托管开源模型权重,实现权重与日志的完全掌控;4) 使用 Google Distributed Cloud Air-Gapped 为主权工作负载提供物理断网部署。工程关键在于按威胁模型和延迟预算匹配硬件边界。

技术 › 网络安全 Sergio Villani 2026-09-2612.8 KB 30.4K 208 84

构建实时语音 AI Agent 的四种模式:看、说、想、写代码

本文介绍使用 Gemini 3.8 Live 和 Google Agent Development Kit (ADK) 构建实时保险理赔语音代理的四种核心模式:1)工具标记为 NON_BLOCKING,让代理在执行代码时保持对话流畅,重要信息可打断;2)通过独立记录所见、来电者所述及验证结果,并用第二个模型复核照片证据,避免盲从口头描述;3)一个模型负责通话,后台由七个步骤的 SequentialAgent 团队异步整理理赔文书;4)模型负责理解对话,Python 负责执行金额、日期、安全等硬性规则。文章包含完整开源代码和本地运行指南。

技术 › Agent Google Cloud Tech 2026-09-258.6 KB 32.5K 229 84

如何使用 Gemini Live API 构建实时语音 AI Agent

本文介绍如何使用 Gemini Live API 构建具备自然对话体验的实时语音 AI Agent。与传统的单向 TTS 不同,Gemini Live 采用音频到音频的双向通信,能感知语气、停顿并支持随时打断。文章详细讲解了系统架构:浏览器客户端通过 WebSocket 连接 Python 后端,再与 Gemini 建立持久双向会话,并实现发送、接收、播放的并发核心循环。针对打断延迟问题,作者提出本地立即静音的 barge-in 技巧,并结合内置 VAD 实现即时响应。最后通过工具调用(function calling)与异步确认模式,让语音 Agent 能够播放音乐等实际操作且不产生尴尬停顿。完整示例代码已在 GitHub 开源。

技术 › Agent Annie Wang, Annie Cusack (Google Cloud) 2026-09-248.3 KB 35.9K 326 82

Loop Engineering for Sub-Dime Agents: Cutting Token Costs in AI Coding Harnesses

本文探讨如何通过循环工程降低自主编码 Agent 的 Token 成本。以一个 5 轮 PR 修复任务为例,未优化的 Harness 消耗 81,000 tokens($1.53),而优化后仅需 12,050 tokens($0.042)。核心机制包括:稳定的系统前缀以最大化 KV 缓存命中;基于 AST 的工具输出压缩,仅提取代码骨架;沙箱确定性工具预检与自动修复,避免浪费 LLM 推理;MCP 工具 Schema 的按需懒加载与 Code-Mode 执行;以及双层级模型路由(Workhorse 处理机械性任务,Frontier 处理复杂规划),并定义了四种确定性升级触发条件,实现亚角级(sub-dime)任务成本。

技术 › Harness Engineering Balaji Subramaniam (Google Cloud) 2026-09-2211.8 KB 49.6K 359 90

Put Claude Fable 5.1 and Gemini 3.8 Flash on the same team

本文介绍如何在 Google Cloud 的 Gemini Enterprise Agent Platform 上同时配置 Anthropic Claude Fable 5.1 与 Google Gemini 3.8 Flash 两款模型,并通过任务路由优化 token 成本(tokenomics)。作者指出单一模型路由全部任务是错误的:深度规划模型处理日常事务会浪费成本,而快速模型处理不可逆的复杂任务风险很大。文章详细演示了启用 Claude Fable 5.1 所需的数据共享配置(setPublisherModelConfig API)、Gemini 3.8 Flash 的调用方式,并建议先对常规任务做基准测试,以快速模型作为一线协调者、深度规划模型按需升级处理,从而大幅提升任务 ROI。

技术 › LLM Alan Blount (Google Cloud Tech) 2026-09-1518.4 KB 161.7K 894 82

Building low latency, streaming voice agents

本文介绍 Google 最新的语音转文本模型 Gemini 3.5 Transcribe,重点讲解其实时流式端点 gemini-3.5-transcribe-live 如何通过 WebSocket 以亚秒级延迟实现低延迟语音交互。作者以实时辩论代理为例,展示如何结合 Agent Development Kit (ADK) 构建多智能体流水线:在用户仍在说话时流式获取中间转录结果,经 Gemini 3.7 Flash 做意图过滤,后台并行触发 Google Search grounding 检索证据,最后通过 Cloud Text-to-Speech 生成自然语音回复。该模式支持 85+ 语言,适用于会议实时查证、呼叫中心坐席辅助、交互式语音机器人、直播字幕等场景,消除了传统语音应用的等待延迟。

技术 › TTS Wei Hsia 2026-09-118.7 KB 30.1K 208 74

Developers Guide to using fewer Gemini Tokens with your Agents

本文介绍如何通过上下文压缩代理 headroom 减少 Agent 调用 Gemini 模型时的 token 消耗。作者指出 agent 上下文中大部分 token 来自工具输出的冗余 JSON、日志和搜索结果,而非精心设计的提示词。通过在 Gemini 3.8 Flash 前部署 headroom 代理,在四种生产级 agent 工作负载测试中,prompt token 减少 76%,任务准确率保持 100%,首 token 时间有所改善,建模成本下降约 70%。文章同时诚实探讨了压缩的有损性:压缩器保留模式、分布和异常值,但会丢弃普通记录,模型在数据缺失时会拒绝编造。项目开源且可复现。

技术 › Agent Alan Blount 2026-09-0912.1 KB 43.8K 391 87

用 Eval 工程测试 AI Agent 的 6 种方法

文章指出传统确定性单元测试无法覆盖 AI Agent 的多轮、非确定性行为,提出将评估视为可自动化、可度量的 CI/CD 测试套件。作者给出 6 种生产级 Eval 实践:1)先做确定性 schema 检查(JSON 有效性、工具调用参数);2)用 Check Grounding API 等数学化度量事实依据,低于阈值即拒绝输出;3)检查多轮工具调用轨迹的依赖顺序并惩罚循环调用;4)构建带严格评分标准、输出推理过程的 AutoRater 评审模型;5)用 AutoSxS 成对对决和胜率数据安全替换模型;6)在 CI 中建立黄金回归数据集作为硬门禁。文中提到 Firebase 团队借此将复杂多步任务通过率从 31.7% 提升至 78.0%。

技术 › Agent Praveen Rajasekar (Google Cloud Tech) 2026-09-047.1 KB 32.9K 318 81

How to slash token costs with context caching in agent harnesses

本文介绍如何利用 Google Gemini Enterprise Agent Platform 的上下文缓存(Context Caching)大幅降低 Agent Harness 的 token 成本。文章指出无状态 LLM 在多轮编码循环中会重复传输静态代码库导致 token 累积和成本暴涨,并剖析了前缀破坏陷阱——缓存要求提示词从第 0 个 token 起字节级匹配,动态变量必须放在提示词末尾。作者展示了服务端缓存的工作原理及双重节省模型(带宽节省与缓存 token 0.25 倍计费),并通过 CachePayloadBuilder 和 ContextCacheManager 实现缓存流水线。实测三个场景显示传输 token 减少 74%-79%。最后给出决策树:上下文小于 32768 token 或少于三轮时不应缓存。

技术 › Harness Engineering Balaji Subramaniam 2026-09-0310.3 KB 46.4K 366 82

How to protect your agent harness from abuse with Firebase

本文介绍了如何使用 Firebase 保护 AI Agent 的 harness 免受滥用。作者首先阐述了 harness 的概念:围绕 AI 模型的基础设施、资源与护栏。由于沙箱隔离和生产数据写保护等策略无法解决访问控制问题,保护人机边界成为防御外部威胁的第一道防线。文章详细讲解了 Firebase Authentication 通过联合身份提供商标识用户身份,Firebase App Check 通过设备与应用证明(依托 DeviceCheck、Play Integrity、reCAPTCHA Enterprise 等)验证请求来源的合法性。此外还介绍了基于 TTL 的会话令牌及通过 getLimitedUseToken() 和后端标记消费实现的防重放机制,为敏感端点提供额外保护。

技术 › 网络安全 Roger Martinez 2026-09-015.7 KB 20.5K 133 71

构建弹性生产级 Agent Harness 的 5 层架构

文章指出 Agent 可靠性的关键在于模型之外的确定性软件基础设施,即 Harness Engineering。作者提出构建弹性生产 harness 的 5 层方法:1)从模型优先转向系统优先架构,结构化工作流可将任务完成率从 31.7% 提升至 78.0%;2)实现持久化状态与检查点,避免长时间运行中丢失进度;3)通过角色分离(规划者、生成者、评估者)构建验证闭环;4)利用 hooks 和隔离运行时(如沙箱、网关)确保安全边界,防御提示注入;5)记录结构化追踪便于调试与自动化修复。文中结合 Google Antigravity、ADK 2.0、Gemini Enterprise 等工具给出实践建议。

技术 › Harness Engineering Google Cloud Tech 2026-08-298.7 KB 35.7K 263 81

使用 Google Agents CLI 构建智能体评估内循环

本文是 Google 关于智能体质量飞轮的实操续篇,介绍如何用 agents-cli 手动运行评估内循环。作者构建了一个汇率转换智能体 fx-agent,并故意在指令中植入缺陷(未要求在回复末尾列出所使用的工具),通过六个测试用例的评估集验证:内置 AutoRaters 指标会遗漏此类缺陷,因此需要将关键行为提升为自定义指标(LLM 评审与正则代码检查双重视角)来单独度量。随后修复一行指令,并用分数变化证明修复有效。文章强调评估的意义在于检查智能体是否遵守规则,而非答案表面质量。

技术 › Agent Google Cloud Tech 2026-08-2815.9 KB 31.9K 289 85

什么是 Harness Engineering:如何用零手写代码交付软件产品

文章介绍了 Harness Engineering(脚手架工程)这一编码智能体领域的重要趋势。作者以 OpenAI 团队用 Codex 零手写代码交付产品的实验为例,说明开发者的角色从编写逻辑转变为设计智能体运行环境:包括设置严格的沙箱边界、构建自动修复循环、以结构化仓库代替冗长指令。文章用 Google ADK 2.0 和 Antigravity SDK 的代码示例演示了如何实现沙箱限制、测试验证节点、无限循环的 kill switch,以及用图工作流将代理与测试节点连接成自主修复系统。

技术 › Harness Engineering Google Cloud Tech 2026-08-2512.5 KB 55.5K 786 75

Token工程的四大实用支柱:超越提示压缩的成本优化

本文介绍了在大规模AI应用中优化token成本的四大实用支柱:一是上下文缓存与Agent循环修剪,通过裁剪中间工具输出和总结历史步骤保持提示精简,利用缓存可获最高75%的输入折扣;二是实时与批量推理,将非紧急任务如工单汇总、报告生成等打包为异步批处理,可享50%折扣;三是设置思考预算,避免推理模型在简单任务上消耗数千隐藏思考token;四是模型合理选型与持续评估,90%的任务应使用最小最便宜的模型,并通过自动化评估及时更换高效模型,配合Apigee AI Gateway等企业网关实现智能路由与安全防护。

技术 › LLM Google Cloud Tech 2026-08-227.4 KB 36.7K 345 77

5 design patterns for long-horizon agent harness

本文介绍了构建长周期(long-horizon)AI Agent 的五个设计模式,旨在解决 Agent 在长时间运行中出现的静默故障问题。作者基于自身开发并开源的长周期 Agent 框架(Long Horizon)的经验,总结了五个关键模式:稳定前缀(Stable prefix)以优化缓存命中率、后台学习(Background learning)以提升响应速度、持久化工作区(Persistent workspace)以保留跨会话状态、显式失败(Explicit failure)以避免错误报告,以及第五个模式(原文未完整给出)。这些模式帮助开发者避免 Agent 在长时间运行中悄悄偏离轨道,确保其稳定可靠。

技术 › Agent Google Cloud Tech 2026-08-2014.6 KB 106.5K 709 84

Agent Plugins are the future of Agent Skills

本文介绍了Agent Plugins作为打包Agent Skills及其依赖的MCP服务器的开放、厂商中立标准。Google已加入技术指导委员会作为核心维护者。文章详细说明了如何将现有技能迁移为插件,包括添加清单文件、配置mcp.json、处理路径占位符以及扩展命名空间,强调了插件的可移植性和组件独立失败的优势。作者通过实际经验展示了从技能到插件的转变过程,并指出了迁移中的常见陷阱,如发现规则仅深入一层。

技术 › Agent Google Cloud Tech 2026-08-1318.8 KB 98.4K 631 83

7 rules for self-improving agent loops every AI engineer should know

本文介绍了自改进智能体循环的七条规则,强调在智能体编写代码时,定义“好”的标准才是真正的工程工作。文章指出,循环可以自动化一切,但无法告诉你“更好”意味着什么,因此指标成为你编写的工件。通过自定义指标(如 retention_offered)和分级(grading)打破循环的盲目性,并利用 agents-cli 工具实现测量与改进的自动化。七条规则包括:从单一案例开始、让评判者解释原因、对确定性答案使用代码、评分行为而非路径、将不稳定案例视为发现、防止提议者移动标准、最后进行一次性自动优化。这些规则确保人类保持对自动循环的控制,并使评估与可观测性统一为同一循环的两种采样方式。

技术 › Agent Google Cloud Tech 2026-08-119.9 KB 127.1K 83

Google Cloud 推出 Agent Garden 原子 Agent 蓝图

文章介绍了 Google Cloud 在 Next '26 大会上发布的 Agent Garden 及其包含的 12 个核心 Agent 蓝图。这些生产就绪的模板旨在解决多 Agent 系统的设计、编排和评估难题。文章详细剖析了 SDLC Suite(软件生命周期管理)、On-Brand GenMedia(品牌媒体生成)和 Invoice Processing(发票处理)三个核心架构,展示了如何利用链式架构、自适应学习框架和 LLM 评估机制来解决企业实际痛点,帮助开发人员快速落地 AI 应用。

技术 › Agent Google Cloud Tech 2026-04-2612.1 KB 14.4K 179 84

ADK 2.0 中的五种多智能体编排模式

文章介绍了 Google Cloud Agent Development Kit (ADK) 2.0 中的五种多智能体编排模式,旨在解决生产环境中智能体协作的难题。核心模式包括:混合图模式,结合确定性与 AI 驱动节点;协调者-专家模式,拆分单一“上帝智能体”为专注的专家系统;技能组合模式,通过 SkillToolset 实现跨域复用;跨语言流水线,支持多语言协作;以及协议标准化,确保上下文在不同智能体间无损传递。

技术 › Agent Google Cloud Tech 2026-04-2426.5 KB 65.4K 469 88

构建多智能体系统的五种集成模式:A2A与MCP的协同

文章探讨了如何利用 A2A(Agent-to-Agent)和 MCP(Model Context Protocol)协议构建企业级多智能体系统。作者详细介绍了五种集成模式:Agent Card 发现机制、委派专业化模式、工具桥接模式(通过 MCP 连接数据源)、跨组织联邦模式以及环境事件网格。这些模式旨在实现智能体之间的互操作性、独立演化以及安全的数据访问,从而打破语言、团队和组织的界限。

技术 › Agent Google Cloud Tech 2026-04-2423.7 KB 47.1K 482 84

构建长时间运行 AI Agent 的 5 种设计模式

文章探讨了在构建需要持续运行数天甚至数周的 AI Agent 时所面临的挑战,并介绍了 Google Cloud Agent Runtime 支持的五种核心设计模式。这些模式包括:检查点与恢复以确保容错性、委托审批以实现人机协同、分层记忆架构以管理长期上下文、环境处理以应对无监督任务,以及针对多 Agent 协同的舰队编排。文章强调了状态管理、治理策略和基础设施在将 Agent 从演示转化为生产级系统中的重要性。

技术 › Agent Google Cloud Tech 2026-04-2322.0 KB 175.7K 1.3K 86

每位 ADK 开发人员都应该了解的 5 种代理技能设计模式

本文重点介绍了 ADK 开发中的 5 种代理技能设计模式,旨在帮助开发者超越单纯的格式规范,深入内容逻辑设计。文章详细解析了工具包装器、生成器、审核员、反转和流水线五种模式,涵盖了从知识封装、一致性生成、代码审查到交互流程控制等关键环节,并提供了决策树以指导开发者选择合适的模式构建更可靠的智能体。

技术 › Agent Google Cloud Tech 2026-03-187.8 KB 1.8M 4.4K 83