Files
agent-park/docs/integrations/n8n/workflows/07-signals-aggregation.md
T

90 lines
2.5 KiB
Markdown

# 前沿信号聚合(多源+AI Agent过滤)
- Registry ID: `signals-aggregation`
- n8n Workflow ID: `bAxNZKGq2ApUUiw9`
- Status: `confirmed`
- 角色: 聚合多源讨论与发布内容,筛出 AI Agent 相关信号,结构化后写入 AgentPark 的 `signals` 数据流。
## 触发方式
- 定时触发
- 当前已核查行为:多源周期抓取
## 数据来源
- Hacker News
- GitHub
- arXiv
- Reddit
- Product Hunt
- Hugging Face
## 主流程
1. 从 6 类外部源抓取候选讨论或发布内容。
2. 做基础规则过滤与去重。
3. 使用 LLM 判断是否属于 AI Agent 相关前沿信号。
4. 生成中英双语标题、摘要、主题、标签、sections 和热度字段。
5. 调用仓库 webhook 写入 `signals`
6. 从保留结果中抽取 GitHub 仓库链接,回流 discovery 系统继续发现项目。
## 输入契约
- `apiKey`
- `signals[].source`
- `signals[].sourceUrl`
- `signals[].title`
- `signals[].titleEn`
- `signals[].summary`
- `signals[].summaryEn`
- `signals[].topic`
- `signals[].topicEn`
- `signals[].tags`
- `signals[].sections`
- `signals[].engagement`
- `signals[].hotScore`
- `signals[].isHot`
- `signals[].publishedAt`
- `signals[].isActive`
## 输出契约
- `success`
- `processed`
- `created`
- `updated`
- `failed`
- `errors[].index`
- `errors[].field`
- `errors[].message`
## 与仓库的关系
仓库内直接接点:
- [auth.ts](D:/Code/AI/agent-park/src/lib/auth.ts)
- [route.ts](D:/Code/AI/agent-park/src/app/api/webhook/signals/route.ts)
- [route.ts](D:/Code/AI/agent-park/src/app/api/signals/route.ts)
- [validations.ts](D:/Code/AI/agent-park/src/lib/validations.ts)
- [schema.prisma](D:/Code/AI/agent-park/prisma/schema.prisma)
## 下游影响
- Signals 页面内容
- 热门信号排序与过滤
- 从信号反向发现 GitHub 项目的回流链路
## 已确认要点
- 已通过 live n8n MCP 核查 workflow 元数据与 webhook 写入方向。
- 该流程会向 `/api/webhook/signals` 写入结构化 signals。
- 它还会触发外部 discovery 去重与任务创建,因此不只是“信号展示流”,也是项目发现的旁路入口。
- workflow 当前在 HTTP body 中携带共享密钥,仓库侧应视为待治理项,后续改为 n8n credential 或环境变量注入。
## 维护要求
- 字段结构、验证 schema、热度算法变更时,同步更新:
- [registry.json](D:/Code/AI/agent-park/docs/integrations/n8n/registry.json)
- [validations.ts](D:/Code/AI/agent-park/src/lib/validations.ts)
- [route.ts](D:/Code/AI/agent-park/src/app/api/webhook/signals/route.ts)