01 / System
Plugin, Bridge und vier Skills.
Stände der drei Bausteine, Aufbau des Arbeitsverzeichnisses, die Instruktionsdatei der drei CLIs und die vier Skills mit Bildpaaren.
Technische Dokumentation
Konfiguration und Referenz für SpatialAgents.
Dieser Einstieg bündelt Agentenprofile, lokale Verbindung, gemeinsamen Workspace, Artefakte und Fehlerhilfe. Der Schnellstart führt separat durch Installation und erste Nutzung; die Pluginseite erklärt die Systemarchitektur.
Installation und EinrichtungsassistentSechs Schritte vom Plugin-ZIP bis zur ersten sichtbaren QGIS-Aufgabe.
AgentenprofileProjektkonfiguration für Codex CLI, Claude Code und OpenCode.
Lokale VerbindungBridge, Token-Authentifizierung, Operationen und Freigaben.
Workspace und ArtefakteGemeinsame Dateien, Projektzustand, Screenshots und Ausgaben.
FehlerhilfeVerbindung, CLI, Projektpfade und Ergebnisprüfung systematisch kontrollieren.
Referenz
Drei Seiten für die Details.
Die Referenz beschreibt das System, seine QGIS-Seite und die Bibliothek aus dem Testaufbau der Benchmarks.
System öffnen
02 / QGIS-Plugin
Verbindung, neun Operationsgruppen, Freigaben.
Voraussetzungen, Port und Token, die 67 Werkzeuge nach Gruppen, Pfadregeln, Prüfsummen, asynchrone Aufträge und Dateitransfer.
03 / Geospatial API
Die Python-Bibliothek des Instituts.
Forschung des Instituts, nicht Teil der SpatialAgents: Objekte, Accessor-Muster, neun Datenquellen, dreizehn Algorithmenkategorien und Fehlermeldungen mit Korrekturhinweis.
Agentenprofile
Drei CLIs, ein gemeinsamer Fachkontext.
SpatialAgents unterstützen Linux; die Nutzung unter Windows ist experimentell. Die gewählte CLI muss vorab installiert und authentifiziert sein. Der Einrichtungsassistent ergänzt anschließend die Projektkonfiguration, gemeinsame Skills und den Zugang zum geöffneten QGIS-Projekt.
Codex CLI
Die projektlokale Konfiguration verbindet Codex mit der SpatialAgents-Bridge und den gemeinsamen Skills.
Offizielle Installation ↗Claude Code
Projektanweisungen, Skills und Bridge-Konfiguration stehen Claude Code im gemeinsamen Workspace zur Verfügung.
Offizielle Installation ↗OpenCode
Das Projektprofil stellt Skills und Bridge-Zugriff für die gewählte lokale oder containerbasierte Ausführungsumgebung bereit.
Offizielle Installation ↗Lokale Verbindung
Bridge, Authentifizierung und QGIS-Operationen.
Das gewählte Agentensystem startet die SpatialAgents-Bridge als lokalen Prozess und stellt sie den beteiligten Agenten bereit. Die Bridge verbindet sich token-authentifiziert mit dem QGIS-Plugin und übermittelt definierte Werkzeugaufrufe.
- Verbindung
- Die lokale WebSocket-Verbindung verbindet Bridge und laufende QGIS-Sitzung.
- Authentifizierung
- Ein Bearer-Token schützt die Kommunikation zwischen den beiden Komponenten.
- QGIS-Aktionen
- Das Plugin führt deklarierte Operationen für Projektzustand, Layer, Navigation, Gestaltung und Artefakte aus.
- Freigaben
- Verändernde Plugin-Aktionen werden in QGIS zur Bestätigung vorgelegt.
Workspace und Artefakte
Code, Geodaten und QGIS-Projekt am selben Ort.
Die Agenten und QGIS greifen auf dasselbe Projektverzeichnis zu. Dadurch bleiben erzeugte Daten, Skripte, Screenshots und Projektdateien direkt prüf- und weiterverwendbar.
- Projektkonfiguration
- Agentenprofile, Skills und Bridge-Einstellungen liegen projektbezogen im Workspace.
- Geodaten
- Raster, Vektordaten und Tabellen werden als reguläre Dateien erzeugt und in QGIS geladen.
- Rückfluss
- Layerinformationen, Projektzustand und Screenshots stehen den Agenten für weitere Prüfschritte zur Verfügung.
- Artefakte
- QGIS-Projekt, Karten, Diagramme und Berichte bleiben als nachvollziehbare Ergebnisse erhalten.
Fehlerhilfe
Vom Verbindungscheck zur sichtbaren Karte.
Prüfen Sie bei einem unerwarteten Ergebnis zuerst die aktive QGIS-Sitzung, dann Bridge und Token, anschließend Konfiguration des Agentensystems und Arbeitsverzeichnis und zuletzt Layer, Kartenausschnitt und erzeugte Dateien.
- QGIS-Sitzung prüfen.
Projekt öffnen, Plugin aktivieren und sicherstellen, dass die erwartete Sitzung läuft.
- Verbindung prüfen.
Bridge-Prozess, Token und die vom Plugin gemeldete Verbindung gemeinsam kontrollieren.
- Workspace prüfen.
Gewählte CLI im vorgesehenen Projektverzeichnis starten und Profil sowie verfügbare Skills kontrollieren.
- Ergebnis prüfen.
Layerbaum, Kartenausschnitt, Dateipfade und Screenshot erneut lesen, bevor die Aufgabe verfeinert wird.