Skip to content

Commit 0e4afc1

Browse files
Oxyjunkodster28
authored andcommitted
[AI Audit] AI Audit update docs (cloudflare#23046)
* AI Audit update docs * AI bots -> crawler audit * Updating main landing page * Fixing bad links * Adding changelog entry * Update src/content/changelog/ai-audit/2025-06-17-refresh.mdx Co-authored-by: Kody Jackson <[email protected]> * Referring to Crawlers instead of bot for consistency * Adding a release note entry * Removing incorrect update * Update src/content/changelog/ai-audit/2025-06-17-refresh.mdx * Final alignment changes * Adding a note about filtering the table. * Updating the filename to match date of release * Updating changelog to match latest PRD * Updating filters per plan * Using SyncKey * Minor tweak * Last min content audit --------- Co-authored-by: Kody Jackson <[email protected]>
1 parent f4e9c3a commit 0e4afc1

File tree

14 files changed

+220
-131
lines changed

14 files changed

+220
-131
lines changed

public/__redirects

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -138,6 +138,10 @@
138138
# ai
139139
/ai/ /use-cases/ai/ 301
140140

141+
# ai-audit
142+
/ai-audit/features/detect-ai-crawlers/ /ai-audit/features/analyze-ai-crawlers/ 301
143+
/ai-audit/features/enforce-robots-txt/ /ai-audit/features/analyze-ai-crawlers/ 301
144+
141145
# AI Gateway
142146
/ai-gateway/get-started/configuring-settings/ /ai-gateway/get-started/ 301
143147
/ai-gateway/get-started/connecting-applications/ /ai-gateway/get-started/ 301
90.1 KB
Loading
82.2 KB
Loading

src/content/changelog/ai-audit/2024-09-23-ai-audit-launch.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Every site on Cloudflare now has access to [**AI Audit**](/ai-audit/), which sum
99
You can use this data to:
1010

1111
- Understand how and how often crawlers access your site (and which content is the most popular).
12-
- Block some or all of the AI bots accessing your site.
12+
- Block specific AI bots accessing your site.
1313
- Use Cloudflare to enforce your `robots.txt` policy via an automatic WAF rule.
1414

1515
![View AI bot activity with AI Audit](~/assets/images/changelog/ai-audit/ai-audit-overview.png)
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: AI Audit refresh
3+
description: More intuitive AI crawler management
4+
date: 2025-07-01T11:00:00Z
5+
---
6+
7+
We redesigned the AI Audit dashboard to provide more intuitive and granular control over AI crawlers.
8+
9+
- From the new **AI Crawlers** tab: block specific AI crawlers.
10+
- From the new **Metrics** tab: view AI Audit metrics.
11+
12+
![Block AI crawlers](~/assets/images/changelog/ai-audit/manage-ai-crawlers.png)
13+
14+
![Analyze AI crawler activity](~/assets/images/changelog/ai-audit/analyze-metrics.png)
15+
16+
To get started, explore:
17+
18+
- [Manage AI crawlers](/ai-audit/features/manage-ai-crawlers/).
19+
- [Analyze AI crawlers](/ai-audit/features/analyze-ai-crawlers/).
Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
title: Analyze AI crawlers
3+
pcx_content_type: concept
4+
sidebar:
5+
order: 7
6+
---
7+
8+
import { Tabs, TabItem } from "~/components";
9+
10+
AI Audit metrics provides you with key insights on how AI crawlers are interacting with your website.
11+
12+
To analyze AI crawlers:
13+
14+
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and domain.
15+
2. Go to **AI Audit**.
16+
3. Go to the **Metrics** tab.
17+
18+
## View AI Audit metrics
19+
20+
AI Audit provides you with the following metrics to help you understand how AI crawlers are interacting with your website.
21+
22+
| Metric | Description |
23+
| ---------------------------------- | ------------------------------------------------------------------------ |
24+
| Total requests | The total number of requests to crawl your website, from all AI crawlers |
25+
| Allowed requests | The number of requests you have allowed (by allowing AI crawlers) |
26+
| Blocked requests | The number of requests you have blocked (by blocking AI crawlers) |
27+
| Requests by AI crawlers | A graph which displays the number of crawl requests from each AI crawler |
28+
| Most popular paths by AI crawlers | The most popular pages crawled by AI crawlers, for each AI crawler |
29+
| Hosts | Top five most requested hosts (website domains) |
30+
| Paths | Top five most requested paths |
31+
| AI crawler operators | Top five most active AI crawler operators (by requests) |
32+
33+
## Filter date range
34+
35+
You can use the date filter to choose the period of time you wish to analyze.
36+
37+
<Tabs>
38+
<TabItem label="Free plan">
39+
40+
Filter options:
41+
42+
- Past 24 hours
43+
44+
</TabItem><TabItem label="Paid plans">
45+
46+
Filter options:
47+
48+
- Past 24 hours
49+
- Past 7 days
50+
- Past 14 days
51+
- Past month
52+
53+
</TabItem>
54+
</Tabs>
55+
56+
The values of the AI Audit metrics will update according to your filter.

src/content/docs/ai-audit/features/detect-ai-crawlers.mdx

Lines changed: 0 additions & 46 deletions
This file was deleted.

src/content/docs/ai-audit/features/enforce-robots-txt.mdx

Lines changed: 0 additions & 37 deletions
This file was deleted.
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
title: Manage AI crawlers
3+
pcx_content_type: concept
4+
sidebar:
5+
order: 2
6+
---
7+
8+
import { Steps, GlossaryTooltip, Tabs, TabItem } from "~/components";
9+
10+
AI Audit enables you to take specific action for each AI crawler.
11+
12+
To manage AI crawlers:
13+
14+
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and domain.
15+
2. Go to **AI Audit**.
16+
3. Go to the **AI Crawlers** tab.
17+
18+
## View the list of AI crawlers
19+
20+
The **AI Crawlers** tab displays a table of AI crawlers that are requesting access to your content, and how they interact with your pages. The table provides the following information, depending on the type of plan you are on.
21+
22+
<Tabs syncKey ="plan">
23+
<TabItem label="Free plan">
24+
| Column | Details |
25+
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26+
| AI Crawlers | The name of the AI crawler. |
27+
| Operator | The name of the entity who owns the AI crawler. Note that an operator may have multiple AI crawlers. |
28+
| Category | The category of the AI crawler. Refer to [Verified bot categories](/bots/concepts/bot/verified-bots/categories/). |
29+
| Block | Toggle for blocking specific AI crawlers. |
30+
31+
</TabItem> <TabItem label="Paid plan">
32+
33+
| Column | Details |
34+
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
35+
| AI Crawlers | The name of the AI crawler. |
36+
| Operator | The name of the entity who owns the AI crawler. Note that an operator may have multiple AI crawlers. |
37+
| Category | The category of the AI crawler. Refer to [Verified bot categories](/bots/concepts/bot/verified-bots/categories/). |
38+
| Requests | The number of times the AI crawler has requested to crawl your content. |
39+
| Robots.txt violations | The number of times the AI crawler has violated your <GlossaryTooltip term="robots.txt">`robots.txt`</GlossaryTooltip> file. |
40+
| Block | Toggle for blocking specific AI crawlers. |
41+
42+
</TabItem>
43+
</Tabs>
44+
45+
## Block access
46+
47+
You can block an AI crawler to completely stop the AI crawler from scraping your webpage.
48+
49+
Use the toggles in the **Block** column to block specific AI crawlers from accessing your content.
50+
51+
## Filter AI crawler data
52+
53+
You can use filters to narrow the scope of your result.
54+
55+
- **Name:** Search the name of the AI crawler.
56+
- **Operator:** Filter by the AI crawler operator.
57+
- **Category:** Filter by the category of the AI crawler (for example, AI crawler, AI assistant, or archiver).
58+
59+
The values of the table will update according to your filter.

src/content/docs/ai-audit/get-started.mdx

Lines changed: 41 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -11,76 +11,77 @@ head:
1111
description: Learn how to set up AI Audit.
1212
---
1313

14-
import { Details, Render, Steps } from "~/components";
14+
import { Details, Render, Steps, Tabs, TabItem, GlossaryTooltip } from "~/components";
1515

1616
This guide instructs you on how to:
1717

1818
- View AI crawlers that are interacting with pages in your domain (a [Cloudflare zone](/fundamentals/concepts/accounts-and-zones/#zones)).
19-
- Create a rule to block AI crawlers on your pages.
19+
- Use AI Audit to block individual crawlers from accessing your content.
2020

2121
## Prerequisites
2222

2323
1. Sign up for a [Cloudflare account](https://dash.cloudflare.com/sign-up/).
2424
2. [Connect your domain to Cloudflare](/fundamentals/manage-domains/add-site/).
2525
3. Make sure your domain is [proxying traffic through Cloudflare](/fundamentals/concepts/how-cloudflare-works/#cloudflare-as-a-reverse-proxy).
2626

27-
## 1. Block all AI crawlers
27+
## 1. Block specific AI crawlers
2828

29-
To use AI Audit:
29+
<Tabs syncKey="plans">
30+
<TabItem label="Free plan">
31+
32+
To only block specific AI crawlers:
3033

3134
{/* prettier-ignore */}
3235
<Steps>
33-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and domain.
34-
2. Go to **AI Audit**.
35-
3. From **Most Popular Paths**, select **Block All**.
36-
4. From the **Bot traffic** page, under **Block AI Bots**, select **Enable**.
36+
1. Go to **AI Audit**.
37+
2. From **AI Crawlers** tab, go to the list of AI crawlers.
38+
3. Review the AI crawlers that are accessing your domain.
39+
4. From the **Block** column, toggle the switch for AI crawlers you with to block.
3740
</Steps>
3841

39-
This feature also enables Cloudflare's [Bot Fight Mode: Block AI bots](/bots/get-started/bot-fight-mode/#block-ai-bots).
40-
41-
You can also create more complex rules when taking action on AI crawlers. For more information on creating more specific rules, refer to [Create a custom rule in the dashboard
42-
](/waf/custom-rules/create-dashboard/).
43-
44-
<Details header="Which bots will Cloudflare block?">
45-
<Render file="list-ai-bots" product="bots" />
46-
</Details>
47-
48-
:::note
49-
50-
For more details on how this rule interacts with other Cloudflare settings, refer to [How it works](/bots/concepts/bot/#how-it-works).
42+
:::note[Quality of AI crawler detection]
43+
On the free plan, AI Audit identifies AI crawlers based on their [user agent strings](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/User-Agent). This enables AI Audit to detect easy-to-detect (well-known) AI crawlers.
5144

45+
Upgrade your plan to enable a more thorough detection using Cloudflare's [Bot Management detection ID](/bots/reference/bot-management-variables/#ruleset-engine-fields) field.
5246
:::
5347

54-
## 2. Block specific bot categories (Enterprise plan only)
48+
</TabItem> <TabItem label="Paid plans">
5549

56-
Customers on the Enterprise plan -- and with a [Bot Management subscription](/bots/plans/bm-subscription/) -- can choose to only block specific AI crawlers, while allowing others.
50+
To only block specific AI crawlers:
5751

5852
{/* prettier-ignore */}
5953
<Steps>
60-
1. Go to the **AI Audit**.
61-
2. From **Most Popular Paths**, select **Block Some**.
62-
3. From the **Security rules** page, select **Create rule** > **Custom rules**.
63-
4. Provide a name for the custom rule. For example, "Block unwanted AI crawlers".
64-
5. From the **Field** dropdown, select **Verified Bot Category**.
65-
6. From the **Value** dropdown, select the specific bot category you wish to block.
66-
- You can use **And** / **Or** buttons to add additional conditions. For example, you can use multiple **Or** options to include multiple bot categories in the same rule.
67-
7. From the **Then take action...** section:
68-
- For **Choose action**, select **Block**.
69-
- For **With response type**, select **Default Cloudflare WAF block page**.
70-
8. From the **Place at** section:
71-
- For **Select order**, select **First**.
72-
9. Select **Save**.
54+
1. Go to **AI Audit**.
55+
2. From **AI Crawlers** tab, go to the list of AI crawlers.
56+
3. Review key information such as:
57+
- Bot operator
58+
- Number of requests sent by the AI crawler
59+
- Whether the AI crawler is allowed according to your `robots.txt`, or the number of times the AI crawler has violated your `robots.txt`.
60+
4. From the **Block** column, toggle the switch for AI crawlers you with to block.
7361
</Steps>
7462

75-
This custom rule will only block the AI bots which belong to the [verified bot categories](/bots/concepts/bot/verified-bots/categories/) you have included in your rule (in step 6).
63+
</TabItem>
64+
</Tabs>
7665

77-
For more information on creating a custom WAF rule, refer to [Create a custom rule in the dashboard](/waf/custom-rules/create-dashboard/).
66+
For more information, refer to [Manage AI crawlers](/ai-audit/features/manage-ai-crawlers/).
7867

79-
## 3. Review detected AI crawlers
68+
You can also create more complex rules when taking action on AI crawlers, using [Cloudflare WAF](/waf/). For more information on creating more specific rules, refer to [Create a custom rule in the dashboard](/waf/custom-rules/create-dashboard/).
8069

81-
Review the AI crawlers detected on your site in the **Metrics** tab of the Cloudflare dashboard for key metrics.
70+
## 2. Review detected AI crawlers
71+
72+
<Tabs>
73+
<TabItem label="All plans">
74+
75+
Review the AI crawlers detected on your site.
76+
77+
<Steps>
78+
1. Go to **AI Audit**.
79+
2. From the **Metrics** tab, view key metrics on AI crawlers.
80+
</Steps>
81+
</TabItem>
82+
</Tabs>
8283

83-
Refer to [Detect AI crawlers](/ai-audit/features/detect-ai-crawlers/) for more information.
84+
Note that on free plans, the **Metrics** tab only displays metrics for the past 24 hours.
8485

8586
## Related resources
8687

0 commit comments

Comments
 (0)