Erste Schritte
Guida ist ein Windows-Browserautomatisierungssystem auf Basis von WebView2. Guida Complete ist die normale Desktop-App. Guida Node ist ein headed Remote-Executor für Browser- und Arbeitsbereichsautomatisierung. Beide können Remote Ops bereitstellen, während MCP die lokale Integrationsfläche für KI-Agenten bleibt.
Die meisten Anwender brauchen am ersten Tag nicht die ganze Oberfläche. Wählen Sie den Einstieg, der zu Ihrem ersten Ziel passt.
Wählen Sie Ihren Einstieg
Abschnitt betitelt „Wählen Sie Ihren Einstieg“Ich möchte Browseraufgaben selbst automatisieren
Abschnitt betitelt „Ich möchte Browseraufgaben selbst automatisieren“Beginnen Sie hier, wenn Sie klicken, tippen, navigieren, Inhalte extrahieren und eigene Skripte ausführen möchten.
- Guida installieren
- Ihr erstes Skript ausführen
- Das Rezept Eine Seite öffnen und untersuchen ausprobieren
- Tools > Developer > Generate Scripting Support Files… nutzen, um Editor-Vervollständigung, Sprachleitfäden und lokale LLM-Kontextdateien zu erzeugen
Ich möchte, dass ein KI-Agent unter Aufsicht navigiert
Abschnitt betitelt „Ich möchte, dass ein KI-Agent unter Aufsicht navigiert“Beginnen Sie hier, wenn Claude Code, Claude Desktop oder ein anderer MCP-Client Guida mit Freigaben, Domainkontrollen und Nachverfolgungsprotokoll bedienen soll.
- MCP-Integration lesen
- Einen Arbeitsbereich öffnen, damit der Agent projektlokale Skripte und Konfiguration nutzen kann
- Eigene Werkzeuge ergänzen, wenn der Agent wiederholbare arbeitsbereichsspezifische Aktionen ausführen soll
- Offener und geschlossener Quellcode lesen, um zu verstehen, was lokal bleibt, was protokolliert wird und welche Scraping-Schicht geschlossen bleibt
Ich möchte Daten extrahieren und speichern
Abschnitt betitelt „Ich möchte Daten extrahieren und speichern“Beginnen Sie hier, wenn Ihr erstes Ziel Extraktion, lokale Speicherung oder die Weitergabe extrahierter Daten an externe Systeme ist.
- Den Schnellstart ausführen, um den Grundzyklus eines Skripts zu lernen
- Das Rezept Seitendaten extrahieren und speichern ausprobieren
- Daten und Speicher für
g.store,g.queue,g.search, S3-kompatiblen Speicher, MongoDB, PostgreSQL und Elasticsearch lesen - Datenbankintegrationen nutzen, wenn externe Datenbanken oder Objektspeicher erforderlich sind
Ich möchte Warteschlangen und Worker nutzen
Abschnitt betitelt „Ich möchte Warteschlangen und Worker nutzen“Beginnen Sie hier, wenn viele URLs oder Datensätze über mehrere Browser-Tabs verarbeitet werden sollen.
- Einen Arbeitsbereich öffnen, damit Guida Warteschlangen- und Speicherdatenbanken anlegen kann
- Das Rezept URLs in eine Warteschlange stellen und verarbeiten ausprobieren
- Warteschlangen-Worker für deklarative und programmatische Worker-Pools lesen
- Das Rezept Parallele Worker ausführen ausprobieren
Ich möchte einen Remote-Ausführungsknoten
Abschnitt betitelt „Ich möchte einen Remote-Ausführungsknoten“Beginnen Sie hier, wenn eine andere Maschine headed Browserautomatisierung, Arbeitsbereichs-Worker, Warteschlangen und Remote Ops ausführen soll, während Sie sie über einen vertrauenswürdigen privaten Kanal steuern.
- Installieren Sie Guida Node nur, wenn Sie gezielt Remote-Ausführung brauchen; andernfalls installieren Sie Guida Complete
- Lesen Sie Installation, um zwischen Guida Complete und Guida Node zu wählen
- Lesen Sie Remote Ops API zur JSON-RPC-Steuerungsebene über einen vertrauenswürdigen Kanal
- Nutzen Sie Remote View, wenn ein Client einen laufenden Browser-Tab streamen oder steuern muss
Ich möchte lokale LLM-Funktionen nutzen
Abschnitt betitelt „Ich möchte lokale LLM-Funktionen nutzen“Beginnen Sie hier, wenn Skripte mit einem lokalen Modell klassifizieren, zusammenfassen oder Daten extrahieren sollen.
- LLM-Einrichtung mit Ollama oder LlamaSharp konfigurieren
- Das Rezept Das lokale LLM fragen ausprobieren
- KI, HTTP und Werkzeuge für
g.llm.promptLocalLlm()und HTTP-Helfer lesen - LLM-Aufrufe mit Warteschlangen-Workern für Batch-Klassifikation oder Extraktion kombinieren
Ich möchte Sicherheit und Zugangsdaten verstehen
Abschnitt betitelt „Ich möchte Sicherheit und Zugangsdaten verstehen“Beginnen Sie hier, wenn Sie Guida für sensible Workflows, API-Zugangsdaten oder KI-gestützte Navigation bewerten.
- MCP-Integration für zugelassene Domains, Werkzeugfreigaben und Nachverfolgungsprotokoll lesen
- Zugangsdaten für DPAPI-verschlüsselte Zugangsdaten und MCP-Herkunftsbeschränkungen lesen
- Offener und geschlossener Quellcode lesen, um die Grenze zwischen öffentlicher Infrastruktur und geschlossener Produktschicht zu verstehen
- Datenbankintegrationen lesen, wenn Skripte Verbindungsdaten für PostgreSQL, MongoDB, S3-kompatiblen Speicher oder Elasticsearch benötigen
Häufige erste Aktionen
Abschnitt betitelt „Häufige erste Aktionen“| Aufgabe | Einstieg |
|---|---|
| Guida installieren | Installation |
| Complete oder Node wählen | Installation |
| Erstes Skript ausführen | Schnellstart |
| Arbeitsbereich öffnen | Arbeitsbereiche |
| MCP-Client verbinden | MCP-Integration |
| Remote-Knoten steuern | Remote Ops API |
| Zugangsdaten sicher nutzen | Zugangsdaten |
| Warteschlangen-Worker ausführen | Warteschlangen-Worker |
| Extrahierte Daten speichern oder abfragen | Daten und Speicher |
| Netzwerkverkehr erfassen | Rezept: Netzwerkverkehr erfassen |
Wie es funktioniert
Abschnitt betitelt „Wie es funktioniert“Skripte verwenden die g.*-API, um Browser-Tabs zu steuern, das DOM zu untersuchen, Daten zu speichern, Warteschlangen zu verarbeiten, lokale LLMs aufzurufen und Arbeitsbereichsdienste einzubinden. JavaScript- und Janet-Methoden geben Werte direkt zurück und werfen Fehler. Lua nutzt mehrere Rückgabewerte.
await g.nav.navigateToUrl("https://example.com");await g.dom.waitForDomStable();
const html = await g.page.getDom();g.store.put("pages", "example", { html });Alles läuft auf Ihrem Rechner. Arbeitsbereichsdaten bleiben im Arbeitsbereichsordner, Anwendungszustand bleibt im Windows-Benutzerprofil, und Guida benötigt weder Konto noch Telemetrie noch Cloud-Synchronisierung.