From ba00651fa9f993dec8b1c3043dc68029ad0467d8 Mon Sep 17 00:00:00 2001 From: Sidney Zhang Date: Mon, 24 Aug 2026 14:49:57 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20YouTube=20Studio?= =?UTF-8?q?=20=E6=8A=80=E8=83=BD=E4=BD=BF=E7=94=A8=E6=8C=87=E5=8D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/usage-guide.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/usage-guide.md diff --git a/docs/usage-guide.md b/docs/usage-guide.md new file mode 100644 index 0000000..c2f1b85 --- /dev/null +++ b/docs/usage-guide.md @@ -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 均可）和所需的数据需求。 + +这里，数据需求，就是你需要下载哪些指标的数据，以及你需要哪些时间段的数据，也包括需要筛选什么信息，同时，你需要的是什么细分的数据，例如：频道数据、内容数据还是其他的数据。 + +下一步，是获取群组的实体 ID（groupid）。你可以让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当前是否正确的读取了浏览器的登录状态，以避免因为登录状态过期而导致的下载失败。 \ No newline at end of file