Bien démarrer

Guida est un système d’automatisation de navigateur Windows construit sur WebView2. Guida Complete est l’app desktop normale. Guida Node est un exécuteur distant headed pour l’automatisation du navigateur et de l’espace de travail. Les deux peuvent exposer Remote Ops, tandis que MCP reste la surface locale d’intégration des agents IA.

La plupart des utilisateurs n’ont pas besoin de toute la surface fonctionnelle dès le premier jour. Choisissez le parcours qui correspond à ce que vous voulez faire en premier.

Choisir votre parcours

Je veux automatiser manuellement des tâches du navigateur

Commencez ici si vous voulez cliquer, saisir du texte, naviguer, extraire du contenu et exécuter vous-même des scripts.

1. Installer Guida
2. Exécuter votre premier script
3. Essayer la recette Ouvrir une page et l’inspecter
4. Utiliser Tools > Developer > Generate Scripting Support Files… pour générer les complétions d’éditeur, les guides de langage et les fichiers de contexte pour LLM locaux

Je veux qu’un agent IA navigue sous supervision

Commencez ici si vous voulez que Claude Code, Claude Desktop ou un autre client MCP pilote Guida avec autorisations, contrôles de domaine et historique de traçabilité.

1. Lire Intégration MCP
2. Ouvrir un espace de travail afin que l’agent dispose de scripts et de configuration locaux au projet
3. Ajouter des outils personnalisés lorsque l’agent a besoin d’actions répétables propres à l’espace de travail
4. Lire Code source ouvert et code source fermé pour comprendre ce qui reste local, ce qui est tracé et ce que couvre la couche d’extraction fermée

Je veux extraire et stocker des données

Commencez ici si votre premier objectif est l’extraction, le stockage local ou le déplacement de données extraites vers des systèmes externes.

1. Exécuter le démarrage rapide pour apprendre la boucle de base d’un script
2. Essayer la recette Extraire et stocker les données d’une page
3. Lire Données et stockage pour g.store, g.queue, g.search, le stockage compatible S3, MongoDB, PostgreSQL et Elasticsearch
4. Utiliser les intégrations de bases de données lorsque vous avez besoin de bases externes ou de stockage objet

Je veux traiter des files d’attente et des processus de travail

Commencez ici si vous avez de nombreuses URL ou de nombreux enregistrements à traiter dans plusieurs onglets du navigateur.

1. Ouvrir un espace de travail afin que Guida puisse créer les bases des files d’attente et du stockage
2. Essayer la recette Mettre des URL en file d’attente et les traiter
3. Lire Processus de travail des files d’attente pour les pools déclaratifs et programmatiques
4. Essayer la recette Exécuter des processus de travail en parallèle

Je veux un nœud d’exécution distant

Commencez ici si vous voulez qu’une autre machine exécute l’automatisation headed du navigateur, les processus de travail d’espace de travail, les files et Remote Ops pendant que vous la contrôlez par un canal privé de confiance.

1. Installez Guida Node seulement si vous avez vraiment besoin d’exécution distante ; sinon installez Guida Complete
2. Lisez Installation pour choisir entre Guida Complete et Guida Node
3. Lisez API Remote Ops pour le plan de contrôle JSON-RPC sur canal de confiance
4. Utilisez Remote View lorsqu’un client doit diffuser ou contrôler un onglet de navigateur actif

Je veux utiliser des fonctions LLM locales

Commencez ici si vous voulez que les scripts classent, résument ou extraient des données avec un modèle local.

1. Configurer Configuration LLM avec Ollama ou LlamaSharp
2. Essayer la recette Interroger le LLM local
3. Lire IA, HTTP et outils pour g.llm.promptLocalLlm() et les assistants HTTP
4. Combiner les appels LLM avec les processus de travail des files d’attente pour la classification ou l’extraction par lot

Je veux comprendre la sécurité et les identifiants d’accès

Commencez ici si vous évaluez Guida pour des flux sensibles, des identifiants d’API ou une navigation assistée par IA.

1. Lire Intégration MCP pour la liste de domaines autorisés, l’autorisation des outils et la journalisation de traçabilité
2. Lire Identifiants d’accès pour les identifiants chiffrés avec DPAPI et les restrictions liées à l’origine MCP
3. Lire Code source ouvert et code source fermé pour savoir ce qui est fermé, ce qui est déjà public et ce qui sera ouvert une fois extrait et stabilisé
4. Lire Intégrations de bases de données si les scripts ont besoin d’identifiants de connexion pour PostgreSQL, MongoDB, le stockage compatible S3 ou Elasticsearch

Actions courantes pour commencer

Tâche	Commencer ici
Installer Guida	Installation
Choisir Complete ou Node	Installation
Exécuter votre premier script	Démarrage rapide
Ouvrir un espace de travail	Espaces de travail
Connecter un client MCP	Intégration MCP
Contrôler un nœud distant	API Remote Ops
Utiliser les identifiants d’accès en toute sécurité	Identifiants d’accès
Exécuter des processus de travail de file d’attente	Processus de travail des files d’attente
Stocker ou interroger des données extraites	Données et stockage
Capturer le trafic réseau	Recette Capturer le trafic réseau

Fonctionnement

Les scripts utilisent l’API g.* pour contrôler les onglets du navigateur, inspecter le DOM, stocker les données, exécuter des files d’attente, appeler des LLM locaux et s’intégrer aux services de l’espace de travail. Les méthodes JavaScript et Janet renvoient directement des valeurs et lèvent une erreur en cas d’échec. Lua utilise les retours multiples.

await g.nav.navigateToUrl("https://example.com");
await g.dom.waitForDomStable();

const html = await g.page.getDom();
g.store.put("pages", "example", { html });

Tout s’exécute sur votre machine. Les données de l’espace de travail restent dans son dossier, l’état de l’application reste sous votre profil utilisateur Windows, et Guida ne demande ni compte, ni télémétrie, ni synchronisation cloud.