Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Búsqueda en la web

La búsqueda web es una herramienta integrada que proporciona la capacidad de búsqueda web en Amazon Bedrock. Al habilitarla, los modelos compatibles pueden recuperar la información actual de la web durante una solicitud y utilizarla para fundamentar sus respuestas, en lugar de basarse únicamente en los datos con los que se han formado. Las respuestas incluyen citas a las fuentes utilizadas por el modelo. La búsqueda web está alojada y construida por AWS. La recuperación desde la web externa solo se produce cuando tanto su solicitud como sus permisos de IAM lo permiten.

Gobernanza de datos

Para mantener la recuperación dentro de los AWS límites y, al mismo tiempo, permitir el contenido de la página en caché, configúrelo en. external_web_access false A continuación, la búsqueda se publica desde el índice web de Amazon Bedrock y Fetch se publica desde la caché de Amazon Bedrock.

La AmazonBedrockFullAccess política permite buscar y recuperar, pero no. bedrock-websearch:ExternalWebAccess Si se omite el parámetro de external_web_access forma predeterminada en esta políticatrue, cada intento de recuperación no superará la verificación de autorización del backend antes de que se lea la caché. La solicitud general de la API de respuestas aún puede completarse con las observaciones de búsqueda, pero Fetch no aporta contenido a la página. Establecer el parámetro de forma explícita para false evitar este error y mantener la recuperación dentro de los AWS límites. Según el modelo que esté utilizando, sus datos están sujetos a los Detección de abusos de Amazon Bedrock mecanismos automatizados.

¿Cuándo usar la búsqueda en la web

La búsqueda en la web es útil cuando una respuesta depende de información más reciente, más especializada o más fidedigna que los conocimientos paramétricos de un modelo. La actualidad es un caso común: eventos actuales, lanzamientos recientes de productos, precios o documentación de una nueva versión de la biblioteca. Resulta igualmente útil para preguntas extensas o especializadas en las que el conocimiento del modelo es escaso o impreciso, como las API especializadas, los valores de configuración específicos o los datos específicos de un dominio, y para los casos en los que se prefiere una fuente citable y fundamentada en lugar de una recopilación.

Cómo funciona la búsqueda en la web

Como la herramienta se ejecuta dentro de Amazon Bedrock, no es necesario que aloje un índice de búsqueda, gestione los rastreadores ni cree usted mismo el bucle de llamada a la herramienta. Añada la herramienta a su solicitud de inferencia de Amazon Bedrock y el modelo la invoca según sea necesario. La búsqueda en la web proporciona información actualizada al modelo, lo que le permite devolver respuestas fundamentadas con citas.

Cuando la búsqueda en la web está habilitada, el modelo decide si una solicitud necesita información actualizada. Si es así, el modelo envía una o más consultas de búsqueda a la herramienta de búsqueda web y recibe un conjunto de observaciones extraídas de un índice web creado y mantenido por Amazon. Cada observación incluye un título, una URL de origen y un fragmento de contenido. Luego, el modelo redacta una respuesta basada en esos resultados y agrega citas que apuntan a las fuentes.

Si el primer conjunto de resultados no es suficiente para responder a la pregunta, el modelo puede reformular su consulta utilizando lo que encontró y volver a buscar en el mismo turno. Cuando los resultados no respaldan una respuesta, el modelo se lo indica en lugar de llenar el vacío entre sus datos de entrenamiento.

Operaciones de búsqueda y obtención

La búsqueda web se basa en dos operaciones:

La búsqueda siempre se realiza desde el índice web de Amazon Bedrock. El external_web_access parámetro de la API de respuestas y el permiso de bedrock-websearch:ExternalWebAccess IAM determinan si Fetch puede usar la web externa después de un error en la caché. Para obtener más información, consulte Controlar el acceso web externo.

Modelos compatibles

La búsqueda web está disponible para los modelos GPT de OpenAI servidos a través del bedrock-mantle punto final de Amazon Bedrock, mediante la API Responses. En las regiones comerciales de EE. UU., se admite tanto en las GPT-5.6 versiones familiares (openai.gpt-5.6-solopenai.gpt-5.6-terra, yopenai.gpt-5.6-luna) como en las anteriores y. openai.gpt-5.4 openai.gpt-5.5 En AWS GovCloud (EE. UU.), se admite en openai.gpt-5.6-terraopenai.gpt-5.6-luna, yopenai.gpt-5.4. Los ejemplos de uso de esta guíaopenai.gpt-5.6-terra. Para conocer los precios de la búsqueda en la web, consulte la página de precios de Amazon Bedrock.

Disponibilidad regional

La búsqueda en la web procesa las consultas dentro de la región. Consulta la disponibilidad actual a continuación.

Estados Unidos

AWS GovCloud (EE. UU.)

La búsqueda web es estrictamente regional. Cada región opera su propio nivel de búsqueda y obtención, y las consultas, las búsquedas, los datos de índice y los resultados no se distribuyen entre regiones. Una consulta emitida en una región determinada permanece dentro de los límites de esa región.

Habilitar la búsqueda en la web

Para usar la búsqueda en la web, la identidad de IAM detrás de la solicitud debe poder invocar las acciones de búsqueda en la web. Para ver los permisos necesarios y los ejemplos de políticas, consulte Administración de identidades y accesos para la búsqueda en la web.

Configure su entorno

Establezca lo siguiente antes de ejecutar los ejemplos:

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

Agregue la herramienta de búsqueda web a una solicitud

Para habilitar la búsqueda en la web, añada una herramienta de este tipo web_search a la tools matriz de su solicitud. El modelo usa la herramienta solo cuando determina que la solicitud necesita información actualizada. Para ver ejemplos ejecutables, consulte. Ejemplos de código

Controle el tamaño del contexto de búsqueda

search_context_sizeUtilícelo para controlar la cantidad de contexto que cada llamada de búsqueda puede devolver al modelo. Los valores admitidos son:

Una observación contiene un título, una URL y un fragmento de contenido. El presupuesto se comparte cuando una llamada de búsqueda contiene varias consultas, y el servicio puede arrojar menos observaciones que el máximo. Una configuración más grande puede aumentar los tokens de entrada del modelo y el costo de inferencia asociado. Este parámetro no limita el número de llamadas de búsqueda que puede realizar el modelo.

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

Controlar el acceso web externo

La búsqueda se realiza desde el índice web de Amazon Bedrock. La capacidad de Fetch para recuperar el contenido de una página web externa tras un error en la memoria caché depende de dos controles que funcionan en conjunto: el external_web_access parámetro de la API de respuestas y el permiso de bedrock-websearch:ExternalWebAccess IAM.

El external_web_access parámetro por defecto es: coincide con la API de respuestas de OpenAI para que la llamada no tenga que cambiar. true La AmazonBedrockFullAccess política otorga las acciones básicas de búsqueda en la web, bedrock-websearch:InvokeSearch ybedrock-websearch:InvokeFetch, pero no las otorga. bedrock-websearch:ExternalWebAccess Como resultado, una solicitud que sale external_web_access true de una identidad que no se conserva no ExternalWebAccess pasa la verificación de autorización del backend en cada intento de búsqueda antes de leer la caché. La solicitud de la API de respuestas de la persona que llama aún puede devolver HTTP200: el modelo puede seguir utilizando las observaciones de búsqueda y las anotaciones de retorno. url_citation No se garantiza que la respuesta del modelo revele el error de búsqueda, y la presencia de una cita no significa que se haya obtenido la página citada. La InvokeFetch llamada denegada es visible CloudTrail cuando el registro de eventos de datos de búsqueda web está activado. Para obtener más información, consulte Supervisar la búsqueda web.

Elija una de las siguientes configuraciones para Fetch.

Mantenga las solicitudes dentro del AWS límite

"external_web_access": falseColóquelo en la herramienta. Para ello no es necesario el ExternalWebAccess permiso, la recuperación se realiza en su totalidad desde el índice web y la caché de Amazon Bedrock, y los datos de su solicitud no superan los AWS límites. Gracias a AmazonBedrockFullAccess las subvencionesInvokeFetch, Cached Fetch sigue funcionando. Establezca el parámetro de forma explícita; no confíe en omitir el permiso y dejar el parámetro en su valor predeterminadotrue, ya que esa configuración hace que los intentos de recuperación fallen.

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}]
  }'

Habilita el acceso web externo

Otorgue bedrock-websearch:ExternalWebAccess la identidad de la solicitud y external_web_access configúrela entrue. La ruta más sencilla para administrar políticas es adjuntar oAmazonBedrockExternalWebSearchReadOnly. AmazonBedrockExternalWebSearchFullAccess Las versiones actuales de estas políticas permiten las mismas tres acciones de búsqueda web en los mismos recursos, por lo que cualquiera de las políticas permite la recuperación externa. Para obtener más información, consulte Políticas Políticas administradas administradas.

Con esta configuración, Search sigue utilizando el índice web de Amazon Bedrock. Fetch comprueba primero la caché de Amazon Bedrock y solo la recupera de la web externa cuando el contenido de la página adecuado no está en la caché. Cuando Fetch llegue a la web externa, es posible que los datos de su solicitud superen el límite. AWS La recuperación externa solo tiene efecto cuando concedes el permiso y dejas el parámetro activado.

Uso de la búsqueda web con Codex

Codex, el agente de codificación de OpenAI, se conecta a Amazon Bedrock a través del bedrock-mantle punto final y puede utilizar la búsqueda web en los modelos compatibles. La búsqueda web está disponible en la aplicación de escritorio de Codex y en la versión 0.147.0 o posterior de la CLI.

El uso de la búsqueda web con Codex no requiere una configuración de IAM adicional más allá de los permisos de búsqueda web estándar. La identidad de IAM detrás de su clave de API debe poder invocar las acciones de búsqueda web y. bedrock-websearch:InvokeSearch bedrock-websearch:InvokeFetch Estas acciones las otorga la AmazonBedrockFullAccess política. Para ver los permisos necesarios y los ejemplos de políticas, consulte Administración de identidades y accesos para la búsqueda web.

En los modelos de Amazon Bedrock compatibles, Codex utiliza una búsqueda web de solo texto, que devuelve títulos, URL y fragmentos de contenido del índice web y la caché de Amazon Bedrock. El Codex lo establece false en cada solicitud, external_web_access por lo que los datos de su solicitud se mantienen dentro de los límites. AWS Para obtener más información, consulte Controlar el acceso web externo.

Ejemplos de código

API de respuestas

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)

La respuesta incluye el texto de la respuesta fundamentada junto con url_citation anotaciones que apuntan a las fuentes:

{
  "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"
}

Solicitud HTTPS directa

Si no utilizas el SDK de OpenAI, envía la solicitud directamente al punto final de Responses. El tools campo contiene la herramienta de búsqueda web.

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}]
  }'

Leer las citas de la respuesta

La búsqueda en la web devuelve las citas como url_citation anotaciones adjuntas al texto. Cada anotación lleva el título y la URL de la fuente y el intervalo de caracteres de la respuesta que admite. Conserve estos datos y muéstrelos a los usuarios finales.

Una cita puede basarse en una observación de búsqueda incluso cuando Fetch no haya recuperado la página completa. No utilices la presencia de una cita para determinar si el contenido proviene de la caché de Amazon Bedrock o de una web externa. Para auditar los resultados de Fetch y las fuentes de recuperación, utiliza el campo enfetchedSources. CloudTrail Para obtener más información, consulte Supervisar la búsqueda 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}")

Si está trabajando con el JSON sin procesar (por ejemplo, desde una llamada HTTPS directa), los mismos datos se encuentran enoutput[].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

Respuestas de transmisión

La API de respuestas transmite la respuesta a medida que se genera. El texto llega como response.output_text.delta eventos y cada cita llega como un response.output_text.annotation.added evento, ya que el modelo basa una afirmación.

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 cable, el evento de anotación tiene este aspecto:

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}

Seguridad

Búsqueda web en Amazon Bedrock utiliza AWS Identity and Access Management (IAM) para controlar quién puede realizar búsquedas y búsquedas y en qué regiones. El prefijo del servicio de IAM para la búsqueda web es. bedrock-websearch Para ver la lista completa de acciones, políticas administradas, claves de condición, políticas de ejemplo y controles de administrador para deshabilitar la búsqueda en la web, consulte Administración de identidades y accesos para la búsqueda en la web.

Supervisión con CloudTrail

La búsqueda web en Amazon Bedrock está integrada con AWS CloudTrail. CloudTrail captura la actividad de la API para la búsqueda web como eventos de datos, de modo que puede auditar quién invocó la herramienta, cuándo y desde dónde. Para ver los campos capturados, cómo habilitar el registro de eventos de datos y qué se excluye intencionadamente, consulte Supervisar la búsqueda web.

Uso aceptable

Si utiliza la búsqueda web en Amazon Bedrock, Amazon Bedrock proporciona los resultados de la búsqueda web («resultados de búsqueda») a los modelos compatibles, que el modelo puede utilizar para generar su respuesta. Usted es responsable del uso que haga, y del uso que hagan los usuarios finales, de los resultados de los modelos que incorporen los resultados de la búsqueda. Debe conservar y mostrar las citas de las fuentes y los enlaces proporcionados en los resultados del modelo en cualquier resultado que muestre a los usuarios finales. No puedes usar la búsqueda web para (a) extraer, almacenar o reproducir contenido de los resultados de búsqueda de forma masiva, ni (b) crear o rellenar un índice o una base de datos de la competencia.