Zum Inhalt springen

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.

Beginnen Sie hier, wenn Sie klicken, tippen, navigieren, Inhalte extrahieren und eigene Skripte ausführen möchten.

  1. Guida installieren
  2. Ihr erstes Skript ausführen
  3. Das Rezept Eine Seite öffnen und untersuchen ausprobieren
  4. 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.

  1. MCP-Integration lesen
  2. Einen Arbeitsbereich öffnen, damit der Agent projektlokale Skripte und Konfiguration nutzen kann
  3. Eigene Werkzeuge ergänzen, wenn der Agent wiederholbare arbeitsbereichsspezifische Aktionen ausführen soll
  4. Offener und geschlossener Quellcode lesen, um zu verstehen, was lokal bleibt, was protokolliert wird und welche Scraping-Schicht geschlossen bleibt

Beginnen Sie hier, wenn Ihr erstes Ziel Extraktion, lokale Speicherung oder die Weitergabe extrahierter Daten an externe Systeme ist.

  1. Den Schnellstart ausführen, um den Grundzyklus eines Skripts zu lernen
  2. Das Rezept Seitendaten extrahieren und speichern ausprobieren
  3. Daten und Speicher für g.store, g.queue, g.search, S3-kompatiblen Speicher, MongoDB, PostgreSQL und Elasticsearch lesen
  4. Datenbankintegrationen nutzen, wenn externe Datenbanken oder Objektspeicher erforderlich sind

Beginnen Sie hier, wenn viele URLs oder Datensätze über mehrere Browser-Tabs verarbeitet werden sollen.

  1. Einen Arbeitsbereich öffnen, damit Guida Warteschlangen- und Speicherdatenbanken anlegen kann
  2. Das Rezept URLs in eine Warteschlange stellen und verarbeiten ausprobieren
  3. Warteschlangen-Worker für deklarative und programmatische Worker-Pools lesen
  4. Das Rezept Parallele Worker ausführen ausprobieren

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.

  1. Installieren Sie Guida Node nur, wenn Sie gezielt Remote-Ausführung brauchen; andernfalls installieren Sie Guida Complete
  2. Lesen Sie Installation, um zwischen Guida Complete und Guida Node zu wählen
  3. Lesen Sie Remote Ops API zur JSON-RPC-Steuerungsebene über einen vertrauenswürdigen Kanal
  4. Nutzen Sie Remote View, wenn ein Client einen laufenden Browser-Tab streamen oder steuern muss

Beginnen Sie hier, wenn Skripte mit einem lokalen Modell klassifizieren, zusammenfassen oder Daten extrahieren sollen.

  1. LLM-Einrichtung mit Ollama oder LlamaSharp konfigurieren
  2. Das Rezept Das lokale LLM fragen ausprobieren
  3. KI, HTTP und Werkzeuge für g.llm.promptLocalLlm() und HTTP-Helfer lesen
  4. LLM-Aufrufe mit Warteschlangen-Workern für Batch-Klassifikation oder Extraktion kombinieren

Beginnen Sie hier, wenn Sie Guida für sensible Workflows, API-Zugangsdaten oder KI-gestützte Navigation bewerten.

  1. MCP-Integration für zugelassene Domains, Werkzeugfreigaben und Nachverfolgungsprotokoll lesen
  2. Zugangsdaten für DPAPI-verschlüsselte Zugangsdaten und MCP-Herkunftsbeschränkungen lesen
  3. Offener und geschlossener Quellcode lesen, um die Grenze zwischen öffentlicher Infrastruktur und geschlossener Produktschicht zu verstehen
  4. Datenbankintegrationen lesen, wenn Skripte Verbindungsdaten für PostgreSQL, MongoDB, S3-kompatiblen Speicher oder Elasticsearch benötigen
AufgabeEinstieg
Guida installierenInstallation
Complete oder Node wählenInstallation
Erstes Skript ausführenSchnellstart
Arbeitsbereich öffnenArbeitsbereiche
MCP-Client verbindenMCP-Integration
Remote-Knoten steuernRemote Ops API
Zugangsdaten sicher nutzenZugangsdaten
Warteschlangen-Worker ausführenWarteschlangen-Worker
Extrahierte Daten speichern oder abfragenDaten und Speicher
Netzwerkverkehr erfassenRezept: Netzwerkverkehr erfassen

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.