AI Search: update cache, syncing, and file type docs

[G4brym]

Changes

• Document configurable AI Search similarity cache TTLs and dashboard/API cache purge.
• Update inactivity-paused sync behavior to describe automatic resume after search/chat activity.
• Add .mdoc, .sql, and .log.gz to supported file types.

[cloudflare-docs-bot]

Review

⏸️ Automatic reviews for this PR are paused.

This PR has already received 2 automatic reviews. To run another review, a codeowner can comment /review or /full-review. To permanently lift the limit for this PR, a codeowner can comment /ignore-review-limit.

Tip: Keep PRs in draft mode until they are ready for review — the bot skips draft PRs automatically.

---

⚠️ 1 warning, 💡 2 suggestions found in commit a7b5d8a.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

Warnings (1)

File

Issue

ai-search/configuration/retrieval/cache.mdx line 55

Undocumented instance parameter — The change introduces cache_ttl as an instance-level create/update setting, but the canonical AI Search create-instance parameter reference (src/content/partials/ai-search/v2-create-instance-params.mdx) on this branch does not list it. Fix: Add cache_ttl to src/content/partials/ai-search/v2-create-instance-params.mdx so the create/update API reference includes the new field.

Style Guide Review

Suggestions (2)

File	Issue
ai-search/configuration/retrieval/cache.mdx line 55	Active voice preferred — Sentence uses passive voice: "cached responses are retained" Fix: Rewrite as active voice: "Set cache_ttl when creating or updating an instance to control how long the instance retains cached responses."
ai-search/configuration/indexing/syncing.mdx line 47	Use refer to [link] instead of see [link] — Line adds "(see Controls)" Fix: Change to refer to [Controls](#controls)

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command	Description
/review	Runs a review now. Incremental if a prior review exists, full if not.
/full-review	Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit	Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/src/content/changelog/ai-search/	@cloudflare/pm-changelogs, @rita3ko, @irvinebroque, @aninibread, @mchenco, @digizeph, @cloudflare/product-owners
/src/content/docs/ai-search/	@rita3ko, @irvinebroque, @aninibread, @G4brym, @mchenco, @digizeph, @cloudflare/product-owners
*	@cloudflare/product-owners

[ask-bonk]

One style issue to fix before merge.\n\nLOW — cache.mdx lines 74-77: In API examples (curl blocks), use $VARIABLE_NAME shell variable format per the style guide instead of angle-bracket placeholders. Posted an inline suggestion.

[ask-bonk]

Posted a review on PR #31661 with one inline suggestion.

Summary of changes

• New changelog entry for AI Search covering cache controls, crawler options, auto-resume, and file type support
• Documents configurable cache_ttl values and the purge cache operation in cache.mdx
• Updates sync behavior to describe automatic resume after search/chat activity in syncing.mdx
• Adds .mdoc and .sql to supported file types in data-source/index.mdx
• Documents website crawler option defaults in website.mdx

Issue flagged

• LOW — cache.mdx lines 74-77: The curl example uses angle-bracket placeholders (<ACCOUNT_ID>, <API_TOKEN>). The style guide requires $VARIABLE_NAME shell variable format in curl blocks. I posted an inline suggestion to change these to $ACCOUNT_ID, $INSTANCE_NAME, and $CLOUDFLARE_API_TOKEN.

Not flagged

• The existing TypeScript example in cache.mdx uses a bare ts fence rather than the TypeScriptExample component, but this is pre-existing unchanged code so I left it per the review guidelines.

github run

[github-actions]

Preview URL: https://e662e024.preview.developers.cloudflare.com
Preview Branch URL: https://ai-search-cache-sync-file-crawl-docs.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/ai-search/configuration/retrieval/cache/	https://ai-search-cache-sync-file-crawl-docs.preview.developers.cloudflare.com/ai-search/configuration/retrieval/cache/
https://developers.cloudflare.com/changelog/post/2026-06-24-ai-search-cache-sync-crawler-updates/	https://ai-search-cache-sync-file-crawl-docs.preview.developers.cloudflare.com/changelog/post/2026-06-24-ai-search-cache-sync-crawler-updates/
https://developers.cloudflare.com/ai-search/configuration/data-source/	https://ai-search-cache-sync-file-crawl-docs.preview.developers.cloudflare.com/ai-search/configuration/data-source/
https://developers.cloudflare.com/ai-search/configuration/indexing/syncing/	https://ai-search-cache-sync-file-crawl-docs.preview.developers.cloudflare.com/ai-search/configuration/indexing/syncing/