As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Pesquisa na Web

O Web Search é uma ferramenta integrada que fornece recursos de pesquisa na web no Amazon Bedrock. Quando você o ativa, os modelos compatíveis podem recuperar as informações atuais da web durante uma solicitação e usá-las para fundamentar suas respostas, em vez de confiar apenas nos dados com os quais foram treinados. As respostas incluem citações às fontes usadas pelo modelo. O Web Search é hospedado e desenvolvido por AWS. A recuperação da web externa ocorre somente quando sua solicitação e suas permissões do IAM permitem.

Governança de dados

Para manter a recuperação dentro do AWS limite e, ao mesmo tempo, permitir o conteúdo da página em cache, defina como. external_web_access false A pesquisa é então fornecida pelo índice da web do Amazon Bedrock e o Fetch é servido pelo cache do Amazon Bedrock.

A AmazonBedrockFullAccess política concede Search and Fetch, mas nãobedrock-websearch:ExternalWebAccess. Como o external_web_access padrão étrue, omitir o parâmetro com essa política faz com que cada tentativa de busca falhe na verificação de autorização de back-end antes que o cache seja lido. A solicitação geral da API de respostas ainda pode ser concluída usando observações de pesquisa, mas o Fetch não contribui com o conteúdo da página. Definir explicitamente o parâmetro para false evitar essa falha e mantém a recuperação dentro do limite. AWS Dependendo do modelo que você está usando, seus dados estão sujeitos aos Detecção de abuso no Amazon Bedrock mecanismos automatizados.

Quando usar a Pesquisa na Web

A Pesquisa na Web é útil sempre que uma resposta depende de informações mais recentes, mais especializadas ou mais confiáveis do que o conhecimento paramétrico de um modelo. A recência é um caso comum: eventos atuais, lançamentos recentes de produtos, preços ou documentação de uma nova versão da biblioteca. É igualmente útil para questões especializadas ou de cauda longa em que o conhecimento do modelo é escasso ou impreciso, como APIs de nicho, valores de configuração específicos ou fatos específicos do domínio, e para casos em que você deseja uma fonte fundamentada e citável em vez de uma lembrança.

Como funciona a Pesquisa na Web

Como a ferramenta é executada dentro do Amazon Bedrock, você não precisa hospedar um índice de pesquisa, gerenciar rastreadores ou escrever o ciclo de chamada de ferramentas sozinho. Você adiciona a ferramenta à sua solicitação de inferência do Amazon Bedrock e o modelo a invoca conforme necessário. A Pesquisa na Web fornece informações atuais ao modelo, permitindo que o modelo retorne respostas fundamentadas com citações.

Quando a Pesquisa na Web está ativada, o modelo decide se uma solicitação precisa de informações atuais. Se isso acontecer, o modelo emite uma ou mais consultas de pesquisa para a ferramenta Web Search e recebe um conjunto de observações extraídas de um índice da web criado e mantido pela Amazon. Cada observação inclui um título, um URL de origem e um trecho de conteúdo. O modelo então compõe uma resposta com base nesses resultados e adiciona citações que apontam para as fontes.

Se o primeiro conjunto de resultados não for suficiente para responder à pergunta, o modelo poderá reformular sua consulta usando o que encontrou e pesquisar novamente no mesmo turno. Quando os resultados não suportam uma resposta, o modelo diz isso em vez de preencher a lacuna de seus dados de treinamento.

Operações de pesquisa e busca

A Pesquisa na Web é criada a partir de duas operações:

A pesquisa é sempre fornecida pelo índice da web Amazon Bedrock. O external_web_access parâmetro na API de respostas e a permissão do bedrock-websearch:ExternalWebAccess IAM determinam se o Fetch pode usar a web externa após uma falha de cache. Para obter detalhes, consulte Controle do acesso externo à web.

Modelos compatíveis

O Web Search está disponível para modelos OpenAI GPT servidos por meio do bedrock-mantle endpoint Amazon Bedrock, usando a API Responses. Nas regiões comerciais dos EUA, é suportado na GPT-5.6 família —openai.gpt-5.6-sol,openai.gpt-5.6-terra, e openai.gpt-5.6-luna —, bem como nas anteriores openai.gpt-5.4 openai.gpt-5.5 e. Na AWS GovCloud (EUA), ele é suportado em openai.gpt-5.6-terraopenai.gpt-5.6-luna, openai.gpt-5.4 e. Exemplos de uso deste guiaopenai.gpt-5.6-terra. Para saber os preços do Web Search, consulte a página de preços do Amazon Bedrock.

Disponibilidade regional

A Pesquisa na Web processa consultas na região. Veja a disponibilidade atual abaixo.

Estados Unidos

AWS GovCloud (EUA)

A Pesquisa na Web é estritamente regional. Cada região opera seu próprio nível de busca e busca, e consultas, buscas, dados de indexação e resultados não são roteados entre regiões. Uma consulta emitida em uma determinada região permanece dentro dos limites dessa região.

Ativar pesquisa na Web

Para usar a Pesquisa na Web, a identidade do IAM por trás da sua solicitação deve ter permissão para chamar as ações da Pesquisa na Web. Para obter as permissões necessárias e exemplos de políticas, consulte Gerenciamento de identidade e acesso para pesquisa na Web.

Defina seu ambiente

Defina o seguinte antes de executar os exemplos:

export OPENAI_API_KEY="your-amazon-bedrock-api-key"
export OPENAI_BASE_URL="https://bedrock-mantle.us-west-2.api.aws/openai/v1"

Adicionar a ferramenta de Pesquisa na Web a uma solicitação

Para ativar a Pesquisa na Web, adicione uma ferramenta do tipo web_search à tools matriz em sua solicitação. O modelo usa a ferramenta somente quando determina que a solicitação precisa de informações atuais. Para exemplos executáveis, consulte. Exemplos de código

Controle o tamanho do contexto de pesquisa

Use search_context_size para controlar a quantidade de contexto que cada chamada de pesquisa pode retornar ao modelo. Os valores compatíveis são:

Uma observação contém um título, URL e trecho de conteúdo. O orçamento é compartilhado quando uma chamada de pesquisa contém várias consultas e o serviço pode retornar menos observações do que o máximo. Configurações maiores podem aumentar os tokens de entrada do modelo e o custo de inferência associado. Esse parâmetro não limita quantas chamadas de pesquisa o modelo pode fazer.

tools=[{
    "type": "web_search",
    "search_context_size": "low",
    "external_web_access": False,
}]

Controle do acesso externo à web

A pesquisa é feita a partir do índice da web Amazon Bedrock. A possibilidade de o Fetch recuperar o conteúdo da página da web externa após uma perda de cache é governada por dois controles que funcionam juntos: o external_web_access parâmetro na API de respostas e a permissão do bedrock-websearch:ExternalWebAccess IAM.

O external_web_access parâmetro padrão étrue, correspondendo à API OpenAI Responses para que sua chamada não precise ser alterada. A AmazonBedrockFullAccess política concede as ações básicas de Pesquisa na Web — bedrock-websearch:InvokeSearch e bedrock-websearch:InvokeFetch — mas não concedebedrock-websearch:ExternalWebAccess. Como resultado, uma solicitação que sai true de uma identidade que não é mantida ExternalWebAccess falha external_web_access na verificação de autorização de back-end para cada tentativa de busca antes que o cache seja lido. A solicitação da API de respostas do chamador ainda pode retornar HTTP200: o modelo pode continuar usando observações de pesquisa e retornar url_citation anotações. Não é garantido que a resposta do modelo divulgue a falha na busca, e a presença de uma citação não significa que a página citada foi buscada. A InvokeFetch chamada negada fica visível CloudTrail quando o registro de eventos de dados do Web Search está ativado. Para obter detalhes, consulte Monitorar a pesquisa na Web.

Escolha uma das seguintes configurações para Fetch.

Mantenha as solicitações dentro do AWS fronteira

Coloque "external_web_access": false na ferramenta. Isso não exige ExternalWebAccess permissão, a recuperação é feita inteiramente a partir do índice e do cache da web do Amazon Bedrock, e seus dados de solicitação não saem do limite. AWS Por causa das AmazonBedrockFullAccess concessõesInvokeFetch, o Cached Fetch continua funcionando. Defina o parâmetro explicitamente; não confie em omitir a permissão e deixar o parâmetro como padrãotrue, pois essa configuração faz com que as tentativas de busca falhem.

response = client.responses.create(
    model="openai.gpt-5.6-terra",
    input="Summarize recent guidance on AWS Lambda cold starts.",
    tools=[{"type": "web_search", "external_web_access": False}],
)

curl "https://bedrock-mantle.us-west-2.api.aws/openai/v1/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai.gpt-5.6-terra",
    "input": "Summarize recent guidance on AWS Lambda cold starts.",
    "tools": [{"type": "web_search", "external_web_access": false}]
  }'

Habilitar acesso externo à web

Conceda bedrock-websearch:ExternalWebAccess à solicitação a identidade e external_web_access defina comotrue. O caminho de política gerenciada mais simples é anexar um ou outro. AmazonBedrockExternalWebSearchReadOnly AmazonBedrockExternalWebSearchFullAccess As versões atuais dessas políticas concedem as mesmas três ações de Pesquisa na Web nos mesmos recursos, portanto, qualquer uma das políticas permite a recuperação externa. Para obter detalhes, consulte Políticas gerenciadas.

Com essa configuração, a Pesquisa continua usando o índice da web Amazon Bedrock. O Fetch verifica primeiro o cache do Amazon Bedrock e recupera da web externa somente quando o conteúdo adequado da página não está no cache. Quando o Fetch chega à web externa, seus dados de solicitação podem sair do AWS limite. A recuperação externa tem efeito somente quando você concede a permissão e deixa o parâmetro ativado.

Usando a Pesquisa na Web com o Codex

O Codex, agente de codificação da OpenAI, se conecta ao Amazon Bedrock por meio do bedrock-mantle endpoint e pode usar a Pesquisa na Web em modelos compatíveis. A Pesquisa na Web está disponível no aplicativo de desktop Codex e na CLI versão 0.147.0 ou posterior.

O uso da Pesquisa na Web com o Codex não exige configuração adicional do IAM além das permissões padrão da Pesquisa na Web. A identidade do IAM por trás de sua chave de API deve ter permissão para chamar as ações de pesquisa na Web bedrock-websearch:InvokeSearch bedrock-websearch:InvokeFetch e. Essas ações são concedidas pela AmazonBedrockFullAccess política. Para obter as permissões necessárias e exemplos de políticas, consulte Gerenciamento de identidade e acesso para pesquisa na Web.

Nos modelos compatíveis do Amazon Bedrock, o Codex usa a pesquisa na Web somente de texto, retornando títulos, URLs e trechos de conteúdo do índice e cache da web do Amazon Bedrock. O Codex define external_web_access como false em cada solicitação, para que seus dados de solicitação permaneçam dentro do AWS limite. Para obter detalhes, consulte Controle do acesso externo à web.

Exemplos de código

API de respostas

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="openai.gpt-5.6-terra",
    input="What are the most significant AWS launches announced this month?",
    tools=[{"type": "web_search", "external_web_access": False}],
)

print(response.output_text)

A resposta inclui o texto da resposta fundamentada junto com url_citation anotações que apontam para as fontes:

{
  "content": [
    {
      "annotations": [
        {
          "end_index": 573,
          "start_index": 441,
          "title": "Upgrade Amazon EKS clusters with confidence using Kubernetes version rollbacks | AWS News Blog",
          "type": "url_citation",
          "url": "https://aws.amazon.com/blogs/aws/upgrade-amazon-eks-clusters-with-confidence-using-kubernetes-version-rollbacks/"
        },
        {
          "end_index": 1094,
          "start_index": 888,
          "title": "AWS Weekly Roundup: AWS Builder Center at 1 year, Network Scanning in Security Hub, Loom for AWS, and more (July 13, 2026) | AWS News Blog",
          "type": "url_citation",
          "url": "https://aws.amazon.com/blogs/aws/aws-weekly-roundup-aws-builder-center-at-one-year-network-scanning-in-security-hub-loom-for-aws-and-more-july-13-2026/"
        },
        {
          "end_index": 1837,
          "start_index": 1414,
          "title": "AWS Weekly Roundup: One-click Lambda setup prompt, OpenAI GPT-5.6 models on Bedrock, and more (July 20, 2026) | AWS News Blog",
          "type": "url_citation",
          "url": "https://aws.amazon.com/blogs/aws/aws-weekly-roundup-one-click-lambda-setup-prompt-openai-gpt-5-6-models-on-bedrock-and-more-july-20-2026/"
        }
      ],
      "logprobs": [],
      "text": "As of **July 30, 2026**, the most significant AWS launches this month:\n\n1. **Amazon EKS Kubernetes version rollbacks** — EKS now lets admins roll back a Kubernetes version upgrade within **seven days**, effectively adding an “undo” path for cluster upgrades and reducing upgrade risk for large or regulated Kubernetes fleets. It’s available at no additional cost in commercial Regions where EKS is available. ([aws.amazon.com](https://aws.amazon.com/blogs/aws/upgrade-amazon-eks-clusters-with-confidence-using-kubernetes-version-rollbacks/))\n\n2. **AWS Security Hub Network Scanning + Azure support** — Security Hub added active Network Scanning to find resources actually reachable from the public internet, and also expanded unified security management to **Microsoft Azure** resources, making this a notable multi-cloud security/posture-management move. ([aws.amazon.com](https://aws.amazon.com/blogs/aws/aws-weekly-roundup-aws-builder-center-at-one-year-network-scanning-in-security-hub-loom-for-aws-and-more-july-13-2026/))\n\n3. **New frontier models on Amazon Bedrock: Claude Sonnet 5, Claude Opus 5, and OpenAI GPT-5.6 models** — AWS added major new model choices to Bedrock this month: Anthropic’s Claude Sonnet 5 and Claude Opus 5, plus OpenAI GPT-5.6 Sol, Terra, and Luna, expanding Bedrock’s role as a multi-model enterprise AI platform. ([aws.amazon.com](https://aws.amazon.com/blogs/aws/aws-weekly-roundup-one-click-lambda-setup-prompt-openai-gpt-5-6-models-on-bedrock-and-more-july-20-2026/))",
      "type": "output_text"
    }
  ],
  "id": "msg_dcda8e4b477f5a1d96bfbcadefef7a77",
  "phase": "final_answer",
  "role": "assistant",
  "status": "completed",
  "type": "message"
}

Solicitação direta de HTTPS

Se você não estiver usando o SDK do OpenAI, envie a solicitação diretamente para o endpoint Responses. O tools campo carrega a ferramenta Web Search.

curl "https://bedrock-mantle.us-west-2.api.aws/openai/v1/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai.gpt-5.6-terra",
    "input": "What are the most significant AWS launches announced this month?",
    "tools": [{"type": "web_search", "external_web_access": false}]
  }'

Lendo citações da resposta

A Pesquisa na Web retorna citações como url_citation anotações anexadas ao texto. Cada anotação contém o título e o URL da fonte e a extensão de caracteres na resposta que ela suporta. Retenha-os e exiba-os para os usuários finais.

Uma citação pode ser baseada em uma observação de pesquisa mesmo quando o Fetch não recuperou a página inteira. Não use a presença de uma citação para determinar se o conteúdo veio do cache do Amazon Bedrock ou da web externa. Para auditar os resultados do Fetch e as fontes de recuperação, use o fetchedSources campo em. CloudTrail Para obter detalhes, consulte Monitorar a pesquisa na Web.

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="openai.gpt-5.6-terra",
    input="What are the most significant AWS launches announced this month?",
    tools=[{"type": "web_search", "external_web_access": False}],
)

# The grounded answer
print(response.output_text)

# The sources behind it
for item in response.output:
    if item.type == "message":
        for block in item.content:
            if block.type == "output_text":
                for ann in block.annotations:
                    if ann.type == "url_citation":
                        print(f"- {ann.title}: {ann.url}")

Se você estiver trabalhando com o JSON bruto (por exemplo, de uma chamada HTTPS direta), os mesmos dados residem emoutput[].content[].annotations[]:

jq '.output[] | select(.type=="message") | .content[]
      | select(.type=="output_text") | .annotations[]
      | select(.type=="url_citation") | {title, url, start_index, end_index}' response.json

Respostas de streaming

A API de respostas transmite a resposta à medida que ela é gerada. O texto chega como response.output_text.delta eventos e cada citação chega como um response.output_text.annotation.added evento à medida que o modelo fundamenta uma declaração.

from openai import OpenAI

client = OpenAI()

stream = client.responses.create(
    model="openai.gpt-5.6-terra",
    input="What are the most significant AWS launches announced this month?",
    tools=[{"type": "web_search", "external_web_access": False}],
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
    elif event.type == "response.output_text.annotation.added":
        ann = event.annotation
        print(f"\n[source] {ann['title']}: {ann['url']}")

Por fio, o evento de anotação tem a seguinte aparência:

event: response.output_text.annotation.added
data: {"type":"response.output_text.annotation.added","annotation":{"type":"url_citation","title":"News and Updates from the July 2025 Pokémon Presents","url":"https://www.pokemon.com/us/pokemon-news/...","start_index":589,"end_index":698},"annotation_index":2,"content_index":0,"item_id":"msg_...","output_index":1}

Segurança

A pesquisa na Web no Amazon Bedrock usa AWS Identity and Access Management (IAM) para controlar quem pode executar pesquisas e buscas e em quais regiões. O prefixo do serviço IAM para Pesquisa na Web ébedrock-websearch. Para ver a lista completa de ações, políticas gerenciadas, chaves de condição, exemplos de políticas e controles do administrador para desativar a Pesquisa na Web, consulte Gerenciamento de identidade e acesso para a Pesquisa na Web.

Monitoramento com CloudTrail

A pesquisa na Web no Amazon Bedrock está integrada com AWS CloudTrail. CloudTrail captura a atividade da API para pesquisa na Web como eventos de dados, para que você possa auditar quem invocou a ferramenta, quando e de onde. Para os campos capturados, como ativar o registro de eventos de dados e o que é intencionalmente excluído, consulte Monitorar a pesquisa na Web.

Uso aceitável

Se você usa a Pesquisa na Web no Amazon Bedrock, o Amazon Bedrock fornece resultados de pesquisa na Web (“Resultados da pesquisa”) para os modelos compatíveis, que o modelo pode usar para gerar sua resposta. Você é responsável pelo uso, e por qualquer uso por seus usuários finais, dos modelos de resultados que incorporem os resultados da pesquisa. Você deve reter e exibir as citações de origem e os links fornecidos nas saídas do modelo em qualquer saída exibida aos usuários finais. Você não pode usar a Pesquisa na Web para (a) extrair, armazenar ou reproduzir conteúdo dos Resultados da Pesquisa em massa, ou (b) criar ou preencher um índice ou banco de dados concorrente.