AI AGENTS

Cloudflare Cache-Key Query-Param Pruner

Scans Cloudflare logs for query parameters that fragment the cache without changing responses.

CategoryAI Agents
Enginepaperclip
Difficultyadvanced
Triggerschedule
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerSchedule starts the param scan
  • ActionRetrieve request logs and cache statusCloudflareCloudflare
  • LogicCluster URLs differing only by query params
  • LogicVerify params do not change the response
  • ActionGenerate cache-key ignore-list change
  • OutputOpen GitHub PR against IaC repoGitHubGitHub

What it does

Tracking and marketing query params (utm_*, fbclid, gclid, session ids) splinter a single cacheable asset into thousands of unique cache keys, crushing your hit ratio. This workflow scans Cloudflare request logs, clusters URLs that differ only by such params, confirms the responses are identical, and proposes a cache-key configuration that ignores them — delivered as a GitHub pull request against your infrastructure-as-code repo so the change is reviewed and version-controlled.

When to use it

Use it when high-traffic landing pages or product pages show poor cache performance and you suspect query-string fragmentation. Ideal for teams managing Cloudflare via Terraform.

How it works

  1. 1A schedule kicks off the scan.
  2. 2The workflow retrieves recent request logs and cache status from Cloudflare.
  3. 3It clusters URLs that are identical except for query parameters and measures the fragmentation cost.
  4. 4A branch verifies the candidate params never alter the response body before recommending removal.
  5. 5It generates the cache-key ignore-list change in your IaC format.
  6. 6It opens a GitHub pull request with the diff and the supporting analytics in the description.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect CloudflareWorkers, Pages, R2, KV — the edge stack.
  2. 2
    Connect GitHubRepos, issues, pull requests, actions.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.