docs: 添加 YouTube Studio 技能使用指南

This commit is contained in:
2026-08-24 14:49:57 +08:00
parent 5bc318e0cb
commit ba00651fa9

35
docs/usage-guide.md Normal file
View File

@@ -0,0 +1,35 @@
# YouTube Studio 技能的使用指南
这一组技能都是为了能更好的驱动Agent完成YouTube Studio数据的下载。一个常见的场景就是基于一个被授权的所有者数据访问权之后从指定的群组中提取指定的一组数据保存到本地。
如果你需要完成上面这个常见的应用场景,那么,本技能组中的所有技能都是必须的,包括:
- `uv-env-setup`:用于设置必要的 Python 运行环境,以便下面的技能所带的脚本可以正确运行。
- `yt-studio-url-builder`:用于构建 YouTube Studio 分析页面 URL。
- `youtube-studio-csv-download`:用于下载 YouTube Studio 分析数据。
- `yt-studio-groupid-lookup`:用于从群组名称中提取实体 ID。
对于这样一个任务对于只有一个群组数据需要下载的情况这组技能并没有人工下载来的快更适合批量下载众多群组的数据。也就是你需要Agent帮你从YouTube Studio的分析页面中下载众多群组的众多情况的数据时这组技能可以更好的指导Agent完成工作也能很好的加速下载。
### 流程说明
首先,你需要准备好以下几个东西:
1. 一个被授权的所有者数据访问权。
2. 一个包含群组名称的名单文件json / txt / csv / xlsx 均可)和所需的数据需求。
这里,数据需求,就是你需要下载哪些指标的数据,以及你需要哪些时间段的数据,也包括需要筛选什么信息,同时,你需要的是什么细分的数据,例如:频道数据、内容数据还是其他的数据。
下一步,是获取群组的实体 IDgroupid。你可以让Agent使用 `yt-studio-groupid-lookup` 技能,来从群组名称中提取实体 ID。这样前期的准备就算基本完成了。
然后指示Agent基于你的需求与获取的实体ID创建符合需求的分析页面 URL。
拿到这些URL之后就可以让Agent基于这些URL自动下载你需要的数据了。
这个流程你可以分步指示Agent完成也可以一次性指示Agent完成所有步骤但需要注意的是**每次指示Agent完成一个步骤后都需要确认Agent是否正确完成了任务以及是否有任何错误或异常情况发生**尽可能提供你需要的检查模式让Agent自己去检查它的结果以保证下载的数据是正确的。
### 检查与确认
常用的检查就是需要下载的文件数量需要对应于生成的URL数量。如果数量不对应那么就需要检查Agent是否正确生成了URL或者是否有任何错误或异常情况发生。
另外在URL生成过程中也需要检查Agent是否正确解析了群组名称以及是否有任何错误或异常情况发生。可以要求Agent抽样几个URL打开浏览器进行浏览确认。这个方式也可以确认Agent当前是否正确的读取了浏览器的登录状态以避免因为登录状态过期而导致的下载失败。