> ## Documentation Index > Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Crea attività da un URL > Usa octoparse detect per esaminare un URL, selezionare una regione dati e generare un file di attività locale. Supporta flussi automatici, manuali e con agenti AI. `octoparse detect` apre il browser con l'estensione Octoparse, esamina la pagina e genera un file di attività locale. Usalo quando vuoi creare un'attività da un URL senza l'app desktop Octoparse. Nella v0.1.32, detect ha iniziato a rifiutare le pagine con CAPTCHA, accesso limitato, verifiche di sicurezza ed errori di servizio prima della generazione dell'attività. La classificazione dei candidati rifiuta inoltre in modo più rigoroso le regioni deboli e i contenitori di navigazione che occupano l'intera pagina. Le pagine complesse e i flussi di accesso possono comunque richiedere un controllo manuale. Sono disponibili tre modalità: | Modalità | Quando usarla | | --------------------- | ----------------------------------------------------------------------------- | | `--auto` | Vuoi che la CLI scelga automaticamente la regione dati migliore | | `--manual` | Devi accedere, chiudere un paywall o selezionare personalmente la regione | | Agente AI (`--agent`) | Il flusso di lavoro è controllato da un LLM o da uno strumento di automazione | Per gli agenti AI, usa `--agent` o il flusso prepara / anteprima / applica invece di `--auto`. La modalità automatica è destinata alla selezione diretta tramite CLI. `detect` richiede un account Octoparse valido e le relative credenziali. È inoltre necessario Chrome locale. `detect` non supporta Linux arm64. Consulta [Installazione](../quick-start/installation#supported-platforms-for-local-extraction) per i requisiti della piattaforma. ## Modalità automatica La CLI sceglie la regione dati candidata migliore e genera un file di attività: ```bash theme={null} octoparse detect --auto --output task.json ``` Passa una descrizione in linguaggio naturale di ciò che vuoi estrarre: ```bash theme={null} octoparse detect --auto --goal "Extract product titles and prices" --output task.json ``` Cerca una parola chiave prima del rilevamento, utile per le pagine dei risultati di ricerca: ```bash theme={null} octoparse detect --auto --query "keyword" --goal "Extract search results" --output task.json ``` Usa `--json` per una risposta strutturata: ```bash theme={null} octoparse detect --auto --goal "..." --output task.json --json ``` Se `--output` viene omesso, viene creato automaticamente un file `detected_.json`. ## Scegli una modalità browser Usa Chrome for Testing indipendente oppure riutilizza un profilo del browser di sistema con accesso effettuato: ```bash theme={null} octoparse detect --browser independent --auto octoparse detect --browser user --browser-id chrome --profile "Default" --manual ``` La modalità browser segue la priorità condivisa documentata da `octoparse browser --help`: flag del comando, `OCTOPARSE_BROWSER`, impostazione `octoparse browser use` salvata e infine `independent`. La modalità utente è disponibile su Windows e macOS. ## Modalità manuale La modalità manuale apre un pannello sovrapposto nel browser in cui puoi completare l'accesso, chiudere i popup e selezionare personalmente la regione dati: ```bash theme={null} octoparse detect --manual octoparse detect --manual --goal "Get article titles and links" ``` Usa `--save-session` per memorizzare i Cookie per i siti che richiedono l'accesso, in modo che le future esecuzioni locali possano riprodurre la sessione: ```bash theme={null} octoparse detect --manual --save-session --session-name my-session --output task.json ``` Le sessioni basate sui Cookie non coprono tutti i siti, in particolare le pagine che richiedono localStorage, associazione al dispositivo o una nuova verifica. ## Convalida l'attività generata Dopo aver generato un file di attività, convalidalo prima dell'esecuzione: ```bash theme={null} octoparse task validate --task-file task.json ``` Quindi esegui un campione locale: ```bash theme={null} octoparse run --task-file task.json --max-rows 10 --headless ``` Esporta i risultati del campione: ```bash theme={null} octoparse data export --source local --format xlsx ``` ## Flusso di lavoro con agente AI Per i flussi di lavoro guidati da LLM o automatizzati, usa il contratto dell'agente invece di `--auto`. Inizia leggendo le funzionalità: ```bash theme={null} octoparse capabilities --json ``` La risposta include `machineContract.recipes.createTaskFromUrlWithAgent`, il flusso di lavoro consigliato per gli agenti. ### In un solo passaggio (più veloce) Usa `--agent` con un runner locale attendibile in grado di leggere un file di contesto e scrivere un piano: ```bash theme={null} octoparse detect \ --agent \ --agent-command "path/to/your/agent-runner" \ --goal "Extract search results" \ --output task.json \ --yes \ --run-sample 5 \ --json ``` La risposta è un singolo contenitore JSON che include l'attività generata, il risultato dell'anteprima e l'output dell'esecuzione campione. ### Passaggi verificabili singolarmente Per scenari di verifica o correzione, usa la sequenza prepara / anteprima / applica invece di generare l'attività in un unico passaggio. Esporta il contesto della pagina web per la pianificazione dell'agente. ```bash theme={null} octoparse detect \ --prepare-agent \ --goal "Extract product titles and prices" \ --output context.json \ --json ``` Questo genera `context.json` con le regioni dati candidate, campioni dei campi, screenshot visivi e un `decisionSummary`. Crea un `plan.json` basato su `context.json`. Usa lo schema `octopus.detect.agent-plan.v1`. Apri il percorso dello screenshot annotato in `context.visualArtifacts.annotatedScreenshotPath` prima di scegliere i campi e includi nel piano le prove `visualReview`. Convalida il piano prima di generare il file di attività finale. ```bash theme={null} octoparse detect \ --preview-agent-plan plan.json \ --agent-context context.json \ --json ``` Se `data.pass` è false, rivedi il piano prima di applicarlo. Genera il file di attività locale finale. ```bash theme={null} octoparse detect \ --apply-agent-plan plan.json \ --agent-context context.json \ --output task.json ``` Il file `task.json` generato può quindi essere esaminato, convalidato o usato in un'esecuzione CLI locale. ## Risoluzione dei problemi di detect | Problema | Cosa controllare | | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Chrome non si avvia | Esegui `octoparse doctor` e controlla la voce `chrome`. Prova `--chrome-path /path/to/chrome` | | `LINUX_ARM64_UNSUPPORTED` | Passa a un ambiente Linux x64 o usa l'estrazione cloud | | `LOGIN_SESSION_REQUIRED` | Usa `--manual` per accedere e `--save-session` per memorizzare la sessione | | L'anteprima del piano restituisce `pass: false` | Rivedi `candidateId` o la selezione dei campi in `plan.json` ed esegui nuovamente l'anteprima | | L'attività produce risultati vuoti o errati | Controlla `context.resultValidationPolicy` nel contesto dell'agente; singoli campi mancanti negli annunci o nelle righe eterogenee sono spesso normali | ## Passaggi successivi Esegui un'attività generata in locale, controlla lo stato ed esporta i risultati. Riferimento completo per i comandi detect, run, cloud, data e auth.