Find a New Book
工作流概述
这是一个包含13个节点的复杂工作流,主要用于自动化处理各种任务。
工作流源代码
{
"id": "12",
"name": "Find a New Book",
"nodes": [
{
"name": "On clicking 'execute'",
"type": "n8n-nodes-base.manualTrigger",
"position": [
40,
140
],
"parameters": {},
"typeVersion": 1
},
{
"name": "Every Friday at 11:00 AM",
"type": "n8n-nodes-base.cron",
"position": [
20,
330
],
"parameters": {
"triggerTimes": {
"item": [
{
"hour": 11,
"mode": "everyWeek",
"weekday": "5"
}
]
}
},
"typeVersion": 1
},
{
"name": "Set Subject",
"type": "n8n-nodes-base.set",
"position": [
220,
330
],
"parameters": {
"values": {
"string": [
{
"name": "subject",
"value": "juvenile_literature"
}
]
},
"options": {},
"keepOnlySet": true
},
"typeVersion": 1
},
{
"name": "Retrieve Book Count",
"type": "n8n-nodes-base.httpRequest",
"position": [
420,
330
],
"parameters": {
"url": "=http://openlibrary.org/subjects/{{$json[\"subject\"]}}.json",
"options": {},
"queryParametersUi": {
"parameter": [
{
"name": "limit",
"value": "0"
}
]
}
},
"typeVersion": 1
},
{
"name": "Check Book Count",
"type": "n8n-nodes-base.if",
"position": [
620,
330
],
"parameters": {
"conditions": {
"number": [
{
"value1": "={{$node[\"Retrieve Book Count\"].json[\"work_count\"]}}",
"operation": "larger"
}
]
}
},
"typeVersion": 1
},
{
"name": "Select Random Book",
"type": "n8n-nodes-base.function",
"position": [
820,
330
],
"parameters": {
"functionCode": "var retrieve_book = 0;
var book_count = items[0].json.work_count;
retrieve_book = Math.floor(Math.random() * book_count) + 1
items[0].json.retrieve_book = retrieve_book;
return items;"
},
"typeVersion": 1
},
{
"name": "Retrieve Detailed Book Info",
"type": "n8n-nodes-base.httpRequest",
"position": [
1260,
330
],
"parameters": {
"url": "=http://openlibrary.org.{{$node[\"Retrieve Basic Book Info\"].json[\"works\"][0][\"key\"]}}.json",
"options": {},
"queryParametersUi": {
"parameter": [
{
"name": "limit",
"value": "1"
}
]
}
},
"typeVersion": 1
},
{
"name": "Retrieve Basic Book Info",
"type": "n8n-nodes-base.httpRequest",
"position": [
1040,
330
],
"parameters": {
"url": "=http://openlibrary.org/subjects/{{$json[\"name\"]}}.json",
"options": {},
"queryParametersUi": {
"parameter": [
{
"name": "limit",
"value": "1"
},
{
"name": "offset",
"value": "={{$json[\"retrieve_book\"]}}"
},
{
"name": "detail",
"value": "true"
}
]
}
},
"typeVersion": 1
},
{
"name": "Book Recommendation",
"type": "n8n-nodes-base.set",
"position": [
1830,
330
],
"parameters": {
"values": {
"string": [
{
"name": "msgSubject",
"value": "=Book Recommendation: {{$node[\"Create Author String\"].json[\"title\"]}}"
},
{
"name": "msgBody",
"value": "=<H2><a href=\"{{$node[\"Create Author String\"].json[\"URL\"]}}\">{{$node[\"Create Author String\"].json[\"title\"]}}</a></H2>
<p><em>By {{$node[\"Create Author String\"].json[\"authors\"]}}</em><br>
{{$node[\"Create Author String\"].json[\"description\"]}}</p>"
}
]
},
"options": {},
"keepOnlySet": true
},
"typeVersion": 1
},
{
"name": "Filtered Book Info",
"type": "n8n-nodes-base.set",
"position": [
1460,
330
],
"parameters": {
"values": {
"string": [
{
"name": "authors",
"value": "={{$node[\"Retrieve Basic Book Info\"].json[\"works\"][0][\"authors\"]}}"
},
{
"name": "title",
"value": "={{$node[\"Retrieve Basic Book Info\"].json[\"works\"][0][\"title\"]}}"
},
{
"name": "description",
"value": "={{$node[\"Retrieve Detailed Book Info\"].json[\"description\"][\"value\"]}}"
},
{
"name": "URL",
"value": "=https://openlibrary.org{{$node[\"Retrieve Basic Book Info\"].json[\"works\"][0][\"key\"]}}"
}
]
},
"options": {},
"keepOnlySet": true
},
"typeVersion": 1
},
{
"name": "Create Author String",
"type": "n8n-nodes-base.function",
"position": [
1630,
330
],
"parameters": {
"functionCode": "var arrAuthors = items[0].json.authors;
var arrNames = arrAuthors.map(function(author) {
return \"<a href=\\"https://openlibrary.org\" + author['key'] + \"\\">\" + author['name'] + \"</a>\";
});
var names = arrNames.join(\", \");
items[0].json.authors = names;
return items;"
},
"typeVersion": 1
},
{
"name": "Send No Book Email",
"type": "n8n-nodes-base.emailSend",
"position": [
830,
520
],
"parameters": {
"html": "=<p>Unfortunately, there are no books available for the subject of <em>{{$node[\"Check Book Count\"].json[\"name\"]}}</em>. Please update your n8n workflow with a different subject.</p>
<p>A list of all available subjects can be found at <a href=\"https://openlibrary.org/subjects\">the Open Library</a>.</p>",
"options": {},
"subject": "=Book not found in {{$node[\"Check Book Count\"].json[\"name\"]}}",
"toEmail": "john.doe@example.com",
"fromEmail": "john.doe@example.com"
},
"credentials": {
"smtp": "Gmail Creds"
},
"typeVersion": 1
},
{
"name": "Send Book Email",
"type": "n8n-nodes-base.emailSend",
"position": [
2030,
330
],
"parameters": {
"html": "={{$node[\"Book Recommendation\"].json[\"msgBody\"]}}",
"options": {},
"subject": "={{$node[\"Book Recommendation\"].json[\"msgSubject\"]}}",
"toEmail": "john.doe@example.com",
"fromEmail": "john.doe@example.com"
},
"credentials": {
"smtp": "Gmail Creds"
},
"typeVersion": 1
}
],
"active": false,
"settings": {},
"connections": {
"Set Subject": {
"main": [
[
{
"node": "Retrieve Book Count",
"type": "main",
"index": 0
}
]
]
},
"Check Book Count": {
"main": [
[
{
"node": "Select Random Book",
"type": "main",
"index": 0
}
],
[
{
"node": "Send No Book Email",
"type": "main",
"index": 0
}
]
]
},
"Filtered Book Info": {
"main": [
[
{
"node": "Create Author String",
"type": "main",
"index": 0
}
]
]
},
"Select Random Book": {
"main": [
[
{
"node": "Retrieve Basic Book Info",
"type": "main",
"index": 0
}
]
]
},
"Book Recommendation": {
"main": [
[
{
"node": "Send Book Email",
"type": "main",
"index": 0
}
]
]
},
"Retrieve Book Count": {
"main": [
[
{
"node": "Check Book Count",
"type": "main",
"index": 0
}
]
]
},
"Create Author String": {
"main": [
[
{
"node": "Book Recommendation",
"type": "main",
"index": 0
}
]
]
},
"On clicking 'execute'": {
"main": [
[
{
"node": "Set Subject",
"type": "main",
"index": 0
}
]
]
},
"Every Friday at 11:00 AM": {
"main": [
[
{
"node": "Set Subject",
"type": "main",
"index": 0
}
]
]
},
"Retrieve Basic Book Info": {
"main": [
[
{
"node": "Retrieve Detailed Book Info",
"type": "main",
"index": 0
}
]
]
},
"Retrieve Detailed Book Info": {
"main": [
[
{
"node": "Filtered Book Info",
"type": "main",
"index": 0
}
]
]
}
}
}
功能特点
- 自动检测新邮件
- AI智能内容分析
- 自定义分类规则
- 批量处理能力
- 详细的处理日志
技术分析
节点类型及作用
- Manualtrigger
- Cron
- Set
- Httprequest
- If
复杂度评估
配置难度:
维护难度:
扩展性:
实施指南
前置条件
- 有效的Gmail账户
- n8n平台访问权限
- Google API凭证
- AI分类服务订阅
配置步骤
- 在n8n中导入工作流JSON文件
- 配置Gmail节点的认证信息
- 设置AI分类器的API密钥
- 自定义分类规则和标签映射
- 测试工作流执行
- 配置定时触发器(可选)
关键参数
| 参数名称 | 默认值 | 说明 |
|---|---|---|
| maxEmails | 50 | 单次处理的最大邮件数量 |
| confidenceThreshold | 0.8 | 分类置信度阈值 |
| autoLabel | true | 是否自动添加标签 |
最佳实践
优化建议
- 定期更新AI分类模型以提高准确性
- 根据邮件量调整处理批次大小
- 设置合理的分类置信度阈值
- 定期清理过期的分类规则
安全注意事项
- 妥善保管API密钥和认证信息
- 限制工作流的访问权限
- 定期审查处理日志
- 启用双因素认证保护Gmail账户
性能优化
- 使用增量处理减少重复工作
- 缓存频繁访问的数据
- 并行处理多个邮件分类任务
- 监控系统资源使用情况
故障排除
常见问题
邮件未被正确分类
检查AI分类器的置信度阈值设置,适当降低阈值或更新训练数据。
Gmail认证失败
确认Google API凭证有效且具有正确的权限范围,重新进行OAuth授权。
调试技巧
- 启用详细日志记录查看每个步骤的执行情况
- 使用测试邮件验证分类逻辑
- 检查网络连接和API服务状态
- 逐步执行工作流定位问题节点
错误处理
工作流包含以下错误处理机制:
- 网络超时自动重试(最多3次)
- API错误记录和告警
- 处理失败邮件的隔离机制
- 异常情况下的回滚操作