让飞书AI智能体直接查询百度推广账户数据
通过百度推广API连接真实广告账户,让优化师在飞书中用自然语言查询消费、关键词和转化数据,减少重复导表和报表整理。

这次实践解决什么问题
使用AI分析百度推广账户时,优化师过去需要先登录后台、选择日期、下载报表、整理Excel,再上传给AI。每次查询都要重复准备数据,临时分析和日常异常检查也会受到影响。
本次实践把百度推广账户通过API接入飞书AI智能体,让优化师可以直接提出数据问题,由智能体调用接口并整理结果。
本次内容由曹朝露完成业务确认,Tom完成功能研发。公开内容只说明已经验证的查询能力,没有披露客户身份、账户金额和真实关键词。
实践前提
开始前需要确认百度推广账户具备相应的API使用条件,在百度商业开发者中心创建应用,由客户账户完成授权,并让飞书中的智能体能够调用已经配置的数据服务。
查询字段、日期、层级和转化口径也需要提前明确。客户数据的使用范围和公开边界应在接入前确认。
实际操作
第一步,在百度商业开发者中心创建应用,配置本次查询需要使用的数据能力。
第二步,由客户的百度推广账户完成正式授权。不同客户使用独立的授权和项目空间。
第三步,把接口能力接入飞书AI智能体,并定义可查询范围、输入条件和返回格式。
第四步,使用真实账户提出指定日期和指定层级的问题。
第五步,将接口返回结果与百度推广后台进行抽样核对。
已经验证的提问
本次真实测试使用了两个问题:
9月23日这个账户花了多少钱?
把9月23日所有产生消费的关键词拉出来,按消费从高到低排序。
智能体可以根据指定日期调用账户数据,返回消费结果;也可以获取关键词明细,筛选产生消费的关键词并完成排序。
当前已经覆盖的数据
- 账户余额和预算;
- 账户、计划、单元和关键词四个层级;
- 展现、点击、消费、CTR和CPC;
- 表单提交、电话拨通等已经接入的转化数据。
实际可用字段仍取决于账户权限、接口能力、转化配置和统计口径。
怎样验证查询结果
验证时使用同一账户和同一日期在百度推广后台查询,先核对账户总消费,再抽查若干计划、单元和关键词,检查筛选条件和排序结果。
表单、电话等转化指标还需要确认统计口径。授权失效、无数据和接口异常也应单独测试,确保智能体不会在没有接口返回时生成数据。
下一阶段可以测试什么
沿着这条查询链路,可以继续测试每日自动获取前一天数据、与前一日和上周同期比较、筛选消费异常或点击增长但无转化的项目、检查预算接近上限的计划,以及生成日报和周报初稿。
这些任务尚未在本次实践中全部完成,需要逐项配置和验证。
CRM中的MQL、SQL、商机和成交数据也可以作为下一阶段的连接方向。本次实践还没有完成CRM链路,相关方法可以参考[《B2B的SEM,从广告数据走到业务数据》](/insights/blog/b2b-sem-ad-data-to-business-data/)。
人工判断边界
AI可以承担取数、计算、筛选、排序和报告初稿。优化师负责核对数据、解释变化原因、判断是否调整投放,并对预算和账户操作负责。
本次实践没有验证由AI直接修改预算、出价、启停或关键词状态。即使后续增加执行能力,这些动作也应保留人工确认和完整操作记录。
失败边界
账户未授权、权限不足、查询条件不明确、转化追踪没有正确配置、接口返回与后台口径不同,或者接口超时和字段发生变化时,智能体都可能无法完成查询。
出现这些情况时,智能体应说明失败原因或需要补充的信息,不能补写数据或扩大结论。
本次实践对应的完整文章见[《把百度推广账户接给AI:从手工导表到直接查询账户数据》](/insights/blog/baidu-sem-api-ai-agent/)。
可直接复制使用的 Prompt
下面保留这项实践中实际使用的 Prompt。使用时请补充当前任务的真实资料、适用边界和需要人工确认的内容。
请查询已授权的百度推广账户数据。 查询日期:[填写日期] 查询层级:[账户、计划、单元或关键词] 指标:[消费、展现、点击、CTR、CPC或转化] 筛选条件:[填写] 排序方式:[填写] 只使用接口实际返回的数据。请先说明账户、日期、层级和口径,再展示结果。接口无返回、权限不足或字段缺失时,请明确报告失败原因,不要根据历史数据补写答案。
