Sfoglia la guida utente

Riferimento degli strumenti

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

Aggiornato il 16 novembre 2026

Apri Markdown
In questa pagina

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 corsoget_status
veda che cosa c'è sullo schermolist_capture_sources, capture_snapshot, capture_window_snapshot
acquisisca una finestra più volte, premendo un tastostart_auto_capture, get_job, control_job
registri una guida clic per clicstart_action_capture, get_job, control_job
acquisisca pagine webpreview_website, capture_websites, get_job, control_job
riusi o pianifichi le impostazioni per i sitiwebsite_capture_options, website_workflows
trovi e guardi acquisizioni passatelist_capture_sessions, get_capture_session, view_images
crei e modifichi un documentolist_documents, get_document, create_document, add_pages, edit_document
produca i fileexport, get_job
faccia ordinedelete_items, rename_capture_session
cambi le impostazioni di acquisizione ed esportazioneupdate_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.

start_action_capture

Avvia un'Acquisizione da azioni: 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.

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.

Se uno strumento restituisce un errore, vedi Errori degli agenti e soluzioni.

Riferimento degli strumenti | Guida utente | Shotomatic