AI Search Demo

Query Cloudflare AI Search (managed RAG, formerly AutoRAG) from a Worker via the Workers AI binding using env.AI.autorag(name).aiSearch({ query }).

API ReferenceCopy Anchor Link

GET /searchCopy Anchor Link

Run a natural-language search against your AI Search instance.

q string (required)

Natural language query.

Example RequestCopy Anchor Link

curl "https://your-worker.workers.dev/search?q=What%20is%20Workers%20AI"

Success ResponseCopy Anchor Link

{
  "answer": "Generated answer from AI Search",
  "results": [],
  "query": "What is Workers AI",
  "instance": "demo-index"
}

Error CodesCopy Anchor Link

• 400 - Missing or empty q (INVALID_QUERY)
• 502 - AI Search / AutoRAG failure (SEARCH_ERROR)

Use CasesCopy Anchor Link

• Learn managed RAG via AI Search from a Worker
• Prototype Q&A over indexed docs without building Vectorize yourself
• Compare AutoRAG-style search with a custom RAG Mini Search experiment
• Demo grounded answers with retrieval metadata

LimitationsCopy Anchor Link

• Requires a configured AI Search instance and indexed data source
• Uses the legacy AI.autorag(...).aiSearch API; newer projects may prefer dedicated ai_search bindings
• Remote/account access is typically needed for real searches
• No auth on the public /search endpoint

DeploymentCopy Anchor Link

curl "https://your-worker.workers.dev/search?q=hello"

Local DevelopmentCopy Anchor Link

cd apps/experiments/ai-search-demo
npm install
npm run dev

curl "http://localhost:8787/search?q=hello"

AI Search typically requires a remote instance (wrangler may need remote AI / account access).

ConfigurationCopy Anchor Link

wrangler.json declares:

• Workers AI binding AI
• Var INSTANCE_NAME (AI Search / AutoRAG instance name)

See AI Search Workers binding docs for the newer dedicated binding shape.

Cloudflare Features UsedCopy Anchor Link

• Workers - Edge compute runtime
• Workers AI - Binding used to call AI Search
• AI Search - Managed RAG over your indexed data