# Riferimento degli strumenti | Guida utente | Shotomatic

> Tutti gli strumenti MCP che Shotomatic offre agli agenti IA: che cosa fa ciascuno, quali chiedono prima conferma e quali parti richiedono Pro.

- Tipo: Pagina web pubblica
- Pagina canonica: [https://www.shotomatic.com/it/guide/ai-agents/tools](https://www.shotomatic.com/it/guide/ai-agents/tools)
- Pagina Markdown: [https://www.shotomatic.com/it/guide/ai-agents/tools.md](https://www.shotomatic.com/it/guide/ai-agents/tools.md)

Sfoglia la guida utente

In questa pagina

1.  [Quale strumento per quale lavoro](#quale-strumento-per-quale-lavoro)
2.  [Stato e sorgenti](#stato-e-sorgenti)
3.  [Acquisizioni e lavori](#acquisizioni-e-lavori)
4.  [Acquisizione siti web](#acquisizione-siti-web)
5.  [Cronologia acquisizioni](#cronologia-acquisizioni)
6.  [Documenti](#documenti)
7.  [Esportazione e impostazioni](#esportazione-e-impostazioni)
8.  [Eliminazione](#eliminazione)

Questa pagina elenca gli strumenti MCP che Shotomatic 1.10.1 offre a un agente approvato. Gli agenti leggono lo stesso elenco, con gli schemi di input completi, quando si collegano. Non sei tu a chiamare questi strumenti, ma conoscerli ti aiuta a formulare le richieste e a capire che cosa riferisce un agente.

## Quale strumento per quale lavoro

Vuoi che l'agente…

Strumenti usati

controlli autorizzazioni, piano e lavori in corso

`get_status`

veda che cosa c'è sullo schermo

`list_capture_sources`, `capture_snapshot`, `capture_window_snapshot`

acquisisca una finestra più volte, premendo un tasto

`start_auto_capture`, `get_job`, `control_job`

registri una guida clic per clic

`start_action_capture`, `get_job`, `control_job`

acquisisca pagine web

`preview_website`, `capture_websites`, `get_job`, `control_job`

riusi o pianifichi le impostazioni per i siti

`website_capture_options`, `website_workflows`

trovi e guardi acquisizioni passate

`list_capture_sessions`, `get_capture_session`, `view_images`

crei e modifichi un documento

`list_documents`, `get_document`, `create_document`, `add_pages`, `edit_document`

produca i file

`export`, `get_job`

faccia ordine

`delete_items`, `rename_capture_session`

cambi le impostazioni di acquisizione ed esportazione

`update_settings`

I lavori lunghi restituiscono subito un ID. L'agente segue il lavoro con `get_job`, che attende fino a 50 secondi per chiamata, così un'acquisizione lunga continua in Shotomatic tra una chiamata e l'altra.

## Stato e sorgenti

### get\_status

Riporta la versione dell'app, se **Registrazione schermo** e **Accessibilità** sono concesse, il tuo piano e gli screenshot gratuiti ancora disponibili oggi, i limiti delle funzioni, i lavori in corso, se il browser per i siti web è installato e le impostazioni attuali. Gli agenti lo chiamano per primo e di nuovo dopo che hai risolto qualcosa.

### list\_capture\_sources

Elenca le finestre e gli schermi che Shotomatic può acquisire, con ID, nomi e nomi delle app.

### capture\_snapshot

Fa un'anteprima di una finestra o di uno schermo per verificare che sia aperta la pagina giusta. L'anteprima è un JPEG più piccolo, non viene salvata nella Cronologia acquisizioni e non usa gli screenshot gratuiti.

### capture\_window\_snapshot

Fa un'istantanea PNG di una finestra e la restituisce all'agente. Come `capture_snapshot`, non viene salvata.

## Acquisizioni e lavori

### start\_auto\_capture

Acquisisce una finestra a intervalli fissi e può premere un tasto dopo ogni screenshot, per esempio la freccia destra per voltare pagina. Shotomatic porta la finestra in primo piano e non preme mai un tasto se un'altra finestra è in primo piano o lo schermo è bloccato: in quel caso il lavoro va in pausa. Con la pressione di un tasto, si ferma da sola quando la pagina smette di cambiare. Le condizioni di arresto dipendono dal tuo piano; vedi [Condizioni di arresto, intervalli e pressioni dei tasti](https://www.shotomatic.com/it/guide/screenshot-capture/automated-capture).

### start\_action\_capture

Avvia un'[Acquisizione da azioni](https://www.shotomatic.com/it/guide/screenshot-capture/action-capture): ogni clic nella finestra scelta salva un passaggio e, quando l'acquisizione si ferma, viene creato un documento. Shotomatic non fa clic: i clic li fai tu, oppure li fa un agente con una propria capacità di controllo del computer.

### get\_job

Controlla un'acquisizione, un batch di siti o un'esportazione avviati prima e può attenderne l'avanzamento.

### control\_job

Gestisce un lavoro in corso. Acquisizione automatica: pausa, ripresa o arresto, mantenendo gli screenshot già fatti. Acquisizione da azioni: arresto con creazione del documento, oppure salvataggio di un passaggio senza clic. Batch di siti: annullamento del batch, oppure annullamento o nuovo tentativo di una singola pagina.

## Acquisizione siti web

### preview\_website

Mostra un URL con le opzioni indicate nel browser di Shotomatic e fa vedere il risultato all'agente, così può regolare le opzioni prima di un batch. L'anteprima non viene salvata.

### capture\_websites

Acquisisce un elenco di pagine web, a pagina intera o solo l'area visibile, in formato desktop, tablet o mobile, in un'unica sessione di acquisizione, oppure esegue subito un flusso di lavoro salvato. Lo schermo non viene usato. Serve il browser per i siti web; vedi [Guida rapida: Acquisizione siti web](https://www.shotomatic.com/it/guide/website-capture/quick-start).

### website\_capture\_options

Elenca, legge o salva le opzioni salvate di Acquisizione siti web. Gli agenti non possono eliminare le opzioni salvate.

### website\_workflows

Elenca, legge, salva, mette in pausa o riprende i flussi di lavoro. Una pianificazione è un intervallo di almeno 5 minuti oppure un orario giornaliero. Il salvataggio di un flusso con pianificazione e la ripresa attendono la tua conferma, la pausa no. Le esecuzioni pianificate avvengono solo mentre Shotomatic è aperto, e quelle perse mentre era chiuso non vengono recuperate. Gli agenti non possono eliminare i flussi di lavoro.

## Cronologia acquisizioni

### list\_capture\_sessions

Elenca le sessioni di acquisizione, dalla più recente, con il numero di fotogrammi e il documento creato da ciascuna sessione, se esiste.

### get\_capture\_session

Legge una sessione: riepilogo, percorsi dei file dei fotogrammi a gruppi di massimo 200 e, per Acquisizione siti web, ogni pagina con il suo stato.

### rename\_capture\_session

Rinomina una sessione così come appare in Shotomatic.

### view\_images

Mostra all'agente fotogrammi della Cronologia acquisizioni o pagine di documenti come immagini, fino a 6 per chiamata e 8 MB in totale. Una pagina di documento appare senza ritaglio né annotazioni. Le immagini che un agente guarda entrano nella sua conversazione.

## Documenti

### list\_documents

Elenca i documenti, dal più recente modificato.

### get\_document

Legge un documento: titolo, revisione, pagine con testo, inquadratura e annotazioni.

### create\_document

Crea un documento da fotogrammi di una sessione di acquisizione, da file immagine o da una pagina vuota. Se scegli un'intera sessione che ha già un documento, restituisce quel documento invece di una copia.

### add\_pages

Aggiunge pagine da fotogrammi di una sessione di acquisizione o da file immagine, alla fine o dopo una pagina indicata.

### edit\_document

Modifica un documento in un solo passaggio: titolo, titoli e descrizioni delle pagine, inquadratura, annotazioni, ordine delle pagine, duplicazione o eliminazione di pagine e filigrana. Se una parte non riesce, non cambia nulla. Sfocatura, evidenziatore, indicatore di clic e filigrana richiedono Pro. Se il documento è aperto nell'editor, l'editor lo ricarica.

## Esportazione e impostazioni

### export

Esporta un documento come PDF, PNG, JPG, WebP o ZIP, oppure i fotogrammi di una sessione di acquisizione come ZIP, PNG, JPG, PDF ricercabile o MP4. I file vanno nella cartella di esportazione con nomi nuovi, i file esistenti non vengono mai sovrascritti e sullo schermo non si apre nulla.

### update\_settings

Modifica **Esportazione automatica** (attiva o disattiva, PNG o JPG), la qualità JPG e quante sessioni conserva la Cronologia acquisizioni. Un limite più basso che eliminerebbe sessioni chiede prima a te. Cartella di esportazione, lingua, preset e licenza non si possono modificare.

## Eliminazione

### delete\_items

Elimina fino a 50 documenti o sessioni di acquisizione in una sola richiesta. Shotomatic mostra una conferma che elenca ogni elemento e attende la tua risposta fino a un minuto. Eliminare una sessione di acquisizione non elimina mai i documenti creati da essa. Vedi [Approvazioni e conferme](https://www.shotomatic.com/it/guide/ai-agents/approvals-and-confirmations).

Se uno strumento restituisce un errore, vedi [Errori degli agenti e soluzioni](https://www.shotomatic.com/it/guide/ai-agents/errors).

## In questa pagina

1.  [Quale strumento per quale lavoro](#quale-strumento-per-quale-lavoro)
2.  [Stato e sorgenti](#stato-e-sorgenti)
3.  [Acquisizioni e lavori](#acquisizioni-e-lavori)
4.  [Acquisizione siti web](#acquisizione-siti-web)
5.  [Cronologia acquisizioni](#cronologia-acquisizioni)
6.  [Documenti](#documenti)
7.  [Esportazione e impostazioni](#esportazione-e-impostazioni)
8.  [Eliminazione](#eliminazione)

## Informazioni su questa versione

Questa pagina Markdown viene generata dalla pagina pubblica di Shotomatic renderizzata sul server. I controlli interattivi e la navigazione del sito non sono inclusi. Per citare o condividere il contenuto, usa la pagina canonica.
