[ PROMPT_NODE_23994 ]
Bot Management 说明文档
[ SKILL_DOCUMENTATION ]
# Cloudflare 智能体管理
利用机器学习/启发式算法、智能体评分、JavaScript 检测和已验证智能体处理,提供企业级的智能体检测、防护和缓解措施。
## 概览
智能体管理提供多层防护:
- **免费版 (Bot Fight Mode)**: 自动拦截明确的智能体,无需配置
- **Pro/Business 版 (Super Bot Fight Mode)**: 可配置的操作、静态资源防护、分析分组
- **企业版 (Bot Management)**: 细粒度的 1-99 评分、WAF 集成、JA3/JA4 指纹识别、Workers API、高级分析
## 快速入门
txt
# 控制台: Security > Bots
# 企业版: 部署规则模板
(cf.bot_management.score eq 1 and not cf.bot_management.verified_bot) → Block
(cf.bot_management.score le 29 and not cf.bot_management.verified_bot) → Managed Challenge
## 你需要什么?
txt
├─ 初始设置 → configuration.md
│ ├─ 免费版 → "Bot Fight Mode"
│ ├─ Pro/Business → "Super Bot Fight Mode"
│ └─ 企业版 → "Bot Management for Enterprise"
├─ Workers API 集成 → api.md
├─ WAF 规则 → patterns.md
├─ 调试 → gotchas.md
└─ 分析 → api.md#bot-analytics
## 阅读顺序
| 任务 | 需阅读文件 |
|------|---------------|
| 启用智能体防护 | README → configuration.md |
| Workers 智能体检测 | README → api.md |
| WAF 规则模板 | README → patterns.md |
| 调试智能体问题 | gotchas.md |
| 高级分析 | api.md#bot-analytics |
## 核心概念
**智能体评分 (Bot Scores)**: 1-99 (1 = 绝对自动化,99 = 绝对人类)。阈值: <30 表示智能体流量。企业版提供 1-99 的细粒度评分;Pro/Business 版仅提供分组。
**检测引擎**: 启发式 (已知指纹,分配 score=1)、机器学习 (绝大多数检测,基于数十亿请求的监督学习)、异常检测 (可选,基准流量分析)、JavaScript 检测 (无头浏览器检测)。
**已验证智能体 (Verified Bots)**: 通过反向 DNS 或 Web Bot Auth 验证的白名单优质智能体(搜索引擎、AI 爬虫)。通过 `cf.bot_management.verified_bot` 或 `cf.verified_bot_category` 访问。
## 平台限制
| 计划 | 智能体评分 | JA3/JA4 | 自定义规则 | 分析保留期 |
|------|------------|---------|--------------|---------------------|
| 免费版 | 否 (仅自动拦截) | 否 | 5 | N/A (无分析) |
| Pro/Business | 仅分组 | 否 | 20/100 | 30 天 (每次 72 小时) |
| 企业版 | 1-99 细粒度 | 是 | 1,000+ | 30 天 (每次 1 周) |
## 基础模式
typescript
// Workers: 检查智能体评分
export