Web Tools
Webseiten suchen, lesen und im Browser bedienen.
Auf dieser Seite
web_search
0,015 € pro SucheDas Web nach aktuellen Informationen durchsuchen
web_search gibt relevante Titel, URLs und Textausschnitte zurück. Ergebnisse lassen sich auf ein Land ausrichten und können aktuelle Nachrichtenartikel enthalten.
version: "1.0"
name: researcher
model: connic/gpt-5.6-sol
description: "Research agent with web search"
system_prompt: |
You are a research assistant with web search capabilities.
Search the web to find current information and cite sources.
tools:
- web_searchParameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| query | string | erforderlich | Suchanfrage |
| max_results | int | 5 | Anzahl der Ergebnisse, maximal 10 |
| country | string | None | Ländercode nach ISO 3166-1 Alpha-2, zum Beispiel DE, US oder FR |
| include_news | bool | false | Zusätzlich aktuelle Nachrichten durchsuchen und in die Ergebnisliste aufnehmen |
Rückgabewert
Gibt eine results-Liste zurück. Jedes Ergebnis enthält:
title: Seitentitelurl: Seiten-URLcontent: Ausschnitt des Seiteninhalts
web_read_page
0,015 € pro SeiteEine Seite abrufen und ihren Inhalt als Markdown zurückgeben
web_read_page ruft eine Webseite ab und wandelt ihren vollständigen Inhalt in bereinigtes Markdown um. Verwende es nach web_search, wenn der Agent mehr als einen Suchausschnitt benötigt.
Adressen unter x.com, twitter.com und ihren Subdomains werden nicht unterstützt. Diese Anfragen geben ein error-Feld zurück.
version: "1.0"
name: reader
model: connic/gemini-3.7-flash
description: "Agent that reads and summarizes web pages"
system_prompt: |
You can fetch web pages and summarize their content.
Use web_search to find pages, then web_read_page to read them.
tools:
- web_search
- web_read_pageParameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| url | string | erforderlich | URL der abzurufenden Seite |
| follow_redirects | boolean | true | Weiterleitungen folgen und die endgültige Seite lesen. Bei false gibt eine Weiterleitung einen Fehler und das Ziel in redirect_url zurück. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
markdown: konvertierter Seiteninhalturl: endgültig abgerufene URL nach Weiterleitungenerror: nur bei Timeout, Abruffehler, blockierter Weiterleitung oder nicht unterstützter URL enthaltenredirect_url: zurückgegebenes Ziel bei einer blockierten Weiterleitung
Browser-Tools
0,03 € pro MinuteBrowser-Tools halten eine Seite über mehrere Tool-Aufrufe offen. Mit web_browser_* werden alle Browser-Tools aktiviert. Der Agent ruft diese Tools bei Bedarf direkt auf. Jeder Run hat einen aktuellen Browser, den alle Browser-Tools automatisch verwenden. Die Beispiele unten zeigen die entsprechenden Python-Aufrufe.
version: "1.0"
name: browser-agent
model: connic/gpt-5.6-sol
session: true
description: "Agent that interacts with websites"
system_prompt: |
Open the requested website and inspect its available controls.
Use the browser tools to complete the requested task.
Close the browser when finished.
tools:
- web_browser_*Preise und Limits für gleichzeitig offene Browser pro Umgebung stehen auf der Preisseite.
Bei Fehlern geben Tools ein Dictionary mit error und gegebenenfalls error_code zurück. Bei outcome_unknown=true vor einer Wiederholung den aktuellen Seitenzustand prüfen.
Sitzungen und Seitenzustand
web_browser_open
Eine Browsersitzung öffnen
Eine öffentliche HTTP- oder HTTPS-URL im Browser des Runs öffnen. Ist bereits ein Browser geöffnet, wird Browser already open zurückgegeben; die aktuelle Seite bleibt unverändert. Für einen Seitenwechsel web_browser_act mit action="navigate" verwenden.
Mit session: true bleiben Browser-Cookies und Local Storage über Runs des Agenten hinweg erhalten. Bei konfigurierten Sessions ist session.browser standardmäßig true; mit false startet jeder Browser mit leerem Zustand. Bei aktivierter Browserspeicherung wird das Profil beim Schließen, auch am Ende des Runs, für dieselbe connic-Session gespeichert. Runs derselben Session können gleichzeitig einen Browser nutzen: Der erste speichert das Profil, alle weiteren öffnen es schreibgeschützt (profile_mode: read_only). Ihre Änderungen, auch neue Anmeldungen, werden nicht gespeichert. Browserzeit wird nur bei geöffnetem Browser abgerechnet.
from connic.tools import web_browser_open
await web_browser_open("https://example.com")Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| url | string | erforderlich | Öffentliche HTTP- oder HTTPS-URL, die geöffnet werden soll. |
| country | string | "EU" | Ländercode nach ISO 3166-1 Alpha-2, aus dem der Browser surft, zum Beispiel DE oder US, oder EU für einen Standort in der EU. Gilt beim Öffnen des Browsers. Lädt aus diesem Land keine Seite, öffnet der Browser neu aus der EU und danach ohne Standort. country im Ergebnis ist der verwendete Standort, ohne Standort null. |
| timezone | string | None | IANA-Zeitzone, die Seiten für Datum und Uhrzeit verwenden, zum Beispiel Europe/Berlin oder America/Chicago. Standardmäßig die Hauptzeitzone von country, für EU Europe/Berlin. Gilt für alle Seiten und Tabs, bis der Browser geschlossen wird. timezone im Ergebnis ist die verwendete Zeitzone, oder null, wenn sie nicht gesetzt werden konnte. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url, snapshot: Anfängliche Seiten-URL, Seitentext und Elementreferenzen beim Öffnen eines Browsers.message:Browser already open, wenn bereits ein Browser geöffnet ist.
web_browser_observe
Die aktuelle Seite lesen
Die Seite lesen und ihre Elementreferenzen aktualisieren. Für Interaktionen die Referenzen aus dem neuesten Snapshot verwenden. Snapshots werden nach 32.000 Zeichen abgeschnitten; lange Seiten daher auf interaktive Elemente oder einen Bereich eingrenzen.
from connic.tools import web_browser_observe
await web_browser_observe()Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| interactive_only | bool | False | Nur Schaltflächen, Links, Eingabefelder und andere Elemente aufnehmen, mit denen der Agent interagieren kann. |
| selector | string | None | None | CSS-Selektor wie main oder form, der den Snapshot auf einen Bereich begrenzt. |
| include_urls | bool | False | Die URL jedes Links aufnehmen. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.snapshot: Seitentext und aktuelle Elementreferenzen.
web_browser_read
Die aktuelle Seite als Markdown lesen
Die Seite so, wie sie im Browser des Runs dargestellt wird, in Markdown umwandeln, auch Inhalte hinter einem Login. Zum Lesen von Text verwenden; für Elementreferenzen web_browser_observe nutzen.
from connic.tools import web_browser_read
await web_browser_read()Parameter
Keine.
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.content: Seiteninhalt als Markdown.content_truncated: Falls vorhanden, war der Inhalt länger als 32.000 Zeichen und wurde gekürzt.
web_browser_close
Eine Browsersitzung schließen
Die Sitzung schließen, sobald die Aufgabe erledigt ist. Damit endet die Browsernutzung; heruntergeladene Dateien werden entfernt. Sitzungen schließen auch am Ende des Runs.
from connic.tools import web_browser_close
await web_browser_close()Parameter
Keine.
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:closed, wenn das Schließen bestätigt wurde.
Elemente und Tastatur
web_browser_act
Seitenelemente bedienen
Steuerelemente anklicken oder mit der Maus darüberfahren, Text eingeben, die Tastatur nutzen, navigieren oder auf die Seite warten. target ist eine Elementreferenz wie @e1 aus dem neuesten Snapshot, kein CSS-Selektor. Jede Aktion liefert den aktualisierten Seitenzustand.
from connic.tools import web_browser_act
await web_browser_act(
"fill", target="@e1", value="Berlin"
)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| action | string | erforderlich | Auszuführende Aktion. Die unterstützten Aktionen stehen in der Tabelle unten. |
| target | string | None | None | Elementreferenz. Für Elementaktionen wie click, hover, fill und check erforderlich; für Texteingabe und Tastaturaktionen optional. |
| value | string | None | None | Je nach action: Text, Option, Taste, Richtung, URL, Selektor oder Wartezeit. Wartezeiten als String angeben, zum Beispiel "1000". |
Unterstützte Aktionen
| action | target | value |
|---|---|---|
| click, double_click, hover | Erforderlich | Weglassen. |
| check, uncheck | Erforderlich | Weglassen. Das Ziel ist eine Checkbox oder ein Optionsfeld. |
| scroll_into_view | Erforderlich | Weglassen. |
| fill | Erforderlich | Text, der den Feldinhalt ersetzt. |
| select | Erforderlich | Wert der auszuwählenden Option. |
| type | Optional | Einzufügender, nicht leerer Text. Ohne target wird das fokussierte Feld verwendet. |
| press | Optional | Taste oder Tastenkombination, zum Beispiel Enter oder Control+A. |
| keydown, keyup | Optional | Einzelne Taste, zum Beispiel Shift. keydown hält sie bis zum Aufruf von keyup gedrückt. |
| scroll | Weglassen | up, down, left oder right. |
| navigate | Weglassen | Öffentliche HTTP- oder HTTPS-URL. |
| back, forward, reload | Weglassen | Weglassen. |
| wait | Weglassen | Millisekunden von 100 bis 10.000 als String, zum Beispiel "1000". |
| wait_for_text | Weglassen | Text, der auf der Seite erscheinen soll. |
| wait_for_url | Weglassen | URL oder Muster, zum Beispiel **/dashboard. |
| wait_for_selector | Weglassen | CSS-Selektor eines Elements, das erscheinen soll. |
| wait_for_network_idle | Weglassen | Weglassen. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.snapshot: Seitentext und aktuelle Elementreferenzen.
Ein error kann einen neuen Snapshot der blockierten Seite enthalten. action_completed=true bedeutet, dass die Aktion ausgeführt wurde, auch wenn das anschließende Lesen der Seite fehlgeschlagen ist. Die wait_for_*-Aktionen brechen nach 10 Sekunden ab und geben einen Fehler mit der aktuellen Seite zurück.
Screenshots und Maus
web_browser_screenshot
Den sichtbaren Browserbereich aufnehmen
Den sichtbaren Browserbereich als PNG aufnehmen, das das Modell sehen kann. Text- und Sprachmodelle müssen Bildeingaben unterstützen. Nach Scrollen oder Navigation einen neuen Screenshot aufnehmen.
from connic.tools import web_browser_screenshot
await web_browser_screenshot()Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| full_page | bool | False | Die gesamte scrollbare Seite statt des sichtbaren Bereichs aufnehmen. Ganzseitige Bilder eignen sich nicht für Mauskoordinaten, und sehr lange Seiten können das Bildlimit von 10 MB überschreiten. |
Rückgabewert
Gibt eine Liste mit einem Metadaten-Dictionary und einem PNG-Dateianhang zurück. Die Metadaten enthalten:
status: Status der Sitzung.width, height: Bildabmessungen in Pixeln.viewport_width, viewport_height: Abmessungen des sichtbaren Viewports in CSS-Pixeln.url, snapshot: Aktuelle Seiten-URL und Text-Snapshot, wenn das Lesen der Seite gelingt.
Für Mauseingaben die Bildkoordinaten mit round(image_x * viewport_width / width) und round(image_y * viewport_height / height) umrechnen. Bei einem fehlgeschlagenen Screenshot wird ein Fehler-Dictionary statt eines Anhangs zurückgegeben.
web_browser_mouse
Die Maus über Koordinaten steuern
Im sichtbaren Viewport bewegen, klicken, ziehen oder scrollen. Koordinaten werden in CSS-Pixeln ab der oberen linken Ecke angegeben. Bildkoordinaten mit den Abmessungen aus web_browser_screenshot umrechnen.
from connic.tools import web_browser_mouse
await web_browser_mouse(
"click", x=320, y=240
)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| action | string | erforderlich | move, click, double_click, down, up, drag oder scroll. |
| x | int | None | None | Horizontale CSS-Koordinate. Zusammen mit y angeben; außer bei down und up erforderlich. Ganzzahl von 0 bis 16.384 innerhalb des Viewports. |
| y | int | None | None | Vertikale CSS-Koordinate. Zusammen mit x angeben; es gelten derselbe Wertebereich und dieselben Bedingungen. |
| to_x | int | None | None | Horizontales Ziel für drag, von 0 bis 16.384. Für drag erforderlich, bei anderen Aktionen weglassen. |
| to_y | int | None | None | Vertikales Ziel für drag, von 0 bis 16.384. Für drag erforderlich, bei anderen Aktionen weglassen. |
| button | string | "left" | left, middle oder right für Klicks, down, up und drag. Bei move und scroll den Standardwert beibehalten. |
| delta_x | int | 0 | Horizontale Scrollstrecke, −10.000 bis 10.000 CSS-Pixel. Positive Werte scrollen nach rechts. Nur für scroll; mindestens ein Delta muss ungleich null sein. |
| delta_y | int | 0 | Vertikale Scrollstrecke, −10.000 bis 10.000 CSS-Pixel. Positive Werte scrollen nach unten. Nur für scroll. |
| modifiers | list[string] | None | None | Bis zu vier Einträge aus Alt, Control, Meta und Shift. Nur für click, double_click, drag oder scroll; gilt für diese Aktion. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.snapshot: Seitentext und aktuelle Elementreferenzen.
Das Ergebnis ist ein Text-Snapshot. Für das sichtbare Ergebnis web_browser_screenshot aufrufen.
Tabs und Dialoge
web_browser_tabs
Tabs und Popups verwalten
Tabs innerhalb derselben Browsersitzung auflisten, öffnen, wechseln oder schließen. Nach dem Öffnen eines Popups die Tabs auflisten, um seine ID zu finden. Beim Wechsel werden Seite und Elementreferenzen aktualisiert.
from connic.tools import web_browser_tabs
await web_browser_tabs(
"new", url="https://example.com"
)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| action | string | "list" | list, new, switch oder close. Bei list weder tab_id noch url angeben. |
| tab_id | string | None | None | ID aus der zurückgegebenen tabs-Liste. Für switch erforderlich. Bei close optional; ohne ID wird der aktive Tab geschlossen. Bei list und new weglassen. |
| url | string | None | None | Öffentliche HTTP- oder HTTPS-URL für new. Ohne URL wird ein leerer Tab geöffnet. Bei anderen Aktionen weglassen. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.snapshot: Seitentext und aktuelle Elementreferenzen.tabs: Liste der Tabs mit jeweilstab_id,title,urlundactive.
web_browser_dialog
JavaScript-Dialoge beantworten
Einen offenen Hinweis-, Bestätigungs- oder Eingabedialog bestätigen oder ablehnen. Wenn ein JavaScript-Dialog die Seite blockiert, enthalten Browserantworten die Dialogdetails.
from connic.tools import web_browser_dialog
await web_browser_dialog(
"accept", text="Report name"
)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| action | string | erforderlich | accept bestätigt den Dialog; dismiss lehnt ihn ab. |
| text | string | None | None | Optionale Antwort beim Bestätigen eines Eingabedialogs. Bei dismiss weglassen. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.snapshot: Seitentext und aktuelle Elementreferenzen.dialog: Falls verfügbar:pendingsowie die optionalen Feldertype,messageunddefaultfür einen verbleibenden Dialog.
JavaScript, Konsole und Netzwerk
web_browser_eval
JavaScript auf der Seite ausführen
Einen JavaScript-Ausdruck im aktiven Tab auswerten und seinen Wert zurückgeben. Promises werden abgewartet. Für return oder await den Code in (async () => { ... })() einschließen. Längere Skripte in den Projektdateien ablegen und mit script_path übergeben. Mit save_to wird das vollständige Ergebnis dort gespeichert statt zurückgegeben.
from connic.tools import web_browser_eval
await web_browser_eval(
"[...document.querySelectorAll('h2')].map(h => h.textContent.trim())"
)
await web_browser_eval(
script_path="scripts/collect-rows.js", save_to="exports/rows.json"
)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| script | string | None | JavaScript-Ausdruck mit bis zu 16.384 Zeichen. Zurückgegeben wird der Wert des letzten Ausdrucks. Genau eines von script oder script_path übergeben. |
| include_snapshot | bool | False | Wartet, bis sich die Seite beruhigt hat, und liefert zusätzlich einen aktuellen Snapshot. |
| script_path | string | None | Pfad einer JavaScript-Datei in den Projektdateien, bis zu 8 MiB, die wie script ausgewertet wird. |
| save_to | string | None | Pfad in den Projektdateien, unter dem das vollständige Ergebnis gespeichert wird, bis zu 100 MiB. Strings werden als Text gespeichert, andere Werte als JSON. Ein Pfad mit / am Ende ist ein Ordner und behält den Namen result.txt oder result.json. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.result: Wert des Ausdrucks als JSON. Einfache Daten wie Strings, Zahlen, Arrays oder Objekte zurückgeben, keine DOM-Knoten.result_truncated: Falls vorhanden, war das Ergebnis länger als 32.000 Zeichen und wurde gekürzt. Werte, die keine Strings sind, werden dann als JSON-Text zurückgegeben. Mitsave_tobleibt das ganze Ergebnis erhalten.saved_path, size: Pfad in den Projektdateien und Größe in Bytes, wennsave_togesetzt ist. Sie ersetzenresult.url: URL der aktuellen Seite.snapshot: Seitentext und aktuelle Elementreferenzen, nur mitinclude_snapshot.
Wirft das Skript einen Fehler, enthält error die Fehlermeldung und error_code ist script_error.
web_browser_console
Konsolenmeldungen und JavaScript-Fehler lesen
Die neuesten Konsolenmeldungen und nicht abgefangenen JavaScript-Fehler zurückgeben. Einträge sammeln sich, solange der Browser geöffnet ist; die neuesten stehen am Ende.
from connic.tools import web_browser_console
await web_browser_console()Parameter
Keine.
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.console_messages: Bis zu 50 Einträge mittype, etwalogodererror, undtext.page_errors: Bis zu 20 Einträge mittext,lineundcolumn.console_truncated: Falls vorhanden, wurden ältere Einträge oder lange Texte gekürzt.
web_browser_network
Anfragen aufzeichnen und ihre Antworten lesen
Die Anfragen der Seite aufzeichnen, etwa das JSON, das ihr eigenes Frontend lädt, und ihre Antworten lesen. Die Aufzeichnung starten, bevor die Seite die Daten lädt, zum Beispiel vor dem Navigieren oder Klicken. Die Aufzeichnung läuft über mehrere Tool-Aufrufe weiter, bis stop aufgerufen oder der Browser geschlossen wird.
Die Werte der Header Authorization, Cookie, Set-Cookie und Proxy-Authorization werden in allem, was das Tool zurückgibt oder speichert, durch [redacted] ersetzt, auch Cookies in HAR-Dateien. Anfrage- und Antwortinhalte werden nicht geschwärzt. Eigener Code, der selbst authentifizierte Anfragen senden muss, kann mit get den Parameter include_credentials=True übergeben und erhält diese Werte dann ungeschwärzt; das ist nicht mit save_to kombinierbar, und die Werte dürfen nie an das Modell zurückgegeben oder gespeichert werden.
from connic.tools import web_browser_network
await web_browser_network("start")
await web_browser_network("list", filter="/api/")
await web_browser_network(
"get", request_id=request_id, save_to="exports/"
)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| action | string | erforderlich | start beginnt die Aufzeichnung und verwirft frühere Anfragen. list gibt die aufgezeichneten Anfragen zurück. get gibt eine Anfrage mit ihrem Antwortinhalt zurück. stop beendet die Aufzeichnung. |
| filter | string | None | Teil der URL, auf den list eingeschränkt wird, etwa /api/. |
| request_id | string | None | Anfrage-ID aus list, erforderlich für get. |
| save_to | string | None | Mit get der Pfad in den Projektdateien für den vollständigen Antwortinhalt. Mit stop der Pfad, unter dem die Aufzeichnung als HAR-Datei gespeichert wird. Ein Pfad mit / am Ende ist ein Ordner und behält den Namen response.json (oder die passende Endung) bzw. network.har. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.recording:truenachstart,falsenachstop.requests: BeilistEinträge mitid,method,url,status,typeundsize(ausContent-Length, sofern der Server ihn sendet); die neuesten stehen am Ende.request_count: Anzahl der aufgezeichneten Anfragen, die zum Filter passen, bzw. nachstopdie Anzahl in der Aufzeichnung.requests_truncated: Falls vorhanden, werden nur die neuesten Anfragen aufgeführt, die in 32.000 Zeichen passen. Mitfiltereingrenzen.request: Beigetdie Anfrage mitmethod,url,status,mime_type,request_headers,response_headers,post_dataundbody. Inhalte über 32.000 Zeichen werden gekürzt und setzenbody_truncated.bodyistnull, wenn der Browser den Inhalt nicht mehr vorhält, etwa nach dem Verlassen der Seite, oder bei binären Antworten.saved_path, size: Pfad in den Projektdateien und Größe in Bytes, wennsave_togesetzt ist. War der Pfad belegt, bekommt die Datei einen nummerierten Namen.
Die HAR-Datei enthält Text-Antwortinhalte mit bis zu 2 MB pro Antwort, auch von Seiten, die der Browser inzwischen verlassen hat.
Downloads, PDFs und Uploads
web_browser_download
Eine Datei von der Seite herunterladen
Einen Link oder eine Schaltfläche anklicken, die einen Dateidownload startet. Mit include_content festlegen, ob der Agent die Datei als Anhang oder nur ihre ID und Metadaten erhält. Dateien bleiben bis zum Schließen in dieser Browsersitzung verfügbar; pro Datei sind bis zu 25 MiB erlaubt. Mit save_to wird die Datei zusätzlich in den Projektdateien gespeichert, dann sind bis zu 100 MiB möglich.
from connic.tools import web_browser_download
await web_browser_download(
target="@e1", include_content=True
)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| target | string | erforderlich | Elementreferenz wie @e1 aus dem neuesten Snapshot. Die Referenz des Download-Links oder der Schaltfläche verwenden. |
| include_content | bool | erforderlich | true übergibt die Datei als Anhang an den Agenten. false liefert nur ihre ID und Metadaten. Für dieses Flag gibt es keinen Standardwert. |
| save_to | string | None | Pfad in den Projektdateien für den Download. Ein Pfad mit / am Ende ist ein Ordner, der den Namen des Downloads behält. Dateien über 25 MiB werden ohne Anhang gespeichert. |
Rückgabewert
Bei include_content=false wird ein Metadaten-Dictionary zurückgegeben. Bei true wird eine Liste mit diesem Dictionary und einem Dateianhang zurückgegeben. Die Metadaten enthalten:
download_id: Datei-ID fürweb_browser_uploadin derselben Sitzung.name: Name der heruntergeladenen Datei.mime_type: Medientyp der Datei.size: Dateigröße in Bytes.saved_path: Pfad in den Projektdateien, wennsave_togesetzt ist. War der Pfad belegt, bekommt die Datei einen nummerierten Namen.status: Browserstatus.url, snapshot: Aktuelle Seiten-URL und Text-Snapshot, wenn das Lesen der Seite gelingt.
web_browser_pdf
Die aktuelle Seite als PDF speichern
Die aktuelle Seite als PDF mit bis zu 25 MiB drucken, mit save_to bis zu 100 MiB. Das PDF wird wie ein Download gespeichert, sodass seine ID bis zum Schließen der Browsersitzung mit web_browser_upload funktioniert.
from connic.tools import web_browser_pdf
await web_browser_pdf(include_content=True)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| include_content | bool | erforderlich | true hängt das PDF an, damit der Agent es lesen kann. false gibt nur seine ID und Metadaten zurück. |
| save_to | string | None | Pfad in den Projektdateien für das PDF. Ein Pfad mit / am Ende ist ein Ordner und behält den Namen page.pdf. |
Rückgabewert
Wie bei web_browser_download: ein Metadaten-Dictionary mit download_id, name und mime_type (application/pdf), bei include_content=true zusätzlich das PDF als Anhang.
web_browser_upload
Eine heruntergeladene oder gespeicherte Datei hochladen
Eine Datei in einem Upload-Feld auswählen: eine zuvor in dieser Browsersitzung heruntergeladene über ihre download_id oder eine aus den Projektdateien über ihren path, bis zu 100 MiB. Genau eines von beiden angeben; lokale Dateipfade des Deployments werden nicht akzeptiert. Falls die Seite es erfordert, das Formular anschließend separat absenden.
from connic.tools import web_browser_upload
await web_browser_upload(
target="@e2", download_id=download_id
)Parameter
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
| target | string | erforderlich | Referenz des Datei-Eingabefelds wie @e2 aus dem neuesten Snapshot. |
| download_id | string | None | Datei-ID aus web_browser_download oder web_browser_pdf in dieser Sitzung. |
| path | string | None | Pfad einer Datei in den Projektdateien. |
Rückgabewert
Gibt ein Dictionary mit folgenden Feldern zurück:
status:active, solange die Sitzung geöffnet ist.url: URL der aktuellen Seite.snapshot: Seitentext und aktuelle Elementreferenzen.download_id: ID der ausgewählten Datei.