AGENT

用Gws+Valyu实现晨报自动化

结合Google的Workspace CLI（代理技能）和Valyu的DeepSearch技能，构建一个AI代理，该代理可以通过一次API调用研究36+数据源中的任何主题，将格式化的报告写入Google文档，通过电子邮件发送给您，并保存到您设置的您选择的Google云端硬盘，按您设置的时间表运行。

admin

• 16 min read
用Gws+Valyu实现晨报自动化
微信 ezpoda免费咨询：AI编程 | AI模型微调| AI私有化部署
AI工具导航 | Tripo 3D | Meshy AI | ElevenLabs | KlingAI | ArtSpace | Phot.AI | InVideo

您可能有一个每天都要跟踪的主题。一个市场。一个竞争对手。一个监管领域。一个产品。一个科学领域。关于AI的最新新闻。

日常工作看起来是一样的。您打开十几个标签页，通读结果，尝试综合，写笔记，明天重复。

AI代理可以为您完成这些工作。 不是那种返回您自己可以在30秒内找到的相同公共文章的浅层网络搜索，而是那些可以访问SEC文件、学术文献、临床试验、经济数据、股票数据、法律案件、运输数据，综合所有这些内容，并将格式化的报告直接发送到您的收件箱和Google云端硬盘的代理。

本指南将构建完全符合要求的代理。到结束时，您将拥有一个AI研究代理，它可以：

  • 通过单个API调用搜索网络和专有数据源
  • 将格式化的报告写入Google文档
  • 通过电子邮件向您发送报告，并提供直接链接
  • 将所有内容保存到您选择的云端硬盘文件夹
  • 按您设置的时间表每天、每周或任何时间自动运行

您不需要是开发人员。如果您能遵循指令并运行几个终端命令，就可以设置好它。

1、什么是Google代理技能？

Google代理技能是可重用的指令文件（称为  SKILL.md 文件），用于教AI代理如何使用特定工具和API。可以将它们视为安装到AI代理中的功能包。

当您将Google代理技能添加到Claude Code时，代理会确切地了解要运行哪些命令、使用什么参数、如何处理错误以及如何链接多个操作。您不需要了解底层API细节，技能会处理这些。

Google的开源Workspace CLI 附带100多个技能，涵盖所有主要的Google服务：

  • gws-gmail: 发送、读取和管理电子邮件
  • gws-drive: 上传文件、创建文件夹、管理共享
  • gws-docs-write: 创建和写入Google文档
  • gws-calendar: 管理事件和日程
  • gws-sheets: 读取和写入电子表格
  • recipe-email-drive-link: 在一步中共享云端硬盘文件并通过电子邮件发送链接
  • gws-workflow-meeting-prep: 提取您的下一个会议、与会者和链接的文档

Valyu 提供了自己的技能，教代理搜索36+数据源： SEC文件、PubMed、arXiv、ChEMBL生物活性化合物、FRED经济指标、临床试验、学术出版商、股票数据等。一个技能调用即可覆盖所有这些。

流程： Valyu研究 → 代理综合 → gws写入文档并通过Gmail发送。

None

您需要什么

四件事：

  1. 一个Google帐户： 常规的Gmail帐户即可
  2. Valyu API密钥： 免费在 platform.valyu.ai 获取，包含$10信用额度，无需信用卡
  3. 安装Node.js（版本18或更高版本）。在 nodejs.org 下载
  4. 安装Claude Code。运行技能的AI代理

2、安装Google Workspace CLI

Google Workspace CLI (gws) 是您的AI代理用来与Google服务交互的工具。

安装它：

npm install -g @googleworkspace/cli

验证它是否有效：

gws --version

您应该看到一个版本号。如果看到“command not found”，请确保Node.js已安装，并且您的npm全局目录在系统PATH中。

3、通过Google进行身份验证

从终端运行一次性设置：

gws auth setup

这将打开您的浏览器到Google的OAuth同意屏幕。登录，授予请求的权限（Gmail、Drive、Docs、Calendar），就完成了。

None
None
None

如果您在登录期间看到“Google尚未验证此应用”，请点击高级然后转到[应用名称]（不安全）。这是正常的。该工具在您自己的计算机上运行，而不是在第三方服务器上。

确认它有效：

gws drive files list

您应该看到来自您的Google Drive的文件列表。

注意： 您可能会遇到一些凭证相关的问题。Google服务互操作有时会感觉像迷宫。如果发生这种情况，只需要求Claude帮助您解决。

3、添加您的AI技能

技能通过 npx skills 命令安装。这会下载 SKILL.md 文件，教您的代理每个工具可以做什么。

添加Google Workspace技能

npx skills add https://github.com/googleworkspace/cli

这将安装所有100多个Google Workspace技能，包括研究管道所需的一切：文档编写、Gmail发送、Drive管理和配方工作流。

添加Valyu技能

npx skills add valyuAI/skills

这将安装Valyu的搜索和DeepSearch技能，教您的代理搜索36+数据源，包括网络。

设置您的Valyu API密钥

Mac或Linux：

export VALYU_API_KEY=your_api_key_here

要使其永久生效，请将该行添加到您的 **~/.bashrc** 或 **~/.zshrc** 文件中。

Windows (PowerShell):

$env:VALYU_API_KEY = "your_api_key_here"

要在Windows上永久设置：在开始菜单中搜索**“Edit environment variables”**，单击环境变量，添加一个新的用户变量名为 **VALYU\_API\_KEY**，值为您的密钥。

从 platform.valyu.ai 获取您的密钥。它以 **val-** 开头。

4、您的第一个研究请求

在自动化之前测试完整的工作流程。打开Claude Code并运行：

使用Valyu的DeepSearch研究[您的主题]的最新发展。搜索学术论文、财务数据、新闻和专有来源。将关键发现综合成结构化报告，包含：执行摘要、3-5个关键发现（附支持证据）以及关于影响的部分。
然后创建一个新的Google文档，标题为“Research Report: [您的主题] — [今天的日期]”。撰写此报告，并将链接通过电子邮件发送到[your-email@gmail.com]。

将括号中的内容替换为您的主题和电子邮件。尝试任何内容：“AI regulation in the EU”、“GLP-1 drug market”、“TSMC supply chain risks”、“quantum computing commercialization”、“climate tech venture funding 2025”。

代理将调用Valyu的DeepSearch，综合结果，创建Google文档，并通过电子邮件向您发送链接。首次运行通常需要3-7分钟。

为什么数据覆盖范围很重要

大多数进行“研究”的AI代理仅限于公共网络结果，即您在常规Google搜索中可以找到的相同文章。

Valyu的DeepSearch覆盖了许多爬虫无法完全访问的来源：

  • 对每家上市公司的SEC 10-K、10-Q和8-K文件进行全文搜索
  • PubMed、bioRxiv、medRxiv、arXiv。预印本和已发表论文
  • ChEMBL的250万种生物活性化合物
  • ClinicalTrials.gov数据
  • FRED和BLS经济指标
  • 实时股价、收益数据、内幕交易文件
  • 800万项美国专利
  • Polymarket和Kalshi预测市场

在FreshQA基准测试（600个时间敏感问题）中，Valyu得分为79%。Google得分为39%。Exa得分为24%。在特定财务问题上，Valyu得分为73%，而Google为55%。

当您研究准确性、近期数据和专有数据使简报真正有用的主题时，这种差距很重要。

5、自动化和定期运行的有趣部分！

现在，您将工作流包装到一个配置文件中，以便可以安排它每天早上运行。一旦掌握，您可以更改频率。

创建一个名为“research”的目录，并在其中创建一个名为 daily-research.md 的文件。您所有的首选项都将保存在这个文件中。这是纯英文。没有代码，没有脚本。

# My Daily Research Agent

## What to research
AI regulation and policy developments

## My email
you@gmail.com

## Google Drive folder for reports
Daily Research Reports

## Report format
1. Use Valyu DeepSearch to find the latest developments on the topic above. Search across web, academic, financial, and proprietary sources. Use search_type='all' to maximize coverage.

2. Write a report with these sections:
   - **Executive Summary** — 3-4 sentences, the most important thing to know today
   - **Key Findings** — 5-7 bullet points, each with a specific source cited
   - **Data and Numbers** — any concrete statistics, benchmarks, or financial figures
   - **Implications** — what this means going forward
   - **Sources** — full list of sources consulted

3. Create a new Google Doc with the report in my Google Drive folder listed above. Title it "Daily Research: [topic] - [today's date]". Create the folder if it doesn't exist.

4. Share the Doc so anyone with the link can view it.

5. Email me with:
   - Subject: "Daily Research Report: [today's date]"
   - The executive summary in the body
   - A link to the full Google Doc
   - How many sources were consulted

想下周更改主题吗？只需编辑“研究内容”下的行。想使用不同的报告结构吗？用自己的话重写指令。

在自动化任何内容之前，先运行一次以确保其有效。打开终端并运行：

cat ~/research/daily-research.md | claude --dangerously-skip-permissions

别担心。-- dangerously-skip-permissions 是为了确保它允许所有工具在不不断请求许可的情况下运行。

等待3到7分钟，然后检查您的收件箱。如果报告到达，您就可以将其设置为自动运行了。

None

让它自动运行。让它按计划自动运行

我们将使用 GitHub Actions 在云中按计划运行您的研究代理。它是免费的，您的计算机不需要开启。

  1. 转到 github.com，如果还没有帐户，请注册。它是免费的。
  • 转到 https://github.com/unicodeveloper/research-agent-template（确保您阅读了自述文件，尤其是关于Google Workspace凭据的部分）
  • 单击绿色的 “Use this template” 按钮 → “Create a new repository”
  • 将其命名为 my-research-agent，然后单击 Create repository

就是这样。您现在拥有了自己的副本，其中已经配置了自动化。

编辑您的配置

  1. 在新存储库中，单击 config.md
  • 单击右上角的铅笔图标进行编辑
  • 将主题、电子邮件和云端硬盘文件夹更改为您的
  • 单击 Commit changes

添加您的API密钥

  1. 转到 Settings → Secrets and variables → Actions
  • 单击 New repository secret 并添加： ANTHROPIC_API_KEY— 您的Anthropic API密钥 VALYU_API_KEY— 您的Valyu API密钥

测试它

  1. 转到 Actions 选项卡
  • 在左侧单击 "Daily Research Agent"
  • 单击 "Run workflow" → "Run workflow"
  • 等待几分钟并检查您的收件箱

绿色复选标记表示它有效。您的代理现在将每天早上自动运行。

稍后进行更改

一切现在都通过GitHub管理。初始设置后无需终端。

6、进一步利用的方法

上述工作流是基础。以下是变得更加有趣的地方。

1. 轮换主题库

每天从策划列表中研究不同的主题，而不是每天研究相同的主题。

2. 竞争情报跟踪器

同时跟踪多家公司并提供单一的综合报告。修改研究提示以明确请求：

  • 公司A、B和C的任何新产品公告
  • 最近的SEC文件和收益电话会议要点
  • 过去30天特定领域的专利申请
  • 最近10-Q中任何重大的风险因素披露

Valyu的全文SEC文件搜索在这里特别强大。您可以搜索风险因素披露中的实际语言，而不仅仅是文档标题。

“查找过去季度竞争对手披露的任何提及供应链或地缘政治风险的重大风险因素” 成为一个真实的查询。

3. Google表格研究日志

不是简单地给自己发电子邮件，而是将每天的关键发现附加到Google表格中。随着时间的推移，这将成为您代理发现内容的可搜索30天日志。

在代理提示末尾添加此内容：

在通过电子邮件发送报告后，将一行附加到Google表格（ID [your-sheet-id]），包含以下列：
日期、主题、执行摘要（前200个字符）、文档链接、来源数量。

使用 **gws-sheets-append** 技能。一个月后，您将拥有一个结构化的记录，可以进行筛选、排序和一目了然的查看。对于在多次研究运行中发现趋势非常有用。

4. 通过Google Chat进行团队通知

如果您的团队使用Google Chat，则添加一个通知步骤，以便将简报发送到您的团队已经在工作的频道，无需任何人检查电子邮件。

在提示中添加：

同时将消息发送到Google Chat空间 [your-space-id]，包含执行摘要和文档链接。

使用 **gws-chat-send** 技能。整个团队会自动获得早晨的研究简报。

5. 按源类型分层搜索

Valyu的DeepSearch具有不同的搜索模式。您也可以在同一报告的不同部分使用它们：

  • **search\_type=proprietary** 用于学术论文、SEC文件、临床数据、经济统计——权威来源
  • **search\_type=web** 用于最近的新闻、博客文章、社区讨论、当前对话

6. 每周摘要与日历集成

构建一个仅在星期五运行的版本，该版本将研究与您接下来的一周结合起来：

  1. 研究您主题领域本周最重要的发展
  • 使用 **gws-workflow-meeting-prep** 提取您的日历，获取接下来的7天
  • 对于任何研究与会议标题或与会者相关的会议，写一个简短的“相关上下文”笔记
  • 将这些笔记附加到日历事件描述中
  • 通过电子邮件发送完整摘要

提示补充：

撰写研究报告后，检查我接下来7天的日历。
对于任何研究主题相关的会议，
在该日历事件的描述中附加简要的上下文注释。

您将在周一进入已经用本周最相关的发展注释的日历。

7、常见问题解答

我需要是开发人员才能设置吗？

不需要。您需要运行终端命令，但每个命令都完全按照您输入的方式提供。如果您能在计算机上安装软件，就可以遵循本指南。

Valyu的费用是多少？

您在 platform.valyu.ai 注册时会获得$10的免费信用额度，无需信用卡。典型的每日研究报告使用约$0.10–0.30的API信用额度，具体取决于主题复杂性，因此免费信用额度可覆盖30-100天的每日报告。

什么AI代理运行这个？

本指南使用Claude Code，即AI编码代理。任何支持技能系统并可以从命令行运行的AI代理都将工作。

我可以研究任何主题吗？

是的。Valyu的搜索可以研究任何主题！

我可以每天运行多次吗？

是的。调整cron计划以根据需要运行。对于市场或监管新闻等快速变化的主题，每天在上午8点和下午4点运行两次很常见。

这和Zapier工作流程有什么区别？

传统的自动化工具需要配置特定字段和条件。当API更改时，它们会中断。代理技能是自然语言指令，由灵活的AI模型解释和执行。代理处理意外情况，智能地组合步骤，并可以适应，您是在用意图编程，而不是用僵化的字段映射。

如果我想要不同的输出格式怎么办？

更改提示。要求仅要点，或表格，或TLDR。代理遵循自然语言指令，因此输出格式完全由您在提示中指定。

Valyu实际搜索哪些来源？

网络搜索 + 研究（arXiv、PubMed、bioRxiv、medRxiv）、学术出版商、医疗保健（ClinicalTrials.gov、FDA药物标签、ChEMBL、DrugBank）、市场（股票、加密货币、外汇、ETF）、公司文件（SEC 10-K/10-Q/8-K、收益、内幕交易）、经济数据（FRED、BLS、世界银行）、预测市场（Polymarket、Kalshi）、法律/专利（美国专利、英国立法、法院案件）。

8、结束语

“可以访问信息” 和 “实际使用该信息做出更好的决策” 之间的差距主要是一个摩擦问题。当研究需要45分钟并需要15个标签页时，大多数人只有在绝对必要时才会这样做。

当研究每天早上自动运行，并且简报在您开始一天之前就在收件箱中等待时，习惯就会默认形成。您开始知道更多。您更早地发现问题。您拥有其他人缺乏的背景知识的会议不再仅仅是意外。

Google代理技能 和 Valyu 的数据访问相结合，使得构建这个比另一个自动化的新闻摘要更有价值。您不是在获取公共文章列表。您是在获取综合情报，这些情报来自机构研究人员、基金分析师和学术团队花费大量资源访问的相同来源。

设置一次。让它运行。成为100倍的人！

原文链接: How I Built an AI agent that Briefs me like the President Every Morning

汇智网翻译整理，转载请标明出处