webSearch method

LLMBuilder webSearch({
  1. int? maxUses,
  2. int? maxResults,
  3. List<String>? allowedDomains,
  4. List<String>? blockedDomains,
  5. WebSearchLocation? location,
  6. String? mode,
  7. String? fromDate,
  8. String? toDate,
})

Configures web search with detailed options

This method provides fine-grained control over web search behavior using a unified configuration that adapts to each provider's API.

Example:

final provider = await ai()
    .anthropic()
    .apiKey(apiKey)
    .webSearch(
      maxUses: 3,
      allowedDomains: ['wikipedia.org', 'github.com'],
      location: WebSearchLocation.sanFrancisco(),
    )
    .build();

Implementation

LLMBuilder webSearch({
  int? maxUses,
  int? maxResults,
  List<String>? allowedDomains,
  List<String>? blockedDomains,
  WebSearchLocation? location,
  String? mode,
  String? fromDate,
  String? toDate,
}) {
  final config = WebSearchConfig(
    maxUses: maxUses,
    maxResults: maxResults,
    allowedDomains: allowedDomains,
    blockedDomains: blockedDomains,
    location: location,
    mode: mode,
    fromDate: fromDate,
    toDate: toDate,
  );
  return extension('webSearchConfig', config);
}