> ## 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. # Browser Use > Lass deinen Assistenten während eines Gesprächs erlaubte Websites verwenden. Browser Use ist in freigeschalteten Famulor-Workspace-Plänen verfügbar, auch im eigenen Workspace eines Whitelabel-Resellers. In Kunden-Workspaces von Resellern ist es noch nicht verfügbar. Die Verarbeitung muss auf **Global** stehen. 1. Öffne **Agent Tools → Agent Connectors** und wähle auf der Karte **Browser Use** die Option **Add**. Alternativ erstellst du ein **Built-in**-Tool und wählst **Browser Use**. 2. Trage eine HTTPS-**Start-URL** und die exakten **erlaubten Websites** ein, einschließlich Weiterleitungen und Seitenressourcen. 3. Beschreibe unter **Beschreibung (wann verwenden)**, wann der Assistent das Tool auswählen soll. 4. Hinterlege unter **Browser-Anweisungen** den Website-Ablauf, das erwartete Ergebnis und die Abbruchbedingungen. Diese Anweisungen werden jeder Browser-Aufgabe direkt mitgegeben. 5. Ergänze **Benötigte Angaben** mit eindeutiger Bezeichnung und optionalem Hinweis zur Frage. Fehlende Antworten fragt der Assistent ab, bevor der Browser startet oder Browser-Credits reserviert werden. Ergänze nur Angaben, die für jede Aufgabe benötigt werden. 6. Speichere das Tool und weise es dem Assistenten zu. Die Browser-Anweisungen müssen nicht zusätzlich in den Assistant-Prompt kopiert werden. 7. Starte Test Call oder Test Chat. Der Drawer öffnet sich automatisch, sobald eine Browser-Aufgabe startet. Über **Browser ansehen** kannst du ihn schließen und erneut öffnen. Öffentliche Demos bieten dieselbe Live-Ansicht. Für eine Terminsuche kann das Arztprofil die Startseite sein. Eine Browser-Anweisung wäre: „Lies verfügbare Daten und Uhrzeiten; stoppe vor der Auswahl oder Buchung eines Termins.“ Als benötigte Angabe eignet sich „Patientenkategorie“, mit dem Hinweis „Frage nach Neu- oder Bestandspatient.“ Die Antworten kommen aus dem Gespräch und sind keine festen Vorgaben. Die Beschreibung bestimmt den Einsatzzeitpunkt; die Browser-Anweisungen beschreiben den Ablauf. Telefon, Widget und Messaging behalten ihre bisherige Oberfläche. Das zugewiesene Tool arbeitet im Hintergrund. Die Ansicht erlaubt keine Steuerung. ### Videos und Credits In History erscheint **Browser-Aufzeichnung**, sobald ein Video verfügbar ist. Das Symbol öffnet einen WebM-Player im Modal. Jede Aufgabe hat ein eigenes Video. Videos bleiben privat und werden spätestens nach sieben Tagen oder früher gemäß der Aufbewahrung gelöscht. Das Löschen des gespeicherten Gesprächs entfernt auch die Videos. Ohne Aufbewahrung entsteht kein Video. Teilaufzeichnungen werden gekennzeichnet. Unter **Settings → Data Retention** gilt **Calls** für Telefonate, Test Call, Test Chat und Web-Widget-Chats. Messaging nutzt seine eigene Kategorie, etwa **WhatsApp** für Textgespräche. Browser-Videos folgen dieser Kategorie, höchstens sieben Tage. Abgelaufene Videos sind nicht mehr abrufbar. Das Löschen des gespeicherten Gesprächs oder Workspaces startet die physische Videolöschung; bei Speicherfehlern wird sie automatisch erneut versucht. Browser Use verbraucht eigene Workspace-Credits für Browserzeit einschließlich einer kurzen Leerlaufphase und Entscheidungsverarbeitung. Beim Start wird ein begrenztes Budget abgezogen. Nach dem Schließen der Sitzung und der Abrechnung werden ungenutzte Credits zurückgegeben. Das Schließen der Ansicht stoppt keine Aufgabe. Bitte den Assistenten, die Browser-Aufgabe abzubrechen. ### Unterstützte Aufgaben Das Tool klickt sichtbare Elemente, füllt normale Textfelder mit bekannten Angaben aus, scrollt und liest Seiten. Schritte und Laufzeit sind begrenzt. CAPTCHA, Zwei-Faktor-Anmeldung und Website-Sperren werden nicht umgangen. Passwortfelder, Datei-Uploads, komplexe Dropdowns und Popup-Abläufe sind nicht unterstützt. Bei Änderungen oder fehlenden Angaben muss der Assistent das Ergebnis vor einem erneuten Versuch prüfen. Eine Erfolgsmeldung ersetzt keine sichtbare Bestätigung auf der Website. ## Anwendungsbeispiele Nutze diese Beispiele als Konfigurationsvorlagen und teste den konkreten Website-Ablauf mit deinem Assistenten. Nicht alle Bedienelemente jeder Website werden unterstützt. Dynamische Kalender, Login-Pflichten oder komplexe Auswahlfelder können den Ablauf stoppen. Ein direktes Profil oder eine vorbereitete Ergebnisseite benötigt oft weniger Schritte als eine Suche auf der Startseite. | Anwendungsfall | Startseite | Benötigte Angaben | Browser-Anweisung und Ergebnis | | - | - | - | - | | Flugpreise vergleichen | [Google Flights](https://www.google.com/travel/flights) oder eine vorbereitete Flug-Ergebnisseite | Abflugort, Ziel, Hinflugdatum, einfach oder Hin/Rück, Reisende; Rückflugdatum bei Bedarf erfragen | Sichtbare Preise, Währung, Flugzeiten und Stopps nennen. Gepäck und Tarifbedingungen nur nennen, wenn sichtbar. Vor der Buchung stoppen. | | Hotels vergleichen | [Google Hotels](https://www.google.com/travel/hotels) oder die öffentliche Verfügbarkeitsseite eines Hotels | Ziel, Anreise, Abreise, Gäste und Zimmer | Sichtbare Preise vergleichen und zwischen Preis pro Nacht und Gesamtaufenthalt unterscheiden. Steuern und Stornobedingungen nur übernehmen, wenn sichtbar. Kein Zimmer reservieren. | | Termine prüfen | Direktes Profil einer Praxis oder eines Dienstleisters | Neu- oder Bestandskunde und Terminart | Verfügbarkeit öffnen, die Angaben anwenden und sichtbare Daten und Uhrzeiten nennen. Vor Auswahl oder Buchung eines Zeitfensters stoppen. | | Produktverfügbarkeit prüfen | Produktseite eines Shops | Produkt oder Variante, Größe/Farbe, gegebenenfalls Standort | Angezeigten Preis und Bestand der gewünschten Variante lesen. Nichts in den Warenkorb legen oder kaufen. | | Sendung verfolgen | Öffentliche Tracking-Seite eines Versanddienstes | Sendungsnummer | Angegebene Nummer eingeben und sichtbaren Status sowie voraussichtliches Lieferdatum zusammenfassen. Bei Login oder zusätzlich benötigten persönlichen Daten stoppen. | Beim Flug-Tool steht `https://www.google.com/travel/flights` unter **Start-URL** und `www.google.com` unter **Erlaubte Websites**. Ergänze weitere exakte Hosts nur für tatsächlich benötigte Weiterleitungen oder Ressourcen. Die Start-URL enthält die vollständige Adresse; erlaubte Websites sind Hostnamen ohne Pfade oder Platzhalter. Beispiel für **Beschreibung (wann verwenden)**: „Nutze das Tool, wenn der Kunde Flugpreise vergleichen möchte.“ Beispiel für **Browser-Anweisungen**: „Verwende die vom Kunden genannten Strecken, Daten und Reisenden. Nenne bis zu drei sichtbare Optionen mit Preis, Währung, Abflugzeit und Stopps. Erfinde keine fehlenden Preise oder Bedingungen. Stoppe vor Buchung, Zahlung oder Login. Melde, wenn nicht unterstützte Suchfelder den Vergleich verhindern.“ Markiere nur stets nötige Antworten als **Benötigte Angaben**; ein bedingtes Rückflugdatum gehört in den Fragehinweis. Preise und Verfügbarkeiten können sich nach der Abfrage ändern. ## API, MCP, CLI & SDK Erstelle und weise das Tool zu mit `POST /api/v1/tools` und `PUT /api/v1/assistants/{id}/tools`, oder MCP `create_tool` und `set_assistant_tools`. CLI: `famulor create-tool` und `famulor set-assistant-tools`. SDK: `client.api.createTool(...)` und `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}})` | Live-Tickets laufen nach 60 Sekunden ab. `viewer_origin` fordert eine schreibgeschützte WebSocket-URL für genau diesen Seitenursprung an. Downloads erfordern dieselben Workspace-Zugangsdaten und `calls:read`. MCP liefert einen authentifizierten Downloadpfad. API-Schlüssel bleiben auf deinem Server. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.