🔍 feat: Web Search via OpenAI Responses API (#8186)

* 🔍 feat: Introduce Web Search Functionality for OpenAI API

- Added a new web_search parameter to enable web search capabilities in the OpenAI configuration.
- Updated the DynamicSlider component for improved styling.
- Enhanced the useSetIndexOptions hook to auto-enable the Responses API when web search is activated.
- Modified relevant schemas, types, and translation files to support the new web search feature.

* chore: remove comments

* refactor: tool handling in initializeAgent for better clarity and functionality and reflection of openai features

---------

Co-authored-by: Danny Avila <danny@librechat.ai>

packages/api/src/endpoints/openai/llm.ts

@@ -1,5 +1,6 @@
 import { ProxyAgent } from 'undici';
 import { KnownEndpoints, removeNullishValues } from 'librechat-data-provider';
+import type { BindToolsInput } from '@langchain/core/language_models/chat_models';
 import type { AzureOpenAIInput } from '@langchain/openai';
 import type { OpenAI } from 'openai';
 import type * as t from '~/types';
@@ -176,6 +177,13 @@ export function getOpenAIConfig(
     delete llmConfig.max_tokens;
   }
 
+  const tools: BindToolsInput[] = [];
+
+  if (modelOptions.web_search) {
+    llmConfig.useResponsesApi = true;
+    tools.push({ type: 'web_search_preview' });
+  }
+
   /**
    * Note: OpenAI Web Search models do not support any known parameters besides `max_tokens`
    */
@@ -216,5 +224,6 @@ export function getOpenAIConfig(
   return {
     llmConfig,
     configOptions,
+    tools,
   };
 }

packages/api/src/types/openai.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { openAISchema, EModelEndpoint } from 'librechat-data-provider';
 import type { TEndpointOption, TAzureConfig, TEndpoint } from 'librechat-data-provider';
+import type { BindToolsInput } from '@langchain/core/language_models/chat_models';
 import type { OpenAIClientOptions } from '@librechat/agents';
 import type { AzureOptions } from './azure';
 
@@ -33,6 +34,7 @@ export type ClientOptions = OpenAIClientOptions & {
 export interface LLMConfigResult {
   llmConfig: ClientOptions;
   configOptions: OpenAIConfiguration;
+  tools?: BindToolsInput[];
 }
 
 /**

packages/data-provider/src/parameterSettings.ts

@@ -247,6 +247,19 @@ const openAIParams: Record<string, SettingDefinition> = {
     showDefault: false,
     columnSpan: 2,
   },
+  web_search: {
+    key: 'web_search',
+    label: 'com_ui_web_search',
+    labelCode: true,
+    description: 'com_endpoint_openai_use_web_search',
+    descriptionCode: true,
+    type: 'boolean',
+    default: false,
+    component: 'switch',
+    optionType: 'model',
+    showDefault: false,
+    columnSpan: 2,
+  },
   reasoning_summary: {
     key: 'reasoning_summary',
     label: 'com_endpoint_reasoning_summary',
@@ -596,6 +609,7 @@ const openAI: SettingsConfiguration = [
   baseDefinitions.stop,
   librechat.resendFiles,
   baseDefinitions.imageDetail,
+  openAIParams.web_search,
   openAIParams.reasoning_effort,
   openAIParams.useResponsesApi,
   openAIParams.reasoning_summary,
@@ -618,8 +632,9 @@ const openAICol2: SettingsConfiguration = [
   librechat.resendFiles,
   baseDefinitions.imageDetail,
   openAIParams.reasoning_effort,
-  openAIParams.useResponsesApi,
   openAIParams.reasoning_summary,
+  openAIParams.useResponsesApi,
+  openAIParams.web_search,
 ];
 
 const anthropicConfig: SettingsConfiguration = [

packages/data-provider/src/schemas.ts

@@ -634,6 +634,8 @@ export const tConversationSchema = z.object({
   reasoning_summary: eReasoningSummarySchema.optional().nullable(),
   /* OpenAI: use Responses API */
   useResponsesApi: z.boolean().optional(),
+  /* OpenAI: use Responses API with Web Search */
+  web_search: z.boolean().optional(),
   /* Google: use Search Grounding */
   grounding: z.boolean().optional(),
   /* assistant */
@@ -1071,6 +1073,7 @@ export const openAIBaseSchema = tConversationSchema.pick({
   reasoning_effort: true,
   reasoning_summary: true,
   useResponsesApi: true,
+  web_search: true,
 });
 
 export const openAISchema = openAIBaseSchema

packages/data-schemas/src/types/convo.ts

@@ -47,6 +47,7 @@ export interface IConversation extends Document {
   reasoning_effort?: string;
   reasoning_summary?: string;
   useResponsesApi?: boolean;
+  web_search?: boolean;
   grounding?: boolean;
   // Additional fields
   files?: string[];