Preparate la vostra knowledge base per un recupero delle informazioni tramite IA più rapido e preciso.

Il vostro Agente IA è efficace solo quanto le informazioni che riesce a trovare sono altrettanto efficaci. Quando si configura un Agente IA, una delle sfide maggiori è la preparazione delle basi di conoscenza che utilizzerà. I formati tradizionali come PDF, documenti Word, fogli di calcolo e presentazioni sono progettati per la lettura umana. Non sono sempre facili da elaborare per l’IA. Questo può creare problemi:

  • Le intestazioni possono separarsi dal testo a cui appartengono.
  • Le tabelle possono perdere la loro struttura.
  • È possibile che si perdano contesti importanti.
  • L’Agente IA potrebbe recuperare la parte sbagliata di un documento.

Per evitare ciò, utilizzate file Markdown (.md) per le basi di conoscenza del vostro Agente IA.

Markdown (.md)

Il Markdown mantiene i documenti puliti, strutturati e facili da leggere. Funziona bene per le persone e fornisce all’Agente IA contenuti più chiari da cercare e da cui recuperare informazioni.

Perché il Markdown funziona meglio

Il Markdown rimuove la formattazione non necessaria e mantiene chiara la struttura del documento. Utilizza semplici marcatori di testo per intestazioni, elenchi, tabelle e sezioni. Questo aiuta l’Agente IA a comprendere come sono organizzate le informazioni.

  • Intestazioni chiare: Le intestazioni Markdown come #, ## e ### creano una struttura chiara. Questo aiuta a mantenere uniti argomenti e sottoargomenti.
  • Tabelle leggibili: Le tabelle Markdown mantengono allineate righe e colonne, rendendo più facili da elaborare specifiche di prodotto, requisiti di configurazione e tabelle comparative.
  • Contenuto più pulito: Il Markdown rimuove la formattazione nascosta e i dati di layout aggiuntivi presenti nei file office tradizionali.
  • Recupero più rapido: File più puliti possono aiutare a ridurre la quantità di testo elaborato e rendere il recupero più efficiente.
  • Meno risposte errate: Fonti di conoscenza meglio strutturate aiutano l’Agente IA a trovare le informazioni corrette in modo più affidabile.

Convertire i documenti esistenti in Markdown

Non è necessario riscrivere ogni file manualmente. Strumenti open source come MarkItDown e Docling possono aiutare a convertire i file esistenti in Markdown strutturato. Questi strumenti possono elaborare i formati più comuni come:

  • .docx
  • .pptx
  • .xlsx
  • PDF

Possono anche aiutare a preservare l’ordine di lettura, convertire le tabelle nel formato Markdown ed estrarre contenuti da layout di documenti più complessi.

Esempio di preparazione di documenti Markdown per il tuo Agente IA

Aprite il terminale per configurare un ambiente Python pulito e installare lo strumento richiesto.

# Create e attivate un ambiente virtuale
python3 -m venv .venv
source .venv/bin/activate# Installa MarkItDown con il supporto per tutti i formati
pip install ‘markitdown[all]’

Una volta installato, potete convertire un file direttamente dalla riga di comando o inserirlo nel vostro flusso di lavoro di dati automatizzato utilizzando la riga di comando:

markitdown internal_kb_report.pdf > internal_kb_report.md

…o utilizzando il codice Python:

from markitdown import MarkItDown

# Inizializzate il convertitore
md_converter = MarkItDown()

# Convertite un file con layout complesso in Markdown strutturato
result = md_converter.convert(“product_specs.docx”)

# Date un’occhiata al testo pulito e leggibile dalla macchina
print(result.text_content)

Regole di formattazione Markdown

Quando create o modificate file Markdown per le fonti di conoscenza dell’Agente IA, seguite queste regole:

  • Non saltare i livelli di intestazione: Mantenete le intestazioni in ordine. Non passare da # direttamente a ###.
  • Lascia spazio attorno alle tabelle: Aggiungete una riga vuota prima e dopo ogni tabella Markdown.
  • Aggiungi il contesto in alto: Utilizzate un breve blocco di metadati dove utile, in modo che l’Agente IA comprenda l’argomento del file.

Esempio:

—
category: Documentazione tecnica
product: PBX 3CX V20
audience: Amministratori di sistema
last_updated: 2026-06-01
—# Configurazione delle knowledge base per l’Agente IA
…

Basi di conoscenza più pulite aiutano il vostro Agente IA a fornire risposte migliori. Rivedete i vostri file esistenti, converti i documenti chiave in Markdown e verificate che intestazioni, tabelle e metadati siano chiari prima di assegnarli a un Agente IA.

Forum 3CX

Partecipate alla discussione 3CX nei nostri forum dedicati ai Partner o ai Clienti. Seguiteci su X e LinkedIn per rimanere aggiornati sulle ultime novità e sui rilasci di funzionalità.