Agently Daily News Collector v4

Agently Daily News Collector 已基于 Agently v4 完全重构，现已采用以下特性：

• 使用 TriggerFlow 实现端到端的处理流程（pipeline）
• 使用 Agently v4 内置的 Search 和 Browse 工具
• 使用结构化输出契约（Structured Output Contracts）取代旧版的 v3 workflow API

版本限制：本项目需要 Agently v4.0.8.3 或更高版本。当前实现使用 TriggerFlow sub flow 来组织各栏目的 pipeline，因此较早的 v4 版本无法兼容此处使用的 workflow 结构。

之前的 Agently v3 项目已归档至 ./v3。

功能特性

• 输入主题即可自动生成多栏目新闻简报
• 在一个流程中完成搜索、筛选、浏览、摘要和组稿
• 将最终报告保存为 ./outputs 下的 Markdown 文件
• 将 Prompt 模板统一存放在 ./prompts 中，方便编辑
• 保持独立的 ./tools 层，无需修改主工作流即可替换搜索/浏览工具
• 将流程构建保持在 ./workflow 中，使编排逻辑独立于采集器逻辑进行演进

快速上手

1. 安装依赖：

pip install -r requirements.txt

如果您手动安装 Agently，请确保版本不低于：

pip install "agently>=4.0.8.3"

2. 编辑 SETTINGS.yaml：

• 保持 model 块中的环境变量占位符
• 导出所需的环境变量：

export AGENTLY_NEWS_BASE_URL="https://api.openai.com/v1"
export AGENTLY_NEWS_MODEL="gpt-4.1-mini"
export AGENTLY_NEWS_API_KEY="your_api_key"

• 或者将它们放在本地的 .env 文件中：

AGENTLY_NEWS_BASE_URL=https://api.openai.com/v1
AGENTLY_NEWS_MODEL=gpt-4.1-mini
AGENTLY_NEWS_API_KEY=your_api_key

• 根据需要调整语言、搜索或并发设置
• 如果您使用的 OpenAI 兼容端点不需要身份验证，可以不设置 AGENTLY_NEWS_API_KEY，项目将自动跳过 auth。

3. 运行：

python app.py

或者直接传入主题：

python app.py "AI agents"

项目结构

.
├── app.py
├── news_collector/
├── tools/
├── workflow/
├── prompts/
├── outputs/
├── logs/
└── v3/

v3 到 v4 的重要变更

业务链路大致仍为：

大纲生成 (outline) -> 搜索 (search) -> 筛选 (pick) -> 浏览与摘要 (browse + summarize) -> 撰写栏目 (write column) -> 渲染 Markdown

改变的是该链路背后的工程形态。

项目层面的变更

• 旧版 v3 项目使用一个主工作流加上 ./workflows 下的嵌套栏目工作流，配合自定义的 search.py / browse.py 辅助类和存储式状态传递。
• v4 项目对职责划分更为明确：
  • news_collector/: 应用/集成层
  • workflow/: 父流程、栏目子流程以及具体的逻辑块
  • tools/: 搜索/浏览适配器层
  • prompts/: 结构化 Prompt 契约
• 模型配置不再硬编码在 Python 代码中，而是使用 SETTINGS.yaml 中的 ${ENV.xxx} 占位符，简化了部署和本地切换。
• 工具的挂载不再深埋在工作流代码中。搜索、浏览和日志记录器作为 TriggerFlow 运行时资源注入，使工作流更易于替换或测试。
• 工作流计划现在更贴近业务边界：
  • 父流程：prepare_request -> generate_outline -> for_each(column) -> render_report
  • 栏目子流程：search -> pick -> summarize -> write_column
  • 栏目流程中的 summarize 阶段被进一步下沉到摘要子流程中，TriggerFlow 直接处理分发和收集，无需在业务代码中手动编写 asyncio.gather
  • 这使得父流程专注于报告编排，而子流程专注于单个栏目的生命周期
  • sub flow 的直接价值在于：栏目 pipeline 现在成为一个可重用、可独立演进的工作流单元，而不是被埋没在一个庞大的父节点中。

本项目使用的 Agently v4 特性

• TriggerFlow 编排
  • 使用更直观的流程图（to, for_each, sub flow, 支持分支组合）取代了旧版 v3 的工作流链。
  • 不同于旧版 v3 Workflow 链，此处的 TriggerFlow 可以并发运行栏目，并在每个栏目内并发摘要筛选出的文章。
  • 对本项目而言：端到端的新闻管道更易于检查、演进和拆分，且无需将编排与业务逻辑混淆；报告父流和各栏目管道现在可以直接建模为父/子流。
• Sub flow 组合
  • 项目现在可以将自然的重复业务流水线（如“构建一个栏目”）提取为独立的 TriggerFlow，并在父流程的 for_each(column) 中重复调用。
  • 对本项目而言：
    • 父流程保持专注于报告级别的编排
    • 栏目 pipeline 可以独立进行测试、可视化和导出
    • 未来的变体（例如“简报总结”等）可以更轻松地通过组合现有流程实现。