Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Recherche sur le Web
Web Search est un outil intégré qui fournit des fonctionnalités de recherche sur le Web dans Amazon Bedrock. Lorsque vous l'activez, les modèles pris en charge peuvent récupérer des informations actuelles sur le Web lors d'une demande et les utiliser pour fonder leurs réponses, au lieu de se fier uniquement aux données sur lesquelles ils ont été formés. Les réponses incluent des citations des sources utilisées par le modèle. Web Search est hébergé et créé par AWS, et vos données restent dans les AWS limites par défaut.
## Gouvernance des données
Par défaut, lorsque vous utilisez cette [ AmazonBedrockFullAccess ](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockFullAccess) politique, Web Search est diffusé à partir de l'index Web et du cache Amazon Bedrock, et les données de votre demande ne quittent pas les AWS limites de récupération. Vous pouvez également utiliser IAM pour appliquer cela au niveau des politiques. Selon le modèle que vous utilisez, vos données sont soumises à des [Détection des abus sur Amazon Bedrock](abuse-detection.md) mécanismes automatisés.
## Quand utiliser la recherche sur le Web
La recherche sur le Web est utile chaque fois qu'une réponse dépend d'informations plus récentes, plus spécialisées ou plus fiables que les connaissances paramétriques d'un modèle. La récence est un cas courant : actualités, lancements récents de produits, prix ou documentation pour une nouvelle version de la bibliothèque. Il est également utile pour les questions de longue haleine ou spécialisées où les connaissances du modèle sont limitées ou imprécises, telles que les API de niche, les valeurs de configuration spécifiques ou les faits spécifiques à un domaine, et pour les cas où vous souhaitez une source fiable et citable plutôt qu'un souvenir.
## Comment fonctionne la recherche sur le Web
Comme l'outil s'exécute dans Amazon Bedrock, vous n'avez pas besoin d'héberger un index de recherche, de gérer des robots d'exploration ou de créer vous-même la boucle d'appel d'outils. Vous ajoutez l'outil à votre demande d'inférence Amazon Bedrock, et le modèle l'invoque selon les besoins. Web Search fournit des informations actuelles au modèle, ce qui permet au modèle de renvoyer des réponses fondées avec des citations.
Lorsque la recherche sur le Web est activée, le modèle décide si une demande nécessite des informations à jour. Si tel est le cas, le modèle envoie une ou plusieurs requêtes de recherche à l'outil de recherche Web et reçoit un ensemble d'observations tirées d'un index Web créé et géré par Amazon. Chaque observation comprend un titre, une URL source et un extrait de contenu. Le modèle compose ensuite une réponse basée sur ces résultats et ajoute des citations qui renvoient aux sources.
Si le premier ensemble de résultats n'est pas suffisant pour répondre à la question, le modèle peut reformuler sa requête en utilisant ce qu'il a trouvé et effectuer une nouvelle recherche au cours du même tour. Lorsque les résultats ne permettent pas de répondre à une question, le modèle vous l'indique plutôt que de combler les lacunes de ses données d'entraînement.
### Opérations de recherche et de récupération
Web Search est construit à partir de deux opérations :
+ **Recherche ** : renvoie des titres, des URL et des extraits de l'index Web et du graphe de connaissances d'Amazon Bedrock pour obtenir des informations fiables.
+ **Récupérer ** : extrait le contenu des pages mises en cache pour une URL spécifique à partir du cache Amazon Bedrock. Si le résultat n'est pas disponible dans le cache, le modèle peut choisir de vous en informer ou de créer une réponse basée sur les meilleures informations dont il dispose.
Par défaut, les deux opérations sont entièrement effectuées à l'intérieur des limites du AWS service à l'aide de l'index Web et du cache Amazon Bedrock, un instantané du contenu Web hébergé sur le site AWS, plutôt que d'être extrait depuis le Web en direct au moment de la demande. Le `external_web_access` paramètre de l'API Responses et l'autorisation `bedrock-websearch:ExternalWebAccess` IAM déterminent si la recherche et la récupération peuvent atteindre directement le Web externe. Pour en savoir plus, consultez [Contrôle de l'accès Web externe](#web-search-controlling-external).
### Modèles pris en charge
Web Search est disponible pour les modèles OpenAI GPT diffusés via le point de `bedrock-mantle` terminaison Amazon Bedrock, à l'aide de l'API Responses. Il est actuellement pris en charge sur la GPT-5.6 famille — `openai.gpt-5.6-sol``openai.gpt-5.6-terra`, et `openai.gpt-5.6-luna` — ainsi que sur le précédent `openai.gpt-5.4` et`openai.gpt-5.5`. Exemples d'utilisation de ce guide`openai.gpt-5.6-terra`. Pour connaître les tarifs de Web Search, consultez la page [ de tarification ](https://aws.amazon.com/bedrock/pricing/) d'Amazon Bedrock.
**Note**
Web Search est un outil côté serveur, il n'est donc pas disponible lorsque vous appelez l'API Responses sur le `bedrock-runtime` terminal. Pour l'utiliser, appelez l'API Responses sur`bedrock-mantle`. Pour les autres différences entre les deux paramètres, voir[Utilisation de l'API Responses sur le point de terminaison Bedrock-Runtime](bedrock-mantle.md#bedrock-mantle-responses-runtime).
### Disponibilité par région
Web Search traite les requêtes au sein de trois régions des États-Unis :
| **Région** | **Code de région ** |
| --- | --- |
| USA Est (Virginie du Nord) | us-east-1 |
| USA Est (Ohio) | us-east-2 |
| USA Ouest (Oregon) | us-west-2 |
La recherche sur le Web est strictement régionale. Chaque région gère son propre niveau de recherche et d'extraction, et les requêtes, les extractions, les données d'indexation et les résultats ne sont pas acheminés entre les régions. Une requête émise dans une région donnée reste dans les limites de cette région.
## Activer la recherche sur le Web
Pour utiliser la recherche sur le Web, l'identité IAM à l'origine de votre demande doit être autorisée à lancer les actions de recherche sur le Web. Pour obtenir les autorisations requises et des exemples de politiques, consultez la section Gestion des [ identités et des accès pour Web Search](security-web-search.md).
### Définissez votre environnement
Définissez les paramètres suivants avant d'exécuter les exemples :
```
export OPENAI_API_KEY="your-amazon-bedrock-api-key"
export OPENAI_BASE_URL="https://bedrock-mantle.us-west-2.api.aws/openai/v1"
```
### Ajouter l'outil de recherche sur le Web à une demande
Pour activer la recherche sur le Web, ajoutez un outil de type `web_search` au `tools` tableau de votre demande. Le modèle utilise l'outil uniquement lorsqu'il détermine que la demande nécessite des informations actuelles. Pour des exemples exécutables, consultez. [Exemples de code](#web-search-code-examples)
## Contrôle de l'accès Web externe
Par défaut, Web Search est entièrement diffusé à partir de l'index Web et du cache d'Amazon Bedrock, et aucune donnée de demande ne quitte la AWS limite pour être extraite. La question de savoir si la recherche et la récupération peuvent atteindre le Web externe dépend de deux contrôles qui fonctionnent ensemble : le `external_web_access` paramètre de l'API Responses et l'autorisation `bedrock-websearch:ExternalWebAccess` IAM.
Le `external_web_access` paramètre par défaut est`true`, correspondant à l'API OpenAI Responses afin que votre appel n'ait pas à être modifié. La [ AmazonBedrockFullAccess ](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockFullAccess) politique accorde les actions de base de recherche sur le Web — `bedrock-websearch:InvokeSearch` et `bedrock-websearch:InvokeFetch` — mais ne les accorde pas`bedrock-websearch:ExternalWebAccess`. Par conséquent, une demande qui laisse un `external_web_access` at `true` provenant d'une identité qui ne détient pas `ExternalWebAccess` renvoie un à `403 AccessDenied` la vérification d'autorisation. Le modèle n'échoue pas à la demande : il fonde sa réponse dans Search et met en cache Fetch et signale qu'il n'a pas pu obtenir d'accès Web externe.
Pour effectuer une demande qui ne génère pas cette erreur, utilisez l'une des deux approches ci-dessous.
### Conservez les demandes dans les AWS limite
Réglez `"external_web_access": false` sur l'outil. Cela ne nécessite pas d'`ExternalWebAccess`autorisation, la récupération est entièrement effectuée à partir de l'index Web et du cache d'Amazon Bedrock, et les données de votre demande ne quittent pas les AWS limites. Comme [ AmazonBedrockFullAccess ](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockFullAccess) elle n'autorise pas`ExternalWebAccess`, cette configuration est sécurisée par défaut.
```
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}]
}'
```
### Activer l'accès Web externe
`bedrock-websearch:ExternalWebAccess`Attribuez à la demande l'identité et laissez `external_web_access` la valeur par défaut`true`. Cette configuration détermine si la fonction de recherche et de récupération peut atteindre le Web externe. Aujourd'hui, la récupération est entièrement effectuée à partir de l'index Web et du cache d'Amazon Bedrock, de sorte qu'aucune donnée de demande ne quitte les AWS limites, même lorsque cette autorisation est accordée. Dans une prochaine version, cette configuration pourrait autoriser la recherche et la récupération pour récupérer du contenu à partir du Web externe en direct, auquel cas les données de demande peuvent quitter les AWS limites. L'accès Web externe est désactivé par défaut (c'est-à-dire qu'il `bedrock-websearch:ExternalWebAccess` est interdit), et toute modification future devra être autorisée en `bedrock-websearch:ExternalWebAccess` tant qu'opt-in explicite avant qu'elle ne prenne effet. L'accès Web externe reste sous votre contrôle : il ne s'applique que parce que vous avez accordé l'autorisation et laissé le paramètre activé.
## Exemples de code
### API de réponses
```
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 réponse inclut le texte de la réponse fondée ainsi que des `url_citation` annotations qui renvoient aux sources :
```
{
"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"
}
```
### Requête HTTPS directe
Si vous n'utilisez pas le SDK OpenAI, envoyez la demande directement au point de terminaison Responses. Le `tools` champ contient l'outil de recherche sur le 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}]
}'
```
### Lire les citations de la réponse
Web Search renvoie les citations sous forme d'`url_citation`annotations jointes au texte. Chaque annotation comporte le titre et l'URL de la source, ainsi que l'intervalle de caractères de la réponse qu'elle prend en charge. Conservez-les et affichez-les aux utilisateurs finaux.
```
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 vous travaillez avec le JSON brut (par exemple, à partir d'un appel HTTPS direct), les mêmes données se trouvent à l'adresse suivante `output[].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
```
### Réponses en streaming
L'API Responses diffuse la réponse au fur et à mesure qu'elle est générée. Le texte arrive en tant qu'`response.output_text.delta`événement, et chaque citation arrive en tant qu'`response.output_text.annotation.added`événement lorsque le modèle fonde une déclaration.
```
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']}")
```
Sur le câble, l'événement d'annotation ressemble à ceci :
```
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}
```
## Sécurité
Web Search sur Amazon Bedrock utilise Gestion des identités et des accès AWS (IAM) pour contrôler qui peut effectuer des recherches et des récupérations et dans quelles régions. Le préfixe du service IAM pour Web Search est. `bedrock-websearch` Pour obtenir la liste complète des actions, des politiques gérées, des clés de condition, des exemples de politiques et des contrôles administratifs permettant de désactiver Web Search, consultez la section Gestion des [ identités et des accès pour Web Search](security-web-search.md).
## Surveillance avec CloudTrail
La recherche Web sur Amazon Bedrock est intégrée à AWS CloudTrail. CloudTrail capture l'activité de l'API pour Web Search sous forme d'événements de données, afin que vous puissiez vérifier qui a appelé l'outil, quand et depuis où. Pour les champs capturés, comment activer la journalisation des événements de données et ce qui est intentionnellement exclu, voir [ Monitor Web Search](monitoring-web-search.md).
## Utilisation acceptable
Si vous utilisez la recherche Web sur Amazon Bedrock, Amazon Bedrock fournit des résultats de recherche Web (« Résultats de recherche ») aux modèles pris en charge, que le modèle peut utiliser pour générer sa réponse. Vous êtes responsable de votre utilisation, et de toute utilisation par vos utilisateurs finaux, des résultats des modèles qui intègrent les résultats de recherche. Vous devez conserver et afficher les citations des sources et les liens fournis dans les sorties du modèle dans toutes les sorties que vous présentez à vos utilisateurs finaux. Vous ne pouvez pas utiliser la recherche sur le Web pour (a) extraire, stocker ou reproduire du contenu des résultats de recherche en masse, ou (b) créer ou remplir un index ou une base de données concurrents.