Guida pratica · funzioni ed esempi

Che cosa puoi chiedere a Metnos

Le funzioni sono raccolte per ambito, chiamato dominio nel codice di Metnos. Ogni esempio è una frase che puoi usare in chat: non occorre conoscere i nomi delle operazioni o una sintassi particolare.

29ambiti120operazioni documentate

La guida segue i 29 ambiti definiti nel codice. L’elenco delle operazioni viene generato dalle loro schede tecniche, chiamate manifest, e dalle funzioni integrate in Metnos. Una funzione descritta qui può richiedere servizi, credenziali o permessi che la tua installazione non possiede. Prima dell’uso deve inoltre superare le verifiche di Executor Birth. Le skill installate possono aggiungere servizi e operazioni. Chiedi al Tutor che cosa puoi usare nella tua istanza.

Contenuti e calcoloComposizione dei risultatiComunicazione e tempoWeb, luoghi e mediaCollaborazione e fornitoriControllo e amministrazioneFunzioni trasversali
05

Contenuti e calcolo

File, strutture e trasformazioni locali.

files

File

21 operazioni documentate

Trova, legge, crea, converte, sposta, condivide e analizza file locali o forniti da un servizio collegato. Comprende documenti, fogli, PDF, OCR, archivi, hash e linee di codice.

Limiti. Il dominio riguarda il contenitore file. Per il significato visuale di una foto usa Immagini; per una pagina pubblica usa URL.

Puoi scrivere in chat, per esempio:«Trova tutti i PDF modificati questa settimana in Progetti e riassumi quelli che parlano di Atlas.»

Puoi scrivere in chat, per esempio:«Trova i file immagine con contenuto identico nella cartella Immagini del server e dimmi quanto spazio occupano le copie ridondanti.»

Operazioni incluse (21)
change_files_formatcompress_filescompute_files_loccreate_files_doccreate_files_spreadsheetdelete_filesfind_filesfind_files_hashget_filesmove_filesorganize_filesread_filesread_files_csvread_files_docread_files_ocrread_files_spreadsheetread_files_xlsxshare_fileswrite_fileswrite_files_docwrite_files_spreadsheet
dirs

Cartelle

4 operazioni documentate

Elenca, cerca, crea ed elimina directory, anche su un dispositivo remoto quando il piano lo richiede.

Limiti. Una cartella organizza file; non rappresenta il loro contenuto. Le cancellazioni non sicure richiedono i normali vagli.

Puoi scrivere in chat, per esempio:«Mostrami le sottocartelle di Foto ordinate per dimensione.»

Puoi scrivere in chat, per esempio:«Crea la cartella Clienti/2026 sul portatile dello studio.»

Operazioni incluse (4)
create_dirsdelete_dirsfind_dirslist_dirs
packages

Programmi installati

2 operazioni documentate

Verifica se un comando o programma eseguibile è disponibile nel PATH del sistema scelto.

Limiti. Rileva disponibilità e posizione; non installa automaticamente pacchetti non richiesti.

Puoi scrivere in chat, per esempio:«Verifica se ffmpeg è installato su questo server.»

Puoi scrivere in chat, per esempio:«Dove si trova python3 sul PC Windows accoppiato?»

Operazioni incluse (2)
find_packagesinstall_packages
numbers

Numeri

1 operazione documentata

Calcola statistiche descrittive su valori numerici: conteggio, minimo, massimo, media e altre sintesi ammesse.

Limiti. Riceve numeri espliciti o prodotti da un passo precedente; non sostituisce un foglio di calcolo persistente.

Puoi scrivere in chat, per esempio:«Calcola media, minimo e massimo di 12, 18, 21, 21 e 34.»

Puoi scrivere in chat, per esempio:«Trova le fatture del mese e dimmi la spesa media.»

Operazioni incluse (1)
describe_numbers
texts

Testi

1 operazione documentata

Filtra e trasforma contenuto testuale già disponibile, con granularità come righe, paragrafi o segmenti.

Limiti. Lavora sul testo in memoria; per estrarlo prima da un file, una mail o una pagina serve il relativo dominio sorgente.

Puoi scrivere in chat, per esempio:«Nel log che ti ho dato conserva solo le righe che contengono timeout o retry.»

Puoi scrivere in chat, per esempio:«Leggi il documento e mostrami soltanto i paragrafi con una data.»

Operazioni incluse (1)
filter_texts_lines
02

Composizione dei risultati

Passi interni che collegano più capacità in una sola richiesta.

entries

Risultati in memoria

11 operazioni documentate

Ordina, filtra, raggruppa, classifica, confronta, estrae e riassume le righe strutturate prodotte durante lo stesso turno.

Limiti. È un dominio di composizione interno: l'utente descrive il risultato finale, non deve conoscere il nome entries.

Puoi scrivere in chat, per esempio:«Trova le fatture di luglio, raggruppale per fornitore e disponile in ordine decrescente di importo.»

Puoi scrivere in chat, per esempio:«Cerca le issue aperte, classificale per urgenza e mostrami solo le critiche.»

Operazioni incluse (11)
classify_entriescompare_entriescompute_entriesdelete_entriesdescribe_entriesextract_entriesfilter_entriesfind_entriesgroup_entriessort_entrieswrite_entries
lists

Confronto tra liste

1 operazione documentata

Confronta due insiemi di risultati per trovare elementi comuni, nuovi o scomparsi, usando chiavi esplicite.

Limiti. Le liste devono provenire dallo stesso piano o da una sorgente identificabile; il confronto non inventa corrispondenze.

Puoi scrivere in chat, per esempio:«Confronta i file di queste due cartelle e mostrami quelli presenti solo nella seconda.»

Puoi scrivere in chat, per esempio:«Quali issue sono nuove rispetto all'elenco salvato ieri?»

Operazioni incluse (1)
filter_lists
05

Comunicazione e tempo

Messaggi, rubriche, calendari e attività future.

messages

Messaggi e posta

4 operazioni documentate

Cerca, legge, invia, risponde, etichetta, sposta o elimina messaggi tramite account configurati, inclusi IMAP/SMTP, Gmail e canali ammessi.

Limiti. L'account è selezionabile quando ce n'è più di uno. Invii, risposte ed eliminazioni mantengono consenso e tracciabilità.

Puoi scrivere in chat, per esempio:«Con l'account lavoro cerca le mail di Marta degli ultimi sette giorni con allegati PDF.»

Puoi scrivere in chat, per esempio:«Rispondi nello stesso thread che la riunione è confermata, ma mostrami prima il testo.»

Operazioni incluse (4)
move_messagesread_messagessend_messagesset_messages
events

Eventi

4 operazioni documentate

Legge, crea ed elimina appuntamenti e trova intervalli liberi nei calendari accessibili.

Limiti. Un evento è un appuntamento. Calendari gestisce i contenitori; Attività programmate esegue richieste nel futuro.

Puoi scrivere in chat, per esempio:«Trova un'ora libera martedì pomeriggio tra il mio calendario e quello di Anna.»

Puoi scrivere in chat, per esempio:«Crea una riunione di 45 minuti venerdì alle 10 con Luca.»

Operazioni incluse (4)
create_eventsdelete_eventsfind_events_emptyread_events
contacts

Contatti

2 operazioni documentate

Cerca e legge voci di rubrica con nome, email e telefono, locali o fornite da un account collegato.

Limiti. Un contatto è una voce di rubrica. Il dominio Persone rappresenta invece identità locali e riconoscimento nelle foto.

Puoi scrivere in chat, per esempio:«Trova l'indirizzo email di Laura Bianchi nei miei contatti.»

Puoi scrivere in chat, per esempio:«Mostrami il numero di telefono del contatto Acme assistenza.»

Operazioni incluse (2)
find_contactsread_contacts
tasks

Attività programmate

6 operazioni documentate

Crea, consulta, modifica ed elimina promemoria o richieste ricorrenti; conserva anche la cronologia delle esecuzioni. Riguarda soltanto lo scheduler interno di Metnos.

Limiti. Un'attività programmata esegue una richiesta a un'ora stabilita o al verificarsi di un evento; non è un appuntamento di calendario né un'automazione remota, che appartiene ad Automazioni remote.

Puoi scrivere in chat, per esempio:«Ogni lunedì alle 8 leggi le mail non lette dell'account lavoro e mandami un riepilogo su Telegram.»

Puoi scrivere in chat, per esempio:«Mostrami gli ultimi esiti dell'attività Backup foto e gli eventuali errori.»

Operazioni incluse (6)
create_tasksdelete_taskslist_tasksread_tasksread_tasks_historyset_tasks
calendars

Calendari

2 operazioni documentate

Crea e rimuove calendari-contenitore, separati dagli appuntamenti che contengono.

Limiti. Eliminare un calendario può eliminare anche i suoi eventi ed è quindi un'operazione distruttiva sottoposta a vaglio.

Puoi scrivere in chat, per esempio:«Crea un nuovo calendario Google chiamato Turni assistenza.»

Puoi scrivere in chat, per esempio:«Elimina il calendario di prova Test 2025 e tutto il suo contenuto.»

Operazioni incluse (2)
create_calendarsdelete_calendars
05

Web, luoghi e media

Informazioni pubbliche, sessioni web e archivi visuali.

places

Luoghi

2 operazioni documentate

Cerca luoghi reali da testo o coordinate e traduce coordinate GPS in nomi geografici.

Limiti. La posizione corrente dell'utente proviene da una funzione di sistema separata; Luoghi interpreta o cerca destinazioni.

Puoi scrivere in chat, per esempio:«Cerca una farmacia vicino a Piazza Maggiore a Bologna.»

Puoi scrivere in chat, per esempio:«A quale luogo corrispondono le coordinate 45.4642, 9.1900?»

Operazioni incluse (2)
find_placesget_places
urls

Web e URL

5 operazioni documentate

Cerca sul web, recupera URL noti e legge pagine HTML o PDF pubblici, estraendo testo e metadati.

Limiti. Una pagina pubblica senza sessione appartiene a URL. Per un sito autenticato e interattivo usa Siti.

Puoi scrivere in chat, per esempio:«Cerca sul web le linee guida europee più recenti sul passaporto digitale dei prodotti e cita le fonti.»

Puoi scrivere in chat, per esempio:«Leggi questo PDF online e riassumi requisiti, scadenze e destinatari.»

Operazioni incluse (5)
find_urlsget_urlslogin_urlsread_urls_htmlread_urls_pdf
images

Immagini e fotografie

9 operazioni documentate

Descrive immagini, crea e consulta indici locali, cerca per contenuto, persona o somiglianza, cerca immagini sul web e usa le foto Google create tramite Metnos.

Limiti. Le operazioni generiche per percorso restano nel dominio File. Google Photos espone soltanto gli elementi ammessi dalla relativa API e dal suo mandato.

Puoi scrivere in chat, per esempio:«Nell'archivio foto trova le immagini di Carlo al mare al tramonto.»

Puoi scrivere in chat, per esempio:«Cerca sul web una fotografia riutilizzabile del Duomo di Milano vista dall'alto.»

Operazioni incluse (9)
create_images_indicesdelete_images_indicesdescribe_imagesfind_images_google_photosfind_images_indicesfind_images_webget_images_google_photosget_images_indiceswrite_images_google_photos
persons

Persone e identità locali

5 operazioni documentate

Gestisce un registro nominale locale e collega volti riconosciuti alle persone nelle fotografie; può anche leggere il profilo dell'attore corrente.

Limiti. Non è una rubrica: email e telefoni appartengono a Contatti. Dati biometrici ed eliminazioni seguono controlli dedicati.

Puoi scrivere in chat, per esempio:«Registra questa foto come volto di Francesca Riva.»

Puoi scrivere in chat, per esempio:«Trova nell'archivio tutte le foto in cui compare Francesca.»

Operazioni incluse (5)
delete_personsfind_persons_indicesget_personsread_personsset_persons
sites

Siti con sessione

5 operazioni documentate

Apre una sessione browser persistente, raggiunge il login con credenziali protette, legge lo stato della pagina e compie azioni web a mandato ristretto.

Durante una raccolta può tornare direttamente a una pagina già raggiunta e verificarne contenuto e contesto prima di continuare. Se la verifica fallisce, ripercorre il percorso precedente entro i limiti della sessione.

Per fatture di un anno preciso, il passaggio a un anno precedente può fermare la ricerca nello stesso elenco quando le date e il loro ordine sono verificabili. I dettagli delle fatture richieste restano da leggere. Le viste dello stesso documento possono essere unite usando il collegamento osservato al dettaglio; data e importo uguali da soli non provano un doppione. La verifica delle righe scritte non certifica la completezza dell'archivio.

Limiti. Le credenziali sono iniettate dal broker e non mostrate al modello. Azioni sensibili richiedono conferma.

Puoi scrivere in chat, per esempio:«Accedi al portale del corriere e dimmi dove si trova la spedizione 12345.»

Puoi scrivere in chat, per esempio:«Apri il sito della banca, scarica l'estratto conto di giugno e fermati prima di qualsiasi disposizione.»

Operazioni incluse (5)
act_sitesdelete_siteslogin_sitesopen_sitesread_sites
05

Collaborazione e fornitori

Estensioni e oggetti di lavoro condiviso.

workflows

Automazioni remote

2 operazioni documentate

Avvia le automazioni già presenti in un repository ed elenca le loro esecuzioni con esito, ramo e durata.

Limiti. È distinto dalle attività programmate, che sono lo scheduler interno di Metnos, e dai processi, che sono software in esecuzione su una macchina.

Puoi scrivere in chat, per esempio:«Avvia l'automazione ci.yml di acme/app sul ramo principale.»

Puoi scrivere in chat, per esempio:«Mostrami le ultime esecuzioni fallite delle automazioni di acme/app.»

Operazioni incluse (2)
find_workflowsrun_workflows
issues

Issue

5 operazioni documentate

Attraverso la skill di un fornitore, cerca, legge, crea, aggiorna o chiude segnalazioni di progetto con stato, etichette e assegnatari.

Limiti. Il fornitore qui documentato è GitHub e richiede credenziali configurate; le capacità effettive dipendono dalle skill ammesse nell'istanza.

Puoi scrivere in chat, per esempio:«Nel repository metnos trova le issue aperte con etichetta bug create nell'ultima settimana.»

Puoi scrivere in chat, per esempio:«Crea una issue nel repository acme/app con questo titolo e assegnala a chi segue il rilascio.»

Operazioni incluse (5)
create_issuesdelete_issuesfind_issuesread_issuesset_issues
pulls

Pull request

4 operazioni documentate

Cerca e legge pull request, differenze nel codice e stato della revisione; aggiorna o integra una richiesta quando il fornitore e il mandato lo consentono.

Limiti. È distinto dalle issue perché comprende modifiche al codice, revisione e integrazione. Le operazioni che producono effetti sono soggette a vaglio.

Puoi scrivere in chat, per esempio:«Mostrami le pull request aperte di acme/app che modificano la cartella security.»

Puoi scrivere in chat, per esempio:«Leggi il diff della PR 42, riassumi i rischi e fermati prima del merge.»

Operazioni incluse (4)
change_pullsfind_pullsread_pullsset_pulls
comments

Commenti

2 operazioni documentate

Scrive e cancella commenti sugli elementi di discussione di un fornitore: segnalazioni e proposte di modifica.

Limiti. Un commento non è posta: non ha destinatario, cartella né consegna. Approvare o chiedere modifiche a una proposta è invece un verdetto e appartiene a Pull request.

Puoi scrivere in chat, per esempio:«Scrivi sulla issue 42 di acme/app che il problema si presenta anche sulla versione nuova.»

Puoi scrivere in chat, per esempio:«Cancella il commento che ho lasciato per sbaglio sulla proposta 7.»

Operazioni incluse (2)
create_commentsdelete_comments
skills

Skill

2 operazioni documentate

Elenca e gestisce estensioni installate che possono aggiungere executor, fornitori e conoscenza specializzata al catalogo locale.

Limiti. Una skill viene ammessa attraverso verifica e policy; installarla non aggira vocabolario, sandbox o consenso.

Puoi scrivere in chat, per esempio:«Quali skill sono installate e quali risultano abilitate?»

Puoi scrivere in chat, per esempio:«Abilita la skill GitHub già installata e mostrami quali capacità aggiunge.»

Operazioni incluse (2)
list_skillsset_skills
07

Controllo e amministrazione

Osservabilità, consenso, sicurezza e configurazione.

processes

Processi e salute del sistema

3 operazioni documentate

Ottiene uno snapshot dei processi e dei segnali di salute del sistema locale o di un dispositivo eleggibile.

Limiti. È osservazione, non amministrazione shell arbitraria: le azioni disponibili restano quelle degli executor ammessi.

Puoi scrivere in chat, per esempio:«Quali processi stanno usando più memoria su questo server?»

Puoi scrivere in chat, per esempio:«Controlla la salute del PC dello studio e mostrami eventuali processi anomali.»

Operazioni incluse (3)
get_processesrun_processesset_processes
signatures

Firme di sicurezza

3 operazioni documentate

Calcola, consulta e cura firme canoniche usate per classificare comandi e azioni di sistema in policy ammesse, dubbie o vietate.

Limiti. È un dominio amministrativo di sicurezza, non la firma crittografica dei documenti dell'utente.

Puoi scrivere in chat, per esempio:«Mostrami le signature attualmente in graylist e la loro classificazione.»

Puoi scrivere in chat, per esempio:«Calcola la signature canonica del comando proposto senza eseguirlo.»

Operazioni incluse (3)
compute_signaturesget_signaturesset_signatures
proposals

Proposte di evoluzione

1 operazione documentata

Espone proposte locali in attesa di revisione. Il processo notturno corrente propone deduplicazioni; generalizzazioni e specializzazioni restano consultabili soltanto nei registri storici.

Limiti. Consultare una proposta non la approva. Accettazione, rifiuto e ripristino avvengono nelle pagine amministrative previste.

Puoi scrivere in chat, per esempio:«Mostrami le proposte di deduplicazione ancora da revisionare.»

Puoi scrivere in chat, per esempio:«Spiegami questa proposta, i rischi e come raggiungo la pagina per approvarla.»

Operazioni incluse (1)
get_proposals
inputs

Richiesta di dati strutturati

1 operazione documentata

Raccoglie in modo tipizzato informazioni mancanti tramite dialoghi e moduli, inclusi scelte, date, file e campi sensibili.

Limiti. È una capacità di interazione usata dentro un'operazione; di norma l'utente non la invoca per nome.

Puoi scrivere in chat, per esempio:«Prepara una nuova casella di posta e chiedimi in un modulo server, porta e nome utente che mancano.»

Puoi scrivere in chat, per esempio:«Crea l'evento; se non sai quale calendario usare, fammi scegliere tra quelli disponibili.»

Operazioni incluse (1)
get_inputs
approval

Approvazione umana

1 operazione documentata

Presenta una scelta Approva/Disapprova e prosegue sul ramo consentito, preservando anteprima, attore e tracciabilità.

Limiti. È un vaglio, non una scorciatoia: l'approvazione non amplia l'autorità dell'executor e non rende lecita un'azione vietata.

Puoi scrivere in chat, per esempio:«Prepara la cancellazione dei file duplicati, mostrami l'elenco e chiedimi approvazione prima di procedere.»

Puoi scrivere in chat, per esempio:«Se il preventivo supera 500 euro, fermati e chiedimi conferma.»

Operazioni incluse (1)
get_approval
credentials

Credenziali

3 operazioni documentate

Configura, elenca attraverso i metadati ed elimina associazioni cifrate per caselle di posta, API, servizi cloud e siti autenticati.

Limiti. I segreti in chiaro non tornano al pianificatore o al Tutor. Più account dello stesso tipo restano selezionabili tramite associazioni distinte.

Puoi scrivere in chat, per esempio:«Configura una seconda casella IMAP chiamata personale e chiedimi le credenziali in modo protetto.»

Puoi scrivere in chat, per esempio:«Quali account email e servizi cloud sono configurati, senza mostrare alcun segreto?»

Operazioni incluse (3)
delete_credentialsfind_credentialsset_credentials
preferences

Preferenze personali

3 operazioni documentate

Elenca, imposta e rimuove le preferenze con cui l'utente decide come Metnos si comporta con lui: lunghezza e tono della risposta, unità di misura, lingua, modalità del browser.

Limiti. Chiavi e valori formano un vocabolario chiuso, e ciascuno vede soltanto le proprie preferenze. Una preferenza registrata ma non ancora applicata da nessun percorso di risposta viene dichiarata come tale.

Puoi scrivere in chat, per esempio:«Che preferenze ho impostato?»

Puoi scrivere in chat, per esempio:«D'ora in poi rispondimi in modo sintetico.»

Operazioni incluse (3)
delete_preferencesget_preferencesset_preferences
01

Funzioni trasversali

Funzioni di supporto comuni a più domini.

_system

Funzioni trasversali

5 operazioni documentate

Fornisce data e ora affidabili, ultima posizione osservata, annullamento dell'ultimo turno reversibile e consultazione esperta quando ammessa.

Limiti. Sono funzioni trasversali, non nuovi domini di dati. L'annullamento opera soltanto sugli effetti per i quali è stata registrata un'operazione inversa.

Puoi scrivere in chat, per esempio:«Che ore sono adesso a Tokyo?»

Puoi scrivere in chat, per esempio:«Annulla le operazioni reversibili del mio ultimo turno.»

Operazioni incluse (5)
consult_frontierget_locationget_nowstart_lreundo_last_turn

Servizi collegati e disponibilità

Lo stesso ambito può usare servizi diversi. Per esempio, la posta può passare da una casella IMAP/SMTP o da Google Workspace; i file possono essere locali o conservati in un servizio collegato. Credenziali, skill e permessi stabiliscono quali collegamenti siano disponibili. Quando un’operazione consente di scegliere il fornitore, questo è un parametro della richiesta: non serve un comando diverso per ogni servizio. Il Tutor consulta il catalogo corrente della tua istanza prima di indicare che cosa puoi usare.