Bing Search

The 'Title' is used to identify this Bing Search Reference in the user interface and by the AI Assistant. Choose a name that clearly describes the purpose or scope of the search resource, such as the intended audience, subject area, or any site restriction applied.

Usage

• Enter a concise, descriptive name to help users and the assistant distinguish this resource from others.
• The title appears in configuration screens and may be referenced in chat interactions.

Impact of Changes

• Changing the title updates how this resource is displayed and referenced throughout Grooper.

Example

• Bing News Search
• Microsoft Docs Search

Enter a valid Bing Search API key. This key is required to authenticate requests to the Bing search service and must be obtained from the Bing Search API provider.

Usage

• Obtain an API key from the Bing Search API provider (such as the Azure Portal).
• Enter the key exactly as provided; it is case-sensitive.

Impact of Changes

• If the API key is missing or invalid, all search requests will fail and validation errors will be logged.
• Changing the key may be necessary if the previous key expires or is rotated for security.

Example

• 1234567890abcdef1234567890abcdef

Specify a website domain to restrict all search results to that site. This is useful for focusing searches on authoritative or subject-specific sources.

Usage

• Enter a domain name (without https:// or www.) to limit results, e.g., microsoft.com.
• Leave blank to allow searches across the entire web.

Impact of Changes

• Setting this property narrows search results to the specified site, improving relevance for domain-specific queries.
• Removing the value broadens the search scope to all websites.

Example

• microsoft.com
• cdc.gov

Set the maximum number of seconds to wait for a response from Bing. If the service does not respond within this period, a timeout error will be raised.

Usage

• Enter a value between 1 and 300 seconds.
• Increase the timeout for slow connections or complex queries.

Impact of Changes

• Lower values may cause timeouts if the service is slow to respond.
• Higher values may delay error reporting if the service is unresponsive.

Example

• 10 (default)
• 30 (for slower or more complex searches)

If the search result includes HTML content, you can specify a CSS selector to identify the root element to be used when importing or processing the document. This allows the AI Assistant to focus on a specific part of the HTML response, such as the main content area.

Usage

• Enter a valid CSS selector to target the desired root element.
• Leave blank to use the entire HTML document as the root.

Impact of Changes

• Setting a selector will limit processing to the matched element and its children.
• An invalid selector may result in no content being imported.

Examples

• To use the main content area: div#main-content
• To select the body tag: body
• To select the main tag: main

The 'Resource Name' is shown in the user interface and is used to reference this resource in configuration and during chat interactions. If an 'Alias' is provided, it will be used as the display name; otherwise, the default 'Name' is used.

Provide a clear and concise explanation of what this resource is for, what information or capabilities it provides, and how it should be used in relation to other available resources. This description is used by the AI Assistant to determine when and how to utilize the resource during a conversation.

If two resources would otherwise have the same 'Resource Name', you can specify an 'Alias' to ensure each resource can be uniquely identified. The alias will be used as the display name in the user interface and in chat interactions.