在「智能体与自动化」类工具里，Google ADK 的定位是：谷歌开源的智能体开发套件。

下面按「现象 → 可能原因 → 处理办法」整理常见问题。

排查表

现象处理办法
智能体陷入循环设置最大步数和超时，关键步骤改为固定工作流。
调用外部系统失败增加重试和失败通知，记录请求参数便于排查。
输出格式不稳定要求结构化输出并做格式校验，不合格时重试。
费用超出预期给每次运行设上限，监控调用次数，先用小模型处理简单步骤。
误发消息给客户对外发送前加人工审批节点，测试环境与正式环境分开。

通用排查顺序

  1. 确认账号、额度和网络状态正常。
  2. 用一份简单材料复现问题，排除材料本身的干扰。
  3. 检查设置是否被改动（模型、语言、格式等）
  4. 查看官方状态页或更新日志。
  5. 仍无法解决时整理复现步骤联系官方支持。

用标准任务做对照测试

多步骤调研任务

准备材料：一个需要多来源信息的问题。

围绕【主题】做调研：先列出调研计划，再分别检索，最后输出带来源的报告。每个结论注明来源链接，来源之间矛盾时并列呈现。

验收标准：矛盾信息被并列呈现。

延伸练习

定时提醒与汇总

输入：团队群聊或任务看板。

每天下午 6 点汇总今日新增和逾期任务，按负责人分组发送提醒，周五额外输出一周完成情况。

检查点：提醒内容与看板一致。

线索整理流程

适用情况：手头有每天从表单收到的客户咨询时。

搭建一个流程：新表单提交后，AI 判断咨询类型（报价 / 售后 / 合作 / 其他），提取联系人和需求摘要写入表格，报价类自动通知销售群。分类不确定时标记为「待人工」。

验收标准：不确定的情况进入人工。

竞品信息周报

适用情况：手头有 5 个竞品的公开网站或博客时。

每周一自动抓取这些竞品页面的更新，让 AI 对比上周内容，输出「新增功能 / 价格页面变化 / 新发布文章」三段摘要，并附原始链接。

检查点：每条变化都附链接。

常见问题：输出格式不稳定

要求结构化输出并做格式校验，不合格时重试。

常见问题：智能体陷入循环

设置最大步数和超时，关键步骤改为固定工作流。

常见问题：费用超出预期

给每次运行设上限，监控调用次数，先用小模型处理简单步骤。

概念补充：触发器

启动流程的事件，如新邮件、定时、表单提交。

概念补充：可观测性

记录每一步输入输出与耗时，便于排查和评估。

适合人群：客服人员

客服人员可以用 ADK 处理回复草稿、工单分类等工作。需要注意：不得以 AI 名义做出政策外承诺，涉及隐私的问题按流程处理。

适合人群：新媒体运营

新媒体运营可以用 ADK 处理内容排期、数据复盘等工作。需要注意：活动规则与奖品说明要准确，避免诱导分享等违规玩法。

写在最后

本文基于 Google ADK 公开的定位与通用用法编写，具体功能、套餐与可用地区以官方页面为准，产品更新后界面和名称可能变化。

文中提示词和示例仅作示意，实际效果取决于你的材料和 ADK 当前版本，重要内容请人工核对后再使用。

延伸阅读