Riferimento degli strumenti MCP

Il server MCP di Annota AI espone gli strumenti elencati qui sotto. È il tuo assistente a sceglierli in base a ciò che chiedi, quindi raramente dovrai nominarne uno. Usa questa pagina per capire cosa può fare un assistente dopo averlo collegato con MCP.

Come funzionano gli strumenti

Un solo permesso per tutti gli strumenti. Non esistono permessi per singolo strumento. Quando autorizzi un client, può usare tutti gli strumenti, limitatamente alle organizzazioni di cui fai parte e a ciò che i tuoi permessi consentono in ciascuna.
Lettura, scrittura o distruttivo. Ogni strumento indica al client se legge soltanto, modifica i dati oppure elimina o annulla qualcosa in modo definitivo. Il client può usare questa informazione per chiederti conferma prima di una modifica. La colonna Tipo lo riporta.
Prima l’organizzazione. Quasi tutti gli strumenti richiedono un’organizzazione e spesso un dataset o una knowledge base. L’assistente li trova con gli strumenti di elenco.
Tentativi sicuri. Gli strumenti che creano qualcosa o avviano un processo accettano un identificativo di richiesta, quindi ripetere la stessa chiamata non crea duplicati.
Link temporanei. Gli strumenti che restituiscono file (originali dei contenuti, esportazioni, versioni dei modelli, originali delle knowledge base) forniscono un link di download temporaneo.
Nessuno strumento di chat. Il server non ha strumenti di chat di Brain. L’assistente cerca e legge le knowledge base con gli strumenti qui sotto e risponde con il proprio modello.

Account

Strumento	Cosa fa	Tipo
`get_current_user`	Restituisce il tuo profilo utente Annota AI.	Lettura
`list_organizations`	Elenca le organizzazioni di cui fai parte.	Lettura

Dataset

Strumento	Cosa fa	Tipo
`list_datasets`	Elenca i dataset di un’organizzazione.	Lettura
`get_dataset`	Recupera un dataset.	Lettura
`create_dataset`	Crea un dataset di immagini o di documenti.	Scrittura
`update_dataset`	Modifica nome o descrizione di un dataset.	Scrittura
`delete_dataset`	Elimina definitivamente un dataset con contenuti, etichette, annotazioni ed esportazioni concluse.	Distruttivo

Contenuti

Strumento	Cosa fa	Tipo
`list_assets`	Elenca i contenuti di un dataset, con filtri facoltativi per etichetta, presenza di annotazioni o stato di revisione.	Lettura
`get_asset`	Recupera i dettagli e lo stato di revisione di un contenuto.	Lettura
`get_asset_file`	Recupera un contenuto con un link temporaneo al file originale.	Lettura
`create_asset`	Crea un contenuto e restituisce un link di caricamento temporaneo per un file locale.	Scrittura
`import_asset`	Importa in un dataset di immagini o di documenti un file selezionato in ChatGPT.	Scrittura
`get_file_upload`	Verifica se un file caricato è stato convalidato ed elaborato.	Lettura
`update_asset_review_status`	Imposta lo stato di revisione di un contenuto: da annotare, da revisionare, approvato o rifiutato.	Scrittura
`batch_update_asset_review_status`	Imposta insieme lo stato di revisione di 1-100 contenuti dello stesso dataset. Se uno non riesce, nessuno cambia.	Scrittura
`delete_asset`	Elimina definitivamente un contenuto con le sue annotazioni e i suoi file.	Distruttivo
`batch_delete_assets`	Elimina definitivamente 1-100 contenuti con annotazioni, pagine OCR e file. Se uno non riesce, nessuno viene eliminato.	Distruttivo

Etichette

Strumento	Cosa fa	Tipo
`list_labels`	Elenca le etichette di un dataset e quante volte viene usata ciascuna.	Lettura
`create_label`	Crea un’etichetta in un dataset.	Scrittura
`update_label`	Modifica nome o colore di un’etichetta.	Scrittura
`delete_label`	Elimina definitivamente un’etichetta. Le sue annotazioni vengono eliminate, a meno che non le sposti su un’altra etichetta.	Distruttivo

Annotazioni

Strumento	Cosa fa	Tipo
`list_annotations`	Elenca le annotazioni a riquadro e a poligono di un contenuto.	Lettura
`create_annotation`	Crea un’annotazione a riquadro o a poligono.	Scrittura
`update_annotation`	Modifica l’etichetta, la forma o entrambe di un’annotazione.	Scrittura
`delete_annotation`	Elimina definitivamente un’annotazione.	Distruttivo

Documenti e OCR

Strumento	Cosa fa	Tipo
`list_document_pages`	Elenca le pagine di un documento che hanno testo OCR.	Lettura
`read_document_page`	Legge il testo Markdown di una pagina, in parti da massimo 16.000 caratteri.	Lettura
`update_document_page`	Sostituisce il Markdown corretto di una pagina. Non cambia lo stato di revisione del documento.	Scrittura
`get_ocr_job`	Mostra l’avanzamento dell’OCR: pagine elaborate, totali e non riuscite, con stato ed errori di ogni pagina.	Lettura
`retry_ocr_job`	Riprova le pagine non completate dopo un OCR non riuscito, parziale o in pausa.	Scrittura

Esportazioni

Strumento	Cosa fa	Tipo
`list_exports`	Elenca le esportazioni di un dataset e il loro stato.	Lettura
`create_export`	Avvia un’esportazione: COCO per i dataset di immagini, LLM wiki o ZIP Markdown per i dataset di documenti.	Scrittura
`get_export`	Recupera un’esportazione con un link di download temporaneo, quando è pronta e non è scaduta.	Lettura
`delete_export`	Elimina definitivamente un’esportazione conclusa. Quelle ancora in corso non si possono eliminare.	Distruttivo

Annotazione automatica

Strumento	Cosa fa	Tipo
`preview_auto_annotate_run`	Mostra in anteprima le immagini da annotare, i conflitti con le annotazioni esistenti e una stima in crediti.	Lettura
`start_auto_annotate_run`	Avvia l’annotazione automatica di un dataset di immagini per le etichette scelte.	Scrittura
`get_auto_annotate_run`	Recupera l’ultima annotazione automatica di un dataset.	Lettura

Puoi annotare solo le immagini non ancora annotate oppure tutte le immagini pronte. Se le annoti tutte, le annotazioni esistenti per le stesse etichette vengono saltate per impostazione predefinita; l’assistente può anche sovrascriverle o aggiungere duplicati.

Versioni dei dataset

Strumento	Cosa fa	Tipo
`list_dataset_snapshots`	Elenca le versioni di un dataset e il loro stato di creazione.	Lettura
`get_dataset_snapshot`	Recupera lo stato di creazione e il numero di elementi di una versione.	Lettura
`create_dataset_snapshot`	Crea una nuova versione di un dataset per l’addestramento o l’esportazione.	Scrittura
`delete_dataset_snapshot`	Elimina definitivamente una versione. Non si possono eliminare versioni usate da addestramenti o esportazioni attive.	Distruttivo

Modelli e addestramento Beta privata

L’addestramento è disponibile per le organizzazioni che partecipano alla beta privata.

Strumento	Cosa fa	Tipo
`list_base_models`	Elenca i modelli di base preaddestrati da cui partire e quello predefinito.	Lettura
`list_models`	Elenca i modelli di un’organizzazione.	Lettura
`get_model`	Recupera un modello e indica se l’addestramento è abilitato.	Lettura
`create_model`	Crea un modello di object detection.	Scrittura
`update_model`	Modifica nome e descrizione di un modello.	Scrittura
`delete_model`	Elimina definitivamente un modello con la cronologia degli addestramenti e le versioni. Prima deve fermarsi ogni addestramento attivo.	Distruttivo
`start_training_run`	Addestra un modello su una versione pronta di un dataset di immagini. Usa solo le immagini revisionate; i poligoni diventano riquadri.	Scrittura
`list_training_runs`	Elenca la cronologia e l’avanzamento degli addestramenti di un modello.	Lettura
`get_training_run`	Recupera un addestramento con configurazione, avanzamento e metriche.	Lettura
`cancel_training_run`	Annulla un addestramento in coda o in corso.	Distruttivo
`list_model_versions`	Elenca le versioni riuscite di un modello e le loro metriche finali.	Lettura
`get_model_version_download`	Restituisce un link di download temporaneo per una versione del modello.	Lettura

Knowledge base

Strumento	Cosa fa	Tipo
`list_knowledge_bases`	Elenca le knowledge base di un’organizzazione con il loro stato di sincronizzazione.	Lettura
`get_knowledge_base`	Recupera una knowledge base con i documenti indicizzati, in attesa, non riusciti ed esclusi.	Lettura
`create_knowledge_base`	Crea una knowledge base per un dataset di documenti, o per uno nuovo e vuoto, e ne segue le modifiche.	Scrittura
`update_knowledge_base`	Modifica nome e descrizione di una knowledge base e se indicizzare solo i documenti approvati.	Scrittura
`delete_knowledge_base`	Elimina una knowledge base e il suo indice. Il dataset di documenti resta.	Distruttivo
`retry_knowledge_base_documents`	Rimette in coda per l’indicizzazione i documenti non riusciti.	Scrittura
`list_knowledge_base_documents`	Elenca i documenti di una knowledge base con stato di indicizzazione ed errori.	Lettura
`get_knowledge_base_index`	Legge l’indice dei documenti della knowledge base: documenti, numero di pagine e brevi riassunti.	Lettura
`get_knowledge_base_document`	Legge il riassunto e i dettagli di un documento.	Lettura
`search_knowledge_bases`	Cerca per parole chiave nelle pagine di massimo 10 knowledge base, includendo pagine dal significato simile.	Lettura
`read_knowledge_base_pages`	Legge da 1 a 5 pagine originali di un documento, così l’assistente può citarle.	Lettura
`get_knowledge_base_original`	Restituisce un link temporaneo al file originale di un documento.	Lettura

I risultati della ricerca indicano all’assistente quali pagine leggere; le legge prima di citarle.

Strumenti che consumano crediti

Questi strumenti usano i crediti dal saldo della tua organizzazione, come nell’app:

Strumento	Crediti
`create_asset`, `import_asset` (documenti), `retry_ocr_job`	OCR delle pagine dei documenti.
`start_auto_annotate_run`	Addebito per immagine dopo l’elaborazione; prosegue solo con saldo positivo.
`create_knowledge_base` e le successive modifiche al dataset	Indicizzazione delle pagine nuove o modificate.
`search_knowledge_bases`	Pochi crediti per ricerca; serve un saldo positivo.

Leggere pagine, consultare elenchi e scaricare file non consuma crediti. Le stime nei risultati degli strumenti sono espresse in unità di credito: 10 unità corrispondono a un credito. Per i dettagli, vedi Utilizzo dei crediti.