changelog and system prompt changes

Author: aninibread

src/content/changelog/ai-search/2025-10-27-ai-search-reranking-system-prompt.mdx

@@ -0,0 +1,54 @@
+---
+title: Reranking and API-based system prompt configuration in AI Search
+description: Improve result accuracy with reranking and dynamically control AI Search responses by setting system prompts in API requests.
+products:
+  - ai-search
+date: 2025-10-28
+---
+
+[AI Search](/ai-search/) now supports reranking for improved retrieval quality and allows you to set the system prompt directly in your API requests.
+
+## Reranking for more relevant results
+
+You can now enable [reranking](/ai-search/configuration/reranking/) to reorder retrieved documents based on their semantic relevance to the user’s query. Reranking helps improve accuracy, especially for large or noisy datasets where vector similarity alone may not produce the optimal ordering.
+
+You can enable and configure reranking in the dashboard or directly in your API requests:
+
+```javascript
+const answer = await env.AI.autorag("my-autorag").aiSearch({
+  query: "How do I train a llama to deliver coffee?",
+  model: "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+  reranking: {
+    enabled: true,
+    model: "@cf/baai/bge-reranker-base"
+  }
+});
+```
+
+## Set system prompts in API
+
+Previously, [system prompts](/ai-search/configuration/system-prompt/) could only be configured in the dashboard. You can now define them directly in your API requests, giving you per-query control over behavior. For example:
+
+```javascript
+// Dynamically set query and system prompt in AI Search
+async function getAnswer(query, tone) {
+  const systemPrompt = `You are a ${tone} assistant.`;
+
+  const response = await env.AI.autorag("my-autorag").aiSearch({
+    query: query,
+    system_prompt: systemPrompt
+  });
+
+  return response;
+}
+
+// Example usage
+const query = "What is Cloudflare?";
+const tone = "friendly";
+
+const answer = await getAnswer(query, tone);
+console.log(answer);
+```
+
+Learn more about [Reranking](/ai-search/configuration/reranking/) and [System Prompt](/ai-search/configuration/system-prompt/) in AI Search.
+

src/content/docs/ai-search/configuration/reranking.mdx

@@ -25,7 +25,7 @@ You can configure reranking in several ways:
 
 ### Configure via API
 
-You can also configure via the API. When you make a `/search` or `/ai-search` request using the [Workers Binding](/ai-search/usage/workers-binding/) or [REST API](/ai-search/usage/rest-api/), you can:
+When you make a `/search` or `/ai-search` request using the [Workers Binding](/ai-search/usage/workers-binding/) or [REST API](/ai-search/usage/rest-api/), you can:
 
 - Enable or disable reranking per request
 - Specify the reranking model

src/content/docs/ai-search/configuration/system-prompt.mdx

@@ -21,13 +21,7 @@ System prompts are particularly useful for:
 - Applying domain-specific tone or terminology
 - Encouraging consistent, high-quality output
 
-## How to set your system prompt
-
-The system prompt for your AI Search can be set after it has been created by:
-
-1. Navigating to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/ai/autorag), and go to AI > AI Search
-2. Select your AI Search
-3. Go to Settings page and find the System prompt setting for either Query rewrite or Generation
+## System prompt configuration
 
 ### Default system prompt
 
@@ -39,6 +33,27 @@ You can view the effective system prompt used for any AI Search's model call thr
 The default system prompt can change and evolve over time to improve performance and quality.
 :::
 
+### Configure via API
+
+When you make a `/ai-search` request using the [Workers Binding](/ai-search/usage/workers-binding/) or [REST API](/ai-search/usage/rest-api/), you can set the system prompt programmatically.
+
+For example:
+
+```javascript
+const answer = await env.AI.autorag("my-autorag").aiSearch({
+  query: "How do I train a llama to deliver coffee?",
+  model: "@cf/meta/llama-3.3-70b-instruct-fp8-fast",
+  system_prompt: "You are a helpful assistant."
+});
+```
+
+### Configure via Dashboard
+The system prompt for your AI Search can be set after it has been created by:
+
+1. Navigating to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/ai/autorag), and go to AI > AI Search
+2. Select your AI Search
+3. Go to Settings page and find the System prompt setting for either Query rewrite or Generation
+
 ## Query rewriting system prompt
 
 If query rewriting is enabled, you can provide a custom system prompt to control how the model rewrites user queries. In this step, the model receives:

src/content/docs/ai-search/usage/rest-api.mdx

@@ -53,8 +53,10 @@ curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai-search/rags/{
 	"max_num_results": 10,
 	"ranking_options": {
 		"score_threshold": 0.3,
+	},
+	"reranking": {
 		"enabled": true,
-    	"model": "@cf/baai/bge-reranker-base"
+    	"model": "@cf/baai/bge-reranker-base"}
 	},
 	"stream": true,
 }'
@@ -92,10 +94,11 @@ curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai-search/rags/{
 	"max_num_results": 10,
 	"ranking_options": {
 		"score_threshold": 0.3,
-		"enabled": true
-    	"model": "@cf/baai/bge-reranker-base"
 	},
-}'
+	"reranking": {
+		"enabled": true,
+    	"model": "@cf/baai/bge-reranker-base"}
+	}'
 
 ```
 

src/content/docs/ai-search/usage/workers-binding.mdx

@@ -46,10 +46,12 @@ const answer = await env.AI.autorag("my-autorag").aiSearch({
 	rewrite_query: true,
 	max_num_results: 2,
 	ranking_options: {
-		score_threshold: 0.3,
+		score_threshold: 0.3
+	},
+  reranking: {
     enabled: true,
     model: "@cf/baai/bge-reranker-base"
-	},
+  },
 	stream: true,
 });
 ```
@@ -117,10 +119,12 @@ const answer = await env.AI.autorag("my-autorag").search({
 	rewrite_query: true,
 	max_num_results: 2,
 	ranking_options: {
-		score_threshold: 0.3,
+		score_threshold: 0.3
+	},
+  reranking: {
     enabled: true,
     model: "@cf/baai/bge-reranker-base"
-	},
+  }
 });
 ```
 

src/content/docs/r2/api/tokens.mdx

@@ -20,7 +20,7 @@ To create an API token:
 1. In the Cloudflare dashboard, go to the **R2 object storage** page.
 
    <DashButton url="/?to=/:account/r2/overview" />
-2. Select **Manage API tokens**.
+2. Select **Manage in API tokens**.
 3. Choose to create either:
    - **Create Account API token** - These tokens are tied to the Cloudflare account itself and can be used by any authorized system or user. Only users with the Super Administrator role can view or create them. These tokens remain valid until manually revoked.
    - **Create User API token** - These tokens are tied to your individual Cloudflare user. They inherit your personal permissions and become inactive if your user is removed from the account.

src/content/partials/ai-search/ai-search-api-params.mdx

@@ -12,6 +12,10 @@ The input query.
 
 The text-generation model that is used to generate the response for the query. For a list of valid options, check the AI Search Generation model Settings. Defaults to the generation model selected in the AI Search Settings.
 
+`system_prompt` <Type text="string" /> <MetaInfo text="optional" />
+
+The system prompt for generating the answer.
+
 `rewrite_query` <Type text="boolean" /> <MetaInfo text="optional" />
 
 Rewrites the original query into a search optimized query to improve retrieval accuracy. Defaults to `false`.
@@ -27,6 +31,10 @@ Configurations for customizing result ranking. Defaults to `{}`.
 - `score_threshold` <Type text="number" /> <MetaInfo text="optional" />
   - The minimum match score required for a result to be considered a match. Defaults to `0`. Must be between `0` and `1`.
 
+`reranking` <Type text="object" /> <MetaInfo text="optional" />
+
+Configurations for customizing reranking. Defaults to `{}`.
+
 - `enabled` <Type text="boolean" /> <MetaInfo text="optional" />
   - Enables or disables reranking, which reorders retrieved results based on semantic relevance using a reranking model. Defaults to `false`.
 

src/content/partials/ai-search/search-api-params.mdx

@@ -23,6 +23,10 @@ Configurations for customizing result ranking. Defaults to `{}`.
 - `score_threshold` <Type text="number" /> <MetaInfo text="optional" />
   - The minimum match score required for a result to be considered a match. Defaults to `0`. Must be between `0` and `1`.
 
+`reranking` <Type text="object" /> <MetaInfo text="optional" />
+
+Configurations for customizing reranking. Defaults to `{}`.
+
 - `enabled` <Type text="boolean" /> <MetaInfo text="optional" />
   - Enables or disables reranking, which reorders retrieved results based on semantic relevance using a reranking model. Defaults to `false`.