Guida introduttiva

Guida è un sistema di automazione browser per Windows basato su WebView2. Guida Complete è la normale app desktop. Guida Node è un executor remoto headed per automazione browser e dello spazio di lavoro. Entrambi possono esporre Remote Ops, mentre MCP resta la superficie locale per l’integrazione con agenti IA.

La maggior parte degli utenti non ha bisogno di tutte le funzionalità del prodotto fin dal primo giorno. Scegli il percorso che corrisponde a ciò che vuoi fare per primo.

Scegli il tuo percorso

Voglio automatizzare attività del browser

Inizia qui se vuoi cliccare, digitare, navigare, estrarre contenuti ed eseguire script in autonomia.

1. Installa Guida
2. Esegui il tuo primo script
3. Prova la soluzione per aprire una pagina e ispezionarla
4. Usa Strumenti > Sviluppatore > Genera file di supporto allo scripting… (Tools > Developer > Generate Scripting Support Files...) per generare completamenti automatici per l’editor, guide di linguaggio e file di contesto per LLM locali

Voglio che un agente IA navighi sotto supervisione

Inizia qui se vuoi che Claude Code, Codex, Gemini o un altro client MCP usi Guida con autorizzazioni, controlli di accesso ai domini e registro di tracciabilità.

1. Leggi Integrazione MCP
2. Apri uno spazio di lavoro così l’agente può usare script e configurazione locali al progetto
3. Aggiungi strumenti personalizzati quando l’agente ha bisogno di azioni ripetibili specifiche dello spazio di lavoro
4. Rivedi Codice aperto e codice chiuso per capire cosa resta locale, cosa viene registrato nel registro di tracciabilità e quali parti dell’estrazione dati rimangono proprietarie

Voglio estrarre e salvare dati

Inizia qui se il tuo primo obiettivo è estrarre dati, salvarli in locale o spostarli verso sistemi esterni.

1. Esegui l’Avvio rapido per imparare il ciclo base di uno script
2. Prova la soluzione per estrarre e salvare i dati di una pagina
3. Leggi Dati e archiviazione per g.store, g.queue, g.search, archiviazione compatibile con S3, MongoDB, PostgreSQL ed Elasticsearch
4. Usa Integrazioni database quando ti servono database esterni o semplice archiviazione a oggetti

Voglio elaborare code e processi di lavoro

Inizia qui se hai molti URL o record da elaborare su più schede del browser.

1. Apri uno spazio di lavoro così Guida può creare database per le code e lo spazio di archiviazione
2. Prova la soluzione per mettere URL in coda ed elaborarli
3. Leggi Processi di lavoro delle code per pool di processi di lavoro dichiarativi e programmatici
4. Prova la soluzione per eseguire processi di lavoro in parallelo

Voglio un nodo di esecuzione remoto

Inizia qui se vuoi che un’altra macchina esegua automazione browser headed, processi di lavoro dello spazio di lavoro, code e Remote Ops, mentre la controlli tramite un canale privato fidato.

1. Installa Guida Node solo se ti serve davvero esecuzione remota; altrimenti installa Guida Complete
2. Leggi Installazione per scegliere se installare Guida Complete o Guida Node
3. Leggi Remote Ops API per il piano di controllo JSON-RPC su canale fidato
4. Usa Remote View quando un client deve trasmettere o controllare una scheda browser live

Voglio usare funzionalità LLM locali

Inizia qui se vuoi che gli script classifichino, riassumano o estraggano dati con un modello locale.

1. Configura LLM locali con Ollama o LlamaSharp
2. Prova la soluzione per chiedere direttamente all’IA locale
3. Leggi IA, HTTP e strumenti per g.llm.promptLocalLlm() e le funzioni di supporto HTTP
4. Combina chiamate LLM con processi di lavoro delle code per classificazione o estrazione in blocco

Voglio capire sicurezza e credenziali di accesso

Inizia qui se stai valutando Guida per flussi di lavoro sensibili, credenziali API o navigazione assistita dall’IA.

1. Leggi Integrazione MCP per elenchi di domini autorizzati, autorizzazione degli strumenti e registro di tracciabilità
2. Leggi Credenziali di accesso per credenziali cifrate con DPAPI e restrizioni sugli script di origine MCP
3. Leggi Codice aperto e codice chiuso per capire le ragioni della scelta di non pubblicare il codice sorgente di Guida e il ruolo del software open source nel progetto
4. Leggi Integrazioni database se gli script richiedono credenziali di accesso per PostgreSQL, MongoDB, archiviazione compatibile con S3 o Elasticsearch

Azioni iniziali comuni

Attività	Inizia qui
Installare Guida	Installazione
Scegliere Complete o Node	Installazione
Eseguire il primo script	Avvio rapido
Aprire uno spazio di lavoro	Spazi di lavoro
Collegare un client MCP	Integrazione MCP
Controllare un nodo remoto	Remote Ops API
Usare le credenziali di accesso in sicurezza	Credenziali di accesso
Eseguire processi di lavoro delle code	Processi di lavoro delle code
Salvare o interrogare dati estratti	Dati e archiviazione
Catturare traffico di rete	Soluzione per catturare traffico di rete

Come funziona

Gli script usano l’API g.* per controllare le schede del browser, ispezionare il DOM, salvare dati, eseguire code, chiamare LLM locali e integrarsi con i servizi dello spazio di lavoro. I metodi JavaScript e Janet restituiscono valori direttamente e generano errori. Lua usa ritorni multipli.

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

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

Tutto gira sulla tua macchina. I dati dello spazio di lavoro restano nella cartella dello spazio di lavoro, lo stato dell’app resta sotto il tuo profilo utente Windows e Guida non richiede account, telemetria o sincronizzazione cloud.