# Laisser votre agent IA chercher sur le web

> Laissez votre agent intoCHAT chercher une réponse sur le web quand vos connaissances n'en ont pas : l'activer, la limiter à certains sites, ce que voient les visiteurs, coûts et limites.

Votre agent répond normalement à partir de vos connaissances, de vos instructions et de vos actions. Avec la recherche web activée, il peut aussi chercher une réponse sur le web quand vos connaissances ne répondent pas à la question. La réponse indique alors que l'information vient du web et renvoie vers les pages utilisées.

La recherche web est désactivée par défaut. Tant qu'elle l'est, l'agent ne cherche jamais sur le web.

## L'activer

1. Ouvrez votre agent et allez dans l'onglet **Setup**. La carte **Web search** se trouve sous les autres réglages de l'onglet.
2. Activez **Search the web**.
3. Facultatif : listez les sites dans lesquels il peut chercher sous **Only search these sites (optional)**. Voir ci-dessous.
4. Cliquez sur **Save web search**. La carte s'enregistre séparément : **Save changes**, dans l'en-tête, ne l'enregistre pas, et **Save web search** n'enregistre pas le reste de l'onglet.
5. Testez-la dans le **Playground** avec une question que vos connaissances ne couvrent pas. Le Playground utilise le réglage enregistré : enregistrez donc d'abord.

## La limiter à certains sites

Laissez **Only search these sites (optional)** vide pour chercher sur tout le web. Pour ne chercher que dans certains sites, comme la documentation de votre fournisseur ou un registre officiel, saisissez un site par ligne, jusqu'à 20.

- Saisissez des sites entiers, comme `example.com`. Les sous-domaines sont inclus : `example.com` couvre donc aussi `docs.example.com`.
- `https://` au début, un `/` à la fin et `*.` au début sont acceptés et retirés.
- Les chemins comme `example.com/blog`, les ports, les adresses IP et `localhost` ne sont pas acceptés. La carte affiche alors « Not a site name: » suivi de l'entrée, et **Save web search** reste grisé tant que vous ne l'avez pas corrigée.
- Les pages hors de la liste ne sont jamais liées sous une réponse, même si la recherche les a renvoyées.

Le champ est grisé tant que **Search the web** est désactivé.

## Quand l'agent effectue une recherche

- Uniquement quand vos connaissances ne répondent pas à la question du visiteur et que la question correspond à vos [instructions et garde-fous](/fr/docs/instructions). L'agent a pour consigne de ne jamais chercher pour des demandes hors sujet, pour ce que vos instructions ou vos garde-fous excluent, ni pour se renseigner sur des particuliers. Vos garde-fous s'appliquent aussi à ce qu'il trouve.
- Il privilégie vos connaissances chaque fois qu'elles couvrent la question. C'est le modèle d'IA qui décide quand chercher : il peut donc arriver qu'il cherche alors que vous ne l'auriez pas fait.
- Au plus une fois par réponse.
- L'agent rédige une courte requête de recherche. Il a pour consigne d'en exclure les données personnelles du visiteur, comme les noms, adresses e-mail, numéros de téléphone et numéros de commande. Seule la requête est recherchée, pas le message entier du visiteur.
- La recherche attend jusqu'à 15 secondes. Si elle prend plus de temps, échoue ou ne trouve rien d'utile, l'agent indique brièvement qu'il n'a pas pu trouver l'information et aide avec ce qu'il sait.

La recherche web fonctionne aussi dans les discussions temporaires.

## Ce que voient les visiteurs

La réponse indique que l'information vient du web et ne la présente pas comme celle de votre entreprise. Sous la réponse, une ligne qui commence par « Sur le web » renvoie vers 3 pages au maximum utilisées par la recherche. Chaque lien affiche le nom de la page et l'ouvre dans un nouvel onglet.

- Les liens proviennent des citations qu'OpenAI renvoie avec le résultat de la recherche. Le modèle d'IA qui rédige la réponse ne les choisit pas et ne les écrit pas.
- La ligne s'affiche quel que soit le réglage de **Show sources under replies** dans l'onglet [Appearance](/fr/docs/appearance). Quand cet interrupteur est activé, la ligne « Sources » pour vos propres pages s'affiche aussi.
- « Sur le web » suit **Widget language** : « From the web », « Aus dem Web », « Dal web » ou « De la web » dans les autres langues.
- Aucun lien n'apparaît sous une réponse qui affiche un [formulaire de chat](/fr/docs/chat-forms), confirme un [transfert par e-mail](/fr/docs/handoff), présente le [formulaire de leads](/fr/docs/lead-collection) ou n'a pas de texte.

Les résultats du web peuvent être faux ou dépassés, et intoCHAT ne contrôle pas les pages qu'une recherche trouve. Pour les informations qui doivent être exactes, comme les prix ou les conditions, ajoutez-les à vos connaissances, par exemple sous forme de [paire de questions-réponses](/fr/docs/text-and-qa).

## Dans vos transcriptions

Dans l'onglet **Conversations**, ouvrez **Why this answer** sous une réponse. Quand l'agent a effectué une recherche, **Actions called** indique « Web search » avec la requête entre guillemets, **Succeeded** ou **Failed**, et des liens vers les pages citées par la recherche, 5 au maximum. Consultez [Conversations et stats](/fr/docs/conversations-and-dashboard#why-this-answer).

## Coûts

- Les recherches passent par la recherche web d'OpenAI. intoCHAT envoie la requête à OpenAI, qui effectue la recherche et renvoie une courte réponse avec les pages qu'il a citées.
- Une recherche ne vous coûte pas de message supplémentaire. Chaque réponse compte comme un message, avec ou sans recherche. Consultez [Offres et limites](/fr/docs/plans-and-limits).
- Une réponse avec recherche prend plus de temps, car l'agent attend le résultat avant de répondre.

## Limites

- Une recherche par réponse, avec une attente de 15 secondes au plus.
- Jusqu'à 20 sites dans la liste, uniquement des sites entiers.
- Jusqu'à 3 liens sous une réponse.
- La recherche web n'est pas une action et ne compte pas dans la limite de 25 actions.
- Une [action côté client](/fr/docs/client-actions) activée nommée `search_web`, ou dont le nom le devient, comme « search web », désactive la recherche web tant qu'elle est activée, même avec l'interrupteur activé, car le gestionnaire de votre page est enregistré sous ce nom exact. La carte ne vous prévient pas : renommez ou désactivez cette action. Les [actions API](/fr/docs/api-actions) et les [boutons personnalisés](/fr/docs/custom-buttons) portant ce nom sont renommés en coulisses et ne gênent pas.
- Un [agent dupliqué](/fr/docs/quick-start) copie l'interrupteur et la liste des sites.

## Étapes suivantes

- Assurez-vous que l'agent trouve d'abord vos propres contenus : [Fonctionnement des réponses](/fr/docs/how-answers-work).
- Définissez ce qui entre dans le périmètre de l'agent : [Instructions](/fr/docs/instructions).
- Affichez aussi des liens vers vos propres pages : [Apparence](/fr/docs/appearance).
