Governança de dados Quando usar Como funciona a Pesquisa na Web Ativar pesquisa na Web Controle do acesso externo à web Exemplos de código Segurança Monitoramento com CloudTrail Uso aceitável

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. A Pesquisa na Web é hospedada e criada por AWS, e seus dados permanecem dentro dos AWS limites por padrão.

Governança de dados

Por padrão, ao usar a AmazonBedrockFullAccess política, a pesquisa na web é servida a partir do índice e cache da web do Amazon Bedrock, e seus dados de solicitação não saem do AWS limite para recuperação. Você também pode usar o IAM para aplicar isso no nível da política. 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 apoiam 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:

Pesquisa — Retorna títulos, URLs e trechos do índice da web e do gráfico de conhecimento do Amazon Bedrock para obter fatos de alta confiança.
Buscar — Recupera o conteúdo da página em cache para um URL específico do cache do Amazon Bedrock. Se o resultado não estiver disponível no cache, o modelo poderá optar por notificá-lo ou criar uma resposta com base nas melhores informações que possui.

Por padrão, ambas as operações são atendidas inteiramente de dentro dos limites do AWS serviço usando o índice e o cache da web do Amazon Bedrock, um instantâneo do conteúdo da web hospedado internamente AWS, em vez de buscá-lo na web ao vivo no momento da solicitação. O external_web_access parâmetro na API de respostas e a permissão do bedrock-websearch:ExternalWebAccess IAM determinam se a pesquisa e a busca podem acessar diretamente a web externa. 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. Atualmente, é suportado na GPT-5.6 família - openai.gpt-5.6-solopenai.gpt-5.6-terra,, e openai.gpt-5.6-luna -, bem como nas anteriores openai.gpt-5.4 openai.gpt-5.5 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.

nota

A Pesquisa na Web é uma ferramenta do lado do servidor, portanto, não está disponível quando você chama a API de respostas no endpoint. bedrock-runtime Para usá-lo, ligue para a API Responsesbedrock-mantle. Para as outras diferenças entre os dois endpoints, consulteUsando a API Responses no endpoint básico de tempo de execução.

Disponibilidade regional

A Pesquisa na Web processa consultas na região em três regiões dos EUA:

Região	Código da região
Leste dos EUA (Norte da Virgínia)	`us-east-1`
Leste dos EUA (Ohio)	`us-east-2`
Oeste dos EUA (Oregon)	`us-west-2`

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 do acesso externo à web

Por padrão, a pesquisa na Web é fornecida inteiramente pelo índice e cache da web do Amazon Bedrock, e nenhum dado de solicitação sai do AWS limite para recuperação. A possibilidade de a pesquisa e a busca chegarem à web externa é regida 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 external_web_access true de uma identidade que não é mantida ExternalWebAccess retorna a 403 AccessDenied na verificação de autorização. O modelo não falha na solicitação: ele baseia sua resposta em Search and Cached Fetch e relata que não conseguiu obter acesso externo à web.

Para fazer uma solicitação que não atinja esse erro, use uma das duas abordagens abaixo.

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 Como AmazonBedrockFullAccess não concedeExternalWebAccess, essa configuração é segura por padrão.


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 deixe external_web_access como padrãotrue. Essa configuração determina se a pesquisa e a busca podem alcançar a web externa. Atualmente, a recuperação é feita inteiramente pelo índice e cache da web do Amazon Bedrock, portanto, nenhum dado de solicitação sai do AWS limite, mesmo quando essa permissão é concedida. Em uma versão futura, essa configuração pode permitir que a pesquisa e a busca recuperem conteúdo da web externa ativa, momento em que os dados da solicitação podem deixar o AWS limite. O acesso externo à web é desativado por padrão (ou seja, não bedrock-websearch:ExternalWebAccess é permitido), e qualquer alteração futura exigirá a permissão bedrock-websearch:ExternalWebAccess como uma aceitação explícita antes de entrar em vigor. O acesso externo à web permanece sob seu controle: ele se aplica somente porque você concedeu a permissão e deixou o parâmetro ativado.

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.


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 administrativos 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 habilitar 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.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Uso da ferramenta Anthropic Claude

Projetos