Questa guida spiega come abilitare e utilizzare il supporto nativo per PDF e allegati di documenti quando si interagisce con i bot AI in Discourse. Gli utenti possono caricare PDF e altri documenti direttamente nelle conversazioni con le persone AI.
Livello utente richiesto: Amministratore
Sommario
Discourse AI ora supporta la gestione nativa degli allegati, consentendo agli utenti di caricare PDF e altri tipi di documenti direttamente durante la conversazione con i bot AI. L’AI può leggere e comprendere il contenuto di questi allegati, abilitando casi d’uso come l’analisi di documenti, la sintesi e la risposta a domande basate sui file caricati.
Questa funzionalità richiede:
- Un modello LLM con la visione abilitata
- Tipi di allegati consentiti configurati sull’LLM
- Una persona che supporti la visione
- L’estensione del file deve essere autorizzata nelle impostazioni di caricamento del tuo sito
Fornitori supportati
Il supporto nativo per gli allegati funziona con i modelli dei seguenti fornitori:
- Anthropic (modelli Claude)
- Google (modelli Gemini)
- OpenAI (modelli GPT)
Ogni fornitore gestisce gli allegati in modo diverso a livello di API, ma Discourse AI lo gestisce automaticamente. Tieni presente che fornitori diversi implementano diversi livelli di supporto per vari tipi di allegati.
Tipi di allegati supportati
I seguenti tipi di documenti possono essere configurati per l’elaborazione AI:
| Tipo | Estensioni |
|---|---|
pdf |
|
| Testo semplice | txt |
| Microsoft Word | doc, docx |
| Rich Text Format | rtf |
| HTML | html, htm |
| Markdown | md, markdown |
Le immagini sono gestite separatamente tramite l’impostazione “Visione abilitata” e non richiedono la configurazione del tipo di allegato.
Configurazione
Passaggio 1: Autorizzare le estensioni dei file per il caricamento
Prima che gli utenti possano caricare allegati, assicurati che le estensioni dei file siano autorizzate nelle impostazioni del tuo sito.
- Naviga su Admin → Files
- Trova l’impostazione
authorized extensions(estensioni autorizzate) - Aggiungi le estensioni che desideri consentire (es.
pdf|txt|docx)
Passaggio 2: Configurare il modello LLM
- Naviga su Admin → Plugins → Discourse AI → LLMs
- Seleziona il modello LLM che desideri configurare (o creane uno nuovo)
- Abilita Vision enabled (Visione abilitata) - questo è richiesto per il supporto degli allegati
- Nel campo Allowed attachments (Allegati consentiti), seleziona o digita le estensioni di file che desideri che il modello accetti (es.
pdf,txt,docx)
Se lasci vuoto il campo “Allowed attachments”, gli allegati di documenti verranno disabilitati per quel modello. Le immagini sono controllate separatamente tramite l’interruttore “Vision enabled”.
Passaggio 3: Configurare la persona
- Naviga su Admin → Plugins → Discourse AI → AI Personas
- Seleziona o crea una persona
- Assicurati che Vision support (Supporto visione) sia abilitato per la persona
- Imposta Default model (Modello predefinito) su un LLM che abbia la visione e gli allegati configurati
Come funziona
Quando un utente carica un documento in una conversazione con un bot AI:
- Il documento viene caricato su Discourse utilizzando la gestione standard dei caricamenti
- Discourse AI codifica il contenuto del documento (base64)
- Il contenuto codificato viene inviato all’LLM insieme al messaggio dell’utente
- L’LLM elabora sia il messaggio di testo che il contenuto del documento
- L’AI risponde in base al contesto combinato
Dettagli tecnici
- I documenti vengono codificati come base64 e inviati in linea con la richiesta
- Ogni fornitore riceve gli allegati nel proprio formato nativo:
- Anthropic: Utilizza il tipo
documentcon sorgente base64 - Gemini: Utilizza il formato
inlineData - OpenAI: Utilizza il tipo
fileconfile_datacontenente il contenuto base64
- Anthropic: Utilizza il tipo
- I limiti di dimensione dei file sono regolati dall’impostazione del tuo sito
max attachment size kb(dimensione massima allegato in kb)
Casi d’uso
Il supporto nativo per gli allegati abilita diversi flussi di lavoro:
- Analisi di documenti: Carica contratti, report o documenti di ricerca affinché l’AI li riassuma o risponda a domande su di essi
- Revisione dei contenuti: Chiedi all’AI di rivedere e fornire feedback sui documenti bozza
- Estrazione di dati: Estrai informazioni specifiche da documenti caricati
- Assistenza alla traduzione: Carica documenti in una lingua e discuti il contenuto o richiedi traduzioni
- Supporto tecnico: Gli utenti possono caricare file di log o file di configurazione per assistenza nella risoluzione dei problemi
Limitazioni
- Dimensione del file: Gli allegati sono limitati dalle impostazioni di dimensione di caricamento del tuo sito e dal fornitore LLM
- Supporto del fornitore: Solo i modelli Anthropic, Google e OpenAI supportano attualmente gli allegati
- Requisito visione: L’LLM deve avere abilitate le capacità di visione
- Corrispondenza estensione: L’estensione del file deve essere sia autorizzata per il caricamento sul tuo sito sia consentita nella configurazione dei tipi di allegati dell’LLM
- I risultati variano: Poiché i fornitori LLM e gli LLM elaborano i file, il costo/accuratezza e i risultati varieranno. Anthropic tende a utilizzare più token per l’analisi rispetto a OpenAI o Google.
- Abilita la cache: Per Open AI assicurati di utilizzare l’API delle risposte che offre un supporto più coerente per la cache (quando il pensiero è abilitato); per i modelli Anthropic potrebbe essere necessario abilitare esplicitamente la cache nella configurazione LLM. Questo può essere particolarmente importante quando si hanno conversazioni a più turni.
Risoluzione dei problemi
Gli allegati non vengono elaborati
- Verifica che l’estensione del file sia presente nell’impostazione
authorized extensionsdel tuo sito - Controlla che l’LLM abbia attivato “Vision enabled”
- Conferma che il tipo di file sia elencato nell’impostazione “Allowed attachments” dell’LLM
- Assicurati che la persona abbia il supporto visione abilitato e utilizzi un LLM configurato correttamente
Il caricamento fallisce
- Controlla l’impostazione
max attachment size kb - Verifica che l’estensione del file sia autorizzata
- I PDF molto grandi potrebbero non essere supportati; ogni fornitore LLM ha diverse dimensioni massime di caricamento.
L’AI non capisce il documento
- Assicurati di utilizzare un modello che supporti la comprensione dei documenti
- Prova un modello più capace (es. Claude Sonnet 4.5, GPT-5.1, Gemini Pro 3)
FAQ
Gli utenti possono caricare più documenti in un unico messaggio?
Sì, gli utenti possono includere più allegati in un singolo messaggio e l’AI avrà accesso a tutti.
Funziona sia in chat che nei messaggi privati?
Sì, il supporto per gli allegati funziona sia nei messaggi privati con i bot AI sia nei messaggi diretti in chat, a condizione che la persona sia configurata per tali metodi di interazione.
È diverso dai caricamenti RAG sulle persone?
Sì. I caricamenti RAG sono documenti aggiunti dagli amministratori alla base di conoscenza di una persona, che vengono indicizzati e cercati. Il supporto nativo per gli allegati consente agli utenti finali di caricare documenti durante le conversazioni per un’analisi immediata senza indicizzazione.
Cosa succede ai documenti caricati?
I documenti vengono elaborati in base alla gestione standard dei caricamenti e alle politiche di conservazione del tuo sito. Vengono archiviati come caricamenti Discourse normali.