---
schema_version: "1"
id: 58c84772ea9fa26874322d85e3cfbfcdc1be9c754cc962a703e2c033c650c79a
title: Agentforce Platform | Search the Web
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ai/264-0-0/copilot_actions_ref_search_the_web.md
canonical_url: https://help.salesforce.com/s/articleView?id=ai.copilot_actions_ref_search_the_web.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 79973751ae37132a53c42d7cd02185889984e4c11c9ee7f350abb2d21f2c5cc9
description: Retrieves real-time or external information that isn’t available in Salesforce CRM. Use it for questions about news, market trends, competitor details, and product comparisons, or when Salesforce answers need added context from the web.
products:
  - Agentforce
  - Cross Cloud
release: "264"
---
# Agentforce Platform | Search the Web

Retrieves real-time or external information that isn’t available in Salesforce CRM. Use it for questions about news, market trends, competitor details, and product comparisons, or when Salesforce answers need added context from the web.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions with Foundations, or <strong>Agentforce 1</strong> or <strong>Einstein 1</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
      <colgroup>
        <col style="width:50%">
        <col style="width:50%">
      </colgroup>
      <thead class="slds-text-title_caps ">
        <tr class="">
          <th scope="col" class="slds-cell-wrap" style="text-align:center;vertical-align:top;" id="d80175e77">User Permissions Needed</th>
          <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d80175e80">&nbsp;</th>
        </tr>
      </thead>
      <tbody>
        <tr class="">
          <td class="slds-cell-wrap" colspan="2" style="vertical-align:top;" headers="d80175e77 d80175e80 ">See <a href="https://help.salesforce.com/s/articleView?id=ai.agent_actions_common_perms.htm&amp;type=5&amp;language=en_US" target="_blank">Common User Access for Standard Agent
              Actions</a>.</td>

        </tr>
      </tbody>
    </table>

## Action Details

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <tbody>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">API Name</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">WebSearch</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Reference Action Type</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Standard Action</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Reference Action</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">
              <p>Search the Web</p>
              <p style="margin-bottom:0;">(webSearchStream)</p>
            </td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" style="vertical-align:top;">Does this action execute one or more prompt templates?</td>

            <td class="slds-cell-wrap" style="vertical-align:top;">Yes</td>

          </tr>
        </tbody>
      </table>

## Search the Web and Prompt Templates

This action is a standard invocable action that uses internal-only prompt templates to generate the final web search summary.

If admins want to change the output format (for example, bullet points instead of paragraphs), they can’t edit the internal prompt template directly. Instead, admins must either create a new version of the out-of-the-box General Web Search subagent with updated instructions or add new instructions to another subagent where the action is used.

## Guidelines and Considerations

- The Search the Web agent action isn’t supported in Government Cloud.
- Results are generated from external sources and displayed with citations.
- When adding the Search the Web action to an existing subagent, admins must fine-tune the instructions so the agent uses the correct prompt to initiate conversations.
- Performance may vary depending on the search provider.
- OpenAI requests through the Large Language Model Gateway (LLMG) are limited to 500 requests per minute per org. For more information, see [Large Language Model Limits](https://help.salesforce.com/s/articleView?id=ai.generative_ai_llm_limits.htm&release=264.0.0&type=5 "Understand limits for supported large language models (LLMs) from multiple providers for embedded features, such as Prompt Builder. Limits for each model include requests per minute and token limits.").
- The Search the Web action supports different search providers, such as OpenAI, BrightData, or You.com. See [Set the Search Provider for Search the Web Agent Action](https://help.salesforce.com/s/articleView?id=ai.copilot_set_search_provider_for_web_search_action.htm&release=264.0.0&type=5 "Improve the accuracy of web search responses by setting the search provider for the Search the Web agent action.").
- The Search Provider field doesn’t validate the entered value at configuration time. If you enter an unsupported or misspelled provider name, the error appears only during preview testing or live agent sessions. Enter a supported provider: OpenAI, BrightData, or You.com. Provider names aren’t case sensitive (for example, BrightData, brightdata, or BRIGHTDATA).
- BrightData has a default rate limit of 1000 queries per hour per org. This limit is configurable. To adjust it, contact Salesforce Support.
- To limit web search results to specific websites, use Allowed Domains or Excluded Domains. Use Allowed Domains when you want to restrict searches to a specific set of trusted sources. Use Excluded Domains when you want agents to search the open web but need to block specific sites. If you already use Allowed Domains on the Search the Web action, don’t also set Excluded Domains. Using both on the same action can return few or no results. Test the action before you add it to an agent in production. See [Customize Allowed Domains for the Search the Web Agent Action](https://help.salesforce.com/s/articleView?id=ai.copilot_customize_allowed_domains.htm&release=264.0.0&type=5 "Limit web search results to specified websites by defining allowed domains for the Search the Web agent action so your agents retrieve information from trusted sources.") and [Customize Excluded Domains for the Search the Web Agent Action](https://help.salesforce.com/s/articleView?id=ai.copilot_customize_excluded_domains.htm&release=264.0.0&type=5 "Limit web search results by excluding specific websites from the Search the Web agent action. Exclude the domains you don't want so your agents skip those sources and retrieve more relevant information.").
- Allowed and excluded domains apply to every search, regardless of the selected search provider.
- You can specify up to 10 allowed domains or 10 excluded domains per Search the Web action.
- The action accepts subdomains and full URLs, but uses only the base domain. Enter domains as a comma-separated list, without http://, https://, or www. The action also accepts domains with these prefixes, but they are not required.
- If you enter more than 10 allowed domains or more than 10 excluded domains, an invalid input error is returned.
- If some allowed domains are invalid, results are returned only from valid allowed domains. If none of the allowed domains are valid or reachable, the action returns no results. If some excluded domains are invalid, only valid excluded domains are filtered from results. If none of the excluded domains are valid or reachable, the action returns results normally without filtering.
- The Search the Web action can return "No search results found" when no web results match the query, including when Allowed Domains or Excluded Domains narrow the search.