Verifica la visibilità della tua azienda nell’IA
Gratis, senza carta di credito.
Un cliente chiede le condizioni di un servizio. Sul sito trova una descrizione generale, in una guida una vecchia versione dell’offerta e nelle istruzioni un’eccezione che non aveva notato. Ogni risorsa può sembrare corretta, ma insieme non danno una risposta chiara. Anche un sistema di IA che usa questi contenuti deve risolvere le differenze.
Per questo, preparare conoscenza per l’IA significa prima di tutto chiarire il significato delle informazioni. Cosa descriviamo esattamente? Quando si applica una condizione? Qual è la sua fonte? Open Knowledge Format aiuta a registrare questa conoscenza in modo strutturato e trasferibile.
Cos’è Open Knowledge Format?
Open Knowledge Format, in breve OKF, è un formato aperto per registrare conoscenza destinata a persone e sistemi di IA. Google Cloud lo ha presentato il 12 giugno 2026. L’idea di partenza è semplice: conservare la conoscenza in file di testo che strumenti diversi possano leggere seguendo regole comuni.
La base è costituita da documenti Markdown, cioè testo con una notazione semplice per titoli, elenchi e link. All’inizio del documento si trova un blocco YAML con metadati, brevi campi che ne descrivono il contenuto. Un insieme di questi file può rappresentare definizioni di metriche, descrizioni di dati, procedure o regole di un servizio.
Il formato non richiede un cloud o un modello di IA specifico. Serve a facilitare lo scambio di conoscenza tra strumenti. Salvare un’informazione in OKF non significa, di per sé, che un sistema esterno l’abbia recuperata o utilizzata.
Fonte: Google Cloud - introduzione a Open Knowledge Format
L’articolo di Google descrive la versione 0.1. Cosa cambia nella 0.2?
L’articolo di Google è una buona introduzione, ma descrive la versione iniziale 0.1. La specifica consultata il 13 ottobre 2026 riporta già la versione 0.2. Il progetto ha anche un proprio repository. La vecchia copia nella cartella knowledge-catalog/okf non viene più mantenuta.
La versione 0.2 amplia la descrizione della provenienza, della verifica e dell’aggiornamento della conoscenza. Permette di indicare, tra l’altro, le fonti, come il contenuto è stato preparato e confermato e lo stato del documento. È utile quando gli agenti IA creano o aggiornano parte dei contenuti.
Il campo type rimane l’unico sempre obbligatorio. Indica il tipo di informazione descritta. I campi aggiuntivi e le loro dipendenze vanno scelti secondo la specifica. Rispettare i requisiti minimi del formato non significa che il documento contenga tutto ciò che serve al lettore.
Fonte: specifica attuale di OKF 0.2
Avviso sul trasferimento del progetto in un repository separato
Come aiuta OKF a organizzare la conoscenza per l’IA?
Un documento descrive un concetto o un argomento. I link lo collegano ad altri documenti. La descrizione di una metrica può quindi rimandare alle definizioni dei dati, e le istruzioni alle condizioni a cui si applicano. I file possono essere controllati, gestiti per versioni e trasferiti tra sistemi.
Il repository mostra anche una separazione dei ruoli: uno strumento può preparare la conoscenza e un altro leggerla. Una raccolta di file può servire a un agente, un motore di ricerca interno o un visualizzatore di documentazione. In ogni implementazione occorre comunque garantire l’accesso ai contenuti e il supporto del formato da parte del sistema ricevente.
Fonte: repository di Open Knowledge Format
Schema illustrativo: i materiali di origine vengono verificati, inseriti in una base organizzata e possono essere letti da un sistema IA collegato. Elaborazione originale basata sulla documentazione OKF; grafica creata con l’IA.
La base di conoscenza Semly e OKF
Semly ha una base di conoscenza e usa Open Knowledge Format. È un aspetto importante del modo in cui si gestiscono le informazioni aziendali: bisogna curare sia il contenuto della risposta sia l’organizzazione della conoscenza che permette di costruirla.
Per chi si occupa di marketing, questo si traduce in un compito concreto. Raccogliere informazioni confermate sull’offerta, chiarire i termini ed eliminare le contraddizioni. Su questa base conviene costruire altre descrizioni, guide e risposte alle domande dei clienti.
Se gestisci un’azienda di servizi, parti dall’ambito del servizio, dai requisiti e dalle esclusioni. Se vendi prodotti, organizza utilizzi, caratteristiche e compatibilità. In entrambi i casi il lettore deve capire quando l’informazione si applica.
La base di conoscenza e il blog possono avere ruoli diversi. Nella base mantieni una risposta precisa a una domanda specifica. Un articolo del blog aiuta a capire il problema, confrontare approcci e decidere il passo successivo. Non serve duplicare tutte le istruzioni in entrambi i luoghi.
Leggi anche: come dividere gli argomenti tra blog e base di conoscenza
Esempio: cosa significa davvero «account attivo»?
Supponiamo che un team voglia usare l’IA per spiegare i report di un prodotto. In un documento, «account attivo» indica qualsiasi account con accesso valido. In un altro, indica un account su cui è stata eseguita un’azione specifica. Senza chiarimenti, le due descrizioni possono produrre risultati diversi.
I dati di esempio spiegano il metodo e non rappresentano i risultati di alcun marchio. Nell’esempio ci sono 80 account con accesso valido. Su 28 è stata eseguita almeno un’operazione approvata nella settimana analizzata. Se questa è la definizione di attività, la quota di account attivi è 28 ÷ 80 × 100% = 35%.
Nella base conviene quindi descrivere la definizione, l’evento che fa rientrare un account nel calcolo, il periodo e le esclusioni. Dire soltanto «l’attività è del 35%» non basta. Il lettore non sa cosa sia stato contato né se possa confrontare il valore con un altro report.
| Elemento di conoscenza | Descrizione nei dati di esempio | Perché registrarlo? |
|---|---|---|
| Definizione | Account con almeno un’operazione approvata durante la settimana | Distingue l’accesso al prodotto dal suo utilizzo |
| Base del calcolo | 80 account con accesso valido; 28 attivi | Permette di riprodurre il risultato del 35% |
| Esclusioni | Account di test esclusi da entrambi i gruppi | Evita di mescolare popolazioni diverse |
| Fonte e revisione | Definizione dell’evento identificata e persona responsabile della verifica | Facilita la spiegazione e gli aggiornamenti successivi |
La conclusione è semplice: prima concorda la definizione, poi valuta la risposta dell’IA. Se il sistema confonde un account attivo con un account che ha accesso, verifica che abbia ricevuto la descrizione corretta. Cambiare il formato del file non risolve una definizione non condivisa.
Cosa preparare nella base di conoscenza della tua azienda?
Parti da un’area in cui i malintesi ostacolano le decisioni dei clienti o il lavoro del team. Può essere l’ambito di un’implementazione, una condizione per usare una funzione o il significato di una metrica. Non serve rifare subito tutta la documentazione.
Lista editoriale per preparare i contenuti: significato, ambito, fonte, aggiornamento, eccezioni e collegamenti. È una proposta di lavoro sulle informazioni, non un elenco dei campi obbligatori di OKF. Elaborazione originale; grafica creata con l’IA.
- Scegli una domanda a cui il lettore deve ricevere una risposta univoca.
- Scrivi una breve definizione e le condizioni in cui si applica.
- Indica la fonte del fatto e la persona responsabile di confermarlo.
- Descrivi le eccezioni e collega l’argomento alle istruzioni necessarie.
- Elimina le versioni contraddittorie dai materiali che gestisci.
- Verifica la risposta del sistema alla domanda di base e a un caso limite.
Il caso limite è particolarmente utile. Se un servizio copre un certo tipo di dispositivo, chiedi anche di un modello non supportato. Una buona documentazione deve aiutare a riconoscere il limite, invece di favorire un ampliamento dell’offerta nella risposta.
OKF migliora la visibilità su Google e nelle risposte dell’IA?
OKF riguarda il modo di registrare e scambiare conoscenza. La visibilità nelle risposte pubbliche dell’IA dipende anche dall’accesso al materiale, dall’utilità che il sistema gli attribuisce e dal suo utilizzo per una domanda specifica. Adottare il formato non conferma che il marchio verrà consigliato.
Google spiega che i principi del SEO si applicano ad AI Overviews e AI Mode. Una pagina deve essere indicizzata e idonea a comparire con uno snippet di testo. Non servono file speciali per l’IA né un ulteriore tipo di dati strutturati. Soddisfare i requisiti non garantisce la visualizzazione.
Fonte: Google Search Central - funzionalità IA e sito web
Separa quindi i due compiti. Prima controlla che la base di conoscenza contenga risposte corrette e aggiornate. Poi valuta come viene presentata l’azienda nei sistemi pubblici di IA. Così puoi distinguere un problema del contenuto da una situazione in cui il materiale non è stato usato.
Da dove iniziare?
Scegli un’informazione sulla tua offerta che sia facile fraintendere. Registra significato, condizioni e fonte. Controlla che le stesse regole valgano nella base di conoscenza, nella pagina prodotto e nelle istruzioni.
Questo lavoro offre un punto di partenza concreto per usare OKF. Semly ha una base di conoscenza e usa il formato, ma la qualità delle informazioni parte sempre dai fatti. Più è semplice stabilire cosa significa una frase e quando è attuale, più è semplice verificarla e usarla in modo responsabile.
Fonti tecniche consultate il 13 ottobre 2026. La descrizione delle modifiche allo standard riguarda OKF 0.2; non indica la versione né l’ambito dell’implementazione di OKF in Semly.
Condividi:
