> ## Documentation Index > Fetch the complete documentation index at: https://docs.famulor.io/llms.txt > Use this file to discover all available pages before exploring further. # Utilisation du navigateur > Permettez à un assistant d’utiliser des sites autorisés pendant une conversation. Cette fonction est disponible avec les forfaits Famulor qui l’incluent, y compris dans l’espace propre d’un revendeur en marque blanche. Elle n’est pas encore disponible dans les espaces des clients de revendeurs. Le traitement de l’espace doit être **Global**. 1. Dans **Agent Tools → Agent Connectors**, sélectionnez **Add** sur la carte **Browser Use**. Vous pouvez aussi créer un outil **Built-in**, puis sélectionner **Browser Use**. 2. Indiquez une URL HTTPS de départ et les noms exacts des sites autorisés, y compris les redirections et ressources nécessaires. 3. Dans **Description (quand utiliser)**, indiquez quand l’assistant doit choisir cet outil. 4. Ajoutez les **Instructions du navigateur** : étapes du site, résultat attendu et conditions d’arrêt. Elles sont transmises directement à chaque tâche. 5. Ajoutez les **Informations requises**, avec un nom unique et des précisions facultatives. L’assistant demande les réponses manquantes avant de démarrer le navigateur ou de réserver des crédits. Ajoutez uniquement les informations nécessaires à chaque tâche. 6. Enregistrez l’outil et attribuez-le à l’assistant. Il n’est pas nécessaire de recopier les instructions du navigateur dans le prompt de l’assistant. 7. Lancez un Test Call ou Test Chat. Le panneau s’ouvre automatiquement au début d’une tâche de navigation. L’icône permet de le fermer et de le rouvrir. Les démonstrations publiques proposent la même vue en direct. Pour rechercher un rendez-vous, utilisez le profil du médecin comme page de départ. Exemple d’instruction : « Lire les dates et heures disponibles ; s’arrêter avant de sélectionner ou réserver un créneau. » Une information requise peut être « Catégorie de patient », avec la précision « Demander s’il s’agit d’un nouveau patient ou d’un patient déjà suivi ». Les réponses viennent de la conversation, sans valeurs inventées. La description indique quand utiliser l’outil ; les instructions expliquent comment exécuter la tâche. Les interfaces téléphone, widget et messagerie restent identiques. L’outil travaille en arrière-plan. La vue est en lecture seule. ### Vidéos et crédits L’icône d’enregistrement apparaît dans History lorsqu’une vidéo existe. Elle ouvre un lecteur WebM dans une fenêtre. Chaque tâche possède sa vidéo privée, conservée au maximum sept jours ou moins selon la politique de rétention. La suppression de la conversation stockée supprime les vidéos. Une rétention nulle désactive l’enregistrement. Les vidéos partielles sont signalées. Dans **Settings → Data Retention**, **Calls** couvre les appels, Test Call, Test Chat et le chat du widget web. La messagerie suit sa propre catégorie, par exemple **WhatsApp** pour les conversations textuelles. Les vidéos du navigateur suivent cette catégorie, dans la limite de sept jours. Les vidéos expirées deviennent inaccessibles. La suppression de la conversation stockée ou de l’espace déclenche leur suppression physique, avec de nouvelles tentatives en cas d’indisponibilité du stockage. Le temps de navigateur, y compris une courte période d’inactivité, et le traitement des décisions consomment des crédits séparés. Un budget limité est déduit au démarrage ; les crédits inutilisés sont remboursés après la fermeture de la session et son rapprochement. Fermer la vue n’arrête pas la tâche : demandez son annulation à l’assistant. ### Tâches prises en charge L’outil clique, remplit les champs de texte ordinaires avec des valeurs connues, fait défiler et lit les pages. La durée et le nombre d’étapes sont limités. Il ne contourne ni CAPTCHA, ni double authentification, ni restrictions des sites. Les mots de passe, téléversements, listes complexes et fenêtres surgissantes ne sont pas pris en charge. Vérifiez le résultat avant de relancer une action. Une tâche terminée ne remplace pas une confirmation visible sur le site. ## Exemples d’utilisation Utilisez ces exemples comme modèles de configuration et testez le parcours exact avec votre assistant. Ils ne garantissent pas la prise en charge de tous les sites. Les calendriers dynamiques, connexions obligatoires ou sélecteurs complexes peuvent bloquer la tâche. Un profil direct ou une page de résultats préparée demande souvent moins d’étapes qu’une recherche depuis l’accueil. | Cas d’usage | Page de départ | Informations requises | Instructions et résultat | | - | - | - | - | | Comparer les vols | [Google Flights](https://www.google.com/travel/flights) ou une page de résultats préparée | Aéroport de départ, destination, date de départ, aller simple ou retour, voyageurs ; demander la date de retour si nécessaire | Lire les tarifs visibles, devises, horaires et escales. Mentionner bagages et conditions uniquement s’ils sont affichés. S’arrêter avant de réserver. | | Comparer les hôtels | [Google Hotels](https://www.google.com/travel/hotels) ou la page publique des disponibilités d’un hôtel | Destination, arrivée, départ, voyageurs et chambres | Comparer les prix visibles en distinguant la nuit du séjour. Rapporter taxes et annulation uniquement si elles sont affichées. Ne pas réserver. | | Consulter des rendez-vous | Profil direct d’un cabinet ou prestataire | Nouveau client ou client existant et type de rendez-vous | Ouvrir les disponibilités et appliquer les préférences fournies. Lire les dates et heures visibles sans sélectionner ni réserver de créneau. | | Vérifier un produit | Fiche produit d’une boutique | Produit ou variante, taille/couleur, lieu si nécessaire | Lire le prix et le stock affichés pour la variante demandée. Ne rien ajouter au panier et ne rien acheter. | | Suivre un colis | Page publique de suivi d’un transporteur | Numéro de suivi | Saisir le numéro fourni et résumer le statut et la date de livraison estimée visibles. S’arrêter si une connexion ou des données personnelles supplémentaires sont nécessaires. | Pour les vols, saisissez `https://www.google.com/travel/flights` comme **URL de départ** et `www.google.com` dans **Sites autorisés**. Ajoutez d’autres hôtes exacts uniquement pour les redirections ou ressources nécessaires. L’URL de départ est une adresse complète ; les sites autorisés sont des noms d’hôtes sans chemin ni caractère générique. Exemple de **Description (quand utiliser)** : « Utiliser pour comparer les prix des vols demandés par le client. » Exemple d’**Instructions du navigateur** : « Utiliser le trajet, les dates et les voyageurs fournis. Retourner jusqu’à trois options visibles avec prix, devise, départ et escales. Ne pas inventer de prix ni de conditions. S’arrêter avant réservation, paiement ou connexion. Signaler si des contrôles de recherche non pris en charge empêchent la comparaison. » Seules les réponses toujours nécessaires doivent être des **Informations requises** ; une date de retour conditionnelle relève des précisions de question. Les prix et disponibilités peuvent changer après la consultation. ## API, MCP, CLI & SDK Créez et attribuez l’outil avec `POST /api/v1/tools` et `PUT /api/v1/assistants/{id}/tools`, ou MCP `create_tool` et `set_assistant_tools`. CLI: `famulor create-tool` et `famulor set-assistant-tools`. SDK: `client.api.createTool(...)` et `client.api.setAssistantTools(...)`. | API | MCP | CLI | SDK | | - | - | - | - | | `GET /api/v1/calls/{id}/browser-session` | `get_call_browser_session` | `famulor get-call-browser-session ` | `client.calls.browserSession(id)` | | `GET /api/v1/calls/{id}/browser-recordings` | `list_history_browser_recordings` | `famulor list-call-browser-recordings ` | `client.calls.browserRecordings(id)` | | `GET /api/v1/calls/{id}/browser-recordings/{recordingId}` | `get_history_browser_recording` | `famulor get-call-browser-recording --output-file browser.webm` | `client.calls.browserRecording(id, recordingId)` | | `GET /api/v1/history/messaging/{id}/browser-recordings` | `list_history_browser_recordings` (`kind: messaging`) | `famulor list-messaging-browser-recordings ` | `client.api.listMessagingBrowserRecordings({path:{id}})` | | `GET /api/v1/history/messaging/{id}/browser-recordings/{recordingId}` | `get_history_browser_recording` (`kind: messaging`) | `famulor get-messaging-browser-recording --output-file browser.webm` | `client.api.getMessagingBrowserRecording({path:{id,recordingId}})` | Les tickets expirent après 60 secondes. `viewer_origin` demande une URL WebSocket en lecture seule pour cette origine exacte. Les téléchargements exigent le même identifiant d’espace et la portée `calls:read`. MCP retourne un chemin de téléchargement authentifié. Gardez les clés API sur votre serveur. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.