Gobernanza de datos Cuándo se debe usar Cómo funciona la búsqueda en la web Habilitar la búsqueda en la web Controlar el acceso web externo Ejemplos de código Seguridad Monitorización con CloudTrail Uso aceptable

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 creada por él AWS, y sus datos permanecen dentro de los AWS límites de forma predeterminada.

Gobernanza de datos

De forma predeterminada, cuando se utiliza la AmazonBedrockFullAccess política, la búsqueda web se publica desde el índice web y la caché de Amazon Bedrock, y los datos de su solicitud no salen del AWS límite para su recuperación. También puede usar IAM para hacer cumplir esta política. Según el modelo que utilice, 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 en la web se basa en dos operaciones:

Búsqueda: devuelve títulos, URL y fragmentos del índice web y el gráfico de conocimientos de Amazon Bedrock para obtener datos de alta confianza.
Obtener: recupera el contenido de una página almacenada en caché para una URL específica de la caché de Amazon Bedrock. Si el resultado no está disponible en la caché, el modelo puede optar por notificárselo o crear una respuesta basada en la mejor información de la que disponga.

De forma predeterminada, ambas operaciones se realizan en su totalidad desde dentro del límite del AWS servicio mediante el índice web y la caché de Amazon Bedrock, una instantánea del contenido web alojado en el servidor AWS, en lugar de obtenerlo de la web activa en el momento de la solicitud. El external_web_access parámetro de la API de respuestas y el permiso de bedrock-websearch:ExternalWebAccess IAM determinan si la búsqueda y la búsqueda pueden llegar directamente a la web externa. 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. Actualmente es compatible con la GPT-5.6 familia (openai.gpt-5.6-sol, yopenai.gpt-5.6-luna)openai.gpt-5.6-terra, así como con la anterior y. openai.gpt-5.4 openai.gpt-5.5 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.

nota

La búsqueda web es una herramienta del lado del servidor, por lo que no está disponible cuando se llama a la API de respuestas en el punto final. bedrock-runtime Para usarla, activa la API de respuestas. bedrock-mantle Para conocer las demás diferencias entre los dos puntos finales, consulteUso de la API Responses en el punto final de Bedrock-Runtime.

Disponibilidad regional

La búsqueda web procesa las consultas dentro de una región en tres regiones de EE. UU.:

Region	Código de región
Este de EE. UU. (Norte de Virginia)	`us-east-1`
Este de EE. UU. (Ohio)	`us-east-2`
Oeste de EE. UU. (Oregón)	`us-west-2`

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 en la 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

Controlar el acceso web externo

De forma predeterminada, la búsqueda web se publica en su totalidad desde el índice web y la caché de Amazon Bedrock, y ningún dato de solicitud supera los AWS límites para su recuperación. La posibilidad de que la búsqueda y la búsqueda lleguen a la web externa depende de dos controles que funcionan en conjunto: el external_web_access parámetro de la API de respuestas y el bedrock-websearch:ExternalWebAccess permiso de 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 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 mantiene ExternalWebAccess devuelve una 403 AccessDenied verificación de autorización. El modelo no rechaza la solicitud: basa su respuesta en la búsqueda y la búsqueda en caché e informa de que no ha podido obtener acceso web externo.

Para realizar una solicitud que no arroje este error, utilice uno de los dos métodos siguientes.

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. Como AmazonBedrockFullAccess no se concedeExternalWebAccess, esta configuración es segura de forma predeterminada.


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

Habilite el acceso web externo

Otorgue la identidad bedrock-websearch:ExternalWebAccess a la solicitud y external_web_access déjela en su valor predeterminado detrue. Esta configuración determina si la búsqueda y la búsqueda pueden llegar a la web externa. En la actualidad, la recuperación se realiza íntegramente desde el índice web y la caché de Amazon Bedrock, por lo que ningún dato de solicitud supera los AWS límites aunque se conceda este permiso. En una versión futura, esta configuración puede permitir buscar y recuperar contenido de la web externa activa, momento en el que los datos de la solicitud pueden salir del límite. AWS El acceso web externo está deshabilitado de forma predeterminada (es decir, no bedrock-websearch:ExternalWebAccess está permitido) y cualquier cambio futuro requerirá que se autorice de bedrock-websearch:ExternalWebAccess forma explícita para que entre en vigor. El acceso web externo permanece bajo tu control: solo se aplica si has otorgado el permiso y has dejado el parámetro activado.

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

Lectura de 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.


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 trabajas 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.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Uso de la herramienta Anthropic Claude

Proyectos