让飞书AI智能体直接查询百度推广账户数据

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

事橙营销AI实践频道封面图

这次实践解决什么问题

使用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。使用时请补充当前任务的真实资料、适用边界和需要人工确认的内容。

可直接使用的 Prompt
请查询已授权的百度推广账户数据。

查询日期:[填写日期]
查询层级:[账户、计划、单元或关键词]
指标:[消费、展现、点击、CTR、CPC或转化]
筛选条件:[填写]
排序方式:[填写]

只使用接口实际返回的数据。请先说明账户、日期、层级和口径,再展示结果。接口无返回、权限不足或字段缺失时,请明确报告失败原因,不要根据历史数据补写答案。