Add a web search to an AI agent

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura
  • Add a web search to an AI agent in AI Agent Studio using a third-party search API such as Microsoft Bing or Google.

    Antes de Iniciar

    The agent must not be a voice agent. Voice agents do not support web searches.

    Nota:
    If you select Google as your web search tool provider, the web search tool leverages Grounding with Google Search, offered under a Global Standard deployment. Because grounding is not data resident, Google's global infrastructure routes traffic to a global data center for each web search request. This processing may be different than your data processing location chosen for your ServiceNow instance. Please consider your organization's data policies before adding a web search tool with Google as the provider.

    Role required: sn_aia.admin

    Procedimento

    1. Navigate to All > AI Agent Studio > Create and manage > AI agents.
    2. Open the AI agent that you want to add a web search to and navigate to the Add tools and information section.
    3. In the Add tool drop-down list, select Web search.
    4. On the form, fill in the fields.
      Tabela 1. Add a web search
      Fields Description
      Name

      Name that you want to specify for your web search.

      Resource Resource for the web search.
      Provider Third-party search API provider.
      Nota:
      You can configure the default provider for the Web Search API capability on the OneExtend Definition Config table [sys_one_extend_definition_config].
      Inputs Information for the search API to include in the web search. You can select value overrides or leave them blank for generative AI to fill in the details for you.
      • TopK: Number of tokens considered by the large language model (LLM).
      • Country: Country where results come from.
      • Max tokens: Maximum number of tokens to include in the response.
      • Number of results: Total number of results acquired.
      • Search query: Value to search for
      • Errors: JSON Object for error handling.
      • Search result type: Default value is searching_and_scraping and the other option is ai_answers
      • Sites or domains: Websites where you want to search.
      • TopP: Probability threshold for the dynamic number of tokens considered by the LLM.
      • Language: Language to use for user interface strings.
      • Temperature: Randomness of generated response. Higher numbers result in more randomness.
      Nota:
      If the agent uses multiple tools, you can choose to use another tool's output as an input value override. Select the data picker icon (Data picker icon.) to review the available options.
      Execution mode Mode of execution for your selected web search:
      • Supervised: Inputs from your human agent are required during the execution of this tool while the AI agent runs.
      • Autonomous: Doesn't require any input from your live agent during the execution of this tool while the AI agent runs.
      Display output Permission to display the output of the execution in the Now Assist panel or in Virtual Agent:
      • Yes
      • No
      Processing message Message to display to users when the tool is running.
      Output transformation strategy Style for the LLM to present the results as it passes information between tools and to other agents.
      • None
      • Concise
      • Paragraph
      • Verbose
      • Custom
    5. Select Add.
      A web search is added in the Web search list on the Add tools and information page.