ParsePilot
Sezione: CRM URL:
/admin/parsepilotTitolo pagina: ParsePilot
Panoramica
ParsePilot è un modulo di analisi documenti basato su intelligenza artificiale che utilizza l'API OpenAI per estrarre dati strutturati da file caricati — PDF e immagini — e mappare automaticamente i valori estratti nei record CRMconnect. Il personale carica una fattura scansionata, una ricevuta o un documento simile tramite un'interfaccia modale; ParsePilot invia il file a OpenAI, riceve i campi analizzati e precompila il modulo pertinente in modo che il record possa essere rivisto e salvato senza inserimento manuale dei dati.
Il modulo supporta file fino a 500 MB, accetta PDF e formati immagine comuni (PNG, JPG, JPEG, WebP, TIFF), e può essere limitato a pagine o tipi di documento specifici tramite il pannello impostazioni. Una soglia di confidenza opzionale filtra le estrazioni di campi a bassa confidenza prima che raggiungano l'utente.
Valore aziendale
Inserire manualmente i dati da fatture fornitori, ricevute o altri documenti in entrata nel CRM è lento e soggetto a errori. ParsePilot elimina la maggior parte di questo lavoro convertendo una scansione caricata in un modulo precompilato in pochi secondi, consentendo al personale di concentrarsi sulla revisione e approvazione piuttosto che sulla digitazione.
- Chi lo utilizza: Personale finanziario e di back-office che elabora documenti in entrata (fatture, ordini di acquisto, ricevute); amministratori che configurano la connessione OpenAI e le autorizzazioni di pagina.
- Vantaggio chiave: Estrazione dati basata su IA da documenti scansionati o digitali direttamente nei moduli CRMconnect, riducendo i tempi di inserimento manuale e gli errori di input.
Casi d'uso tipici:
- Caricare un PDF di fattura fornitore; ParsePilot estrae nome fornitore, data, voci e totali, quindi precompila il modulo spese o acquisto.
- Caricare una foto di una ricevuta e fare estrarre automaticamente l'importo e la data.
- Limitare l'analisi documenti a pagine CRMconnect specifiche (es. solo sulle schermate fatture o spese) tramite il pannello impostazioni.
- Impostare una soglia di confidenza in modo che vengano accettate solo le estrazioni di campi ad alta confidenza — i valori incerti vengono lasciati vuoti per la revisione manuale.
- Abbinare un'aliquota IVA/fiscale analizzata a un record fiscale esistente in CRMconnect usando l'endpoint di ricerca fiscale integrato.
Accesso al modulo
/admin/parsepilot/settings — la pagina impostazioni è il punto di accesso principale (il percorso indice restituisce 404). L'interfaccia modale è incorporata nelle pagine dove l'analisi è abilitata e non è accessibile direttamente tramite URL.
Solo gli amministratori possono accedere alla pagina impostazioni e salvare la configurazione. Il personale con il permesso di creazione parsepilot può avviare l'analisi documenti dal modale.
Concetti chiave
| Concetto | Descrizione |
|---|---|
| Chiave API OpenAI | La chiave segreta utilizzata per autenticare le chiamate al servizio OpenAI per l'analisi documenti. |
| Tipo di documento | La categoria del documento da analizzare (es. invoice). Determina quali campi l'IA tenta di estrarre. |
| Soglia di confidenza | Un valore tra 0,0 e 1,0. I campi estratti al di sotto di questo punteggio vengono eliminati prima della presentazione all'utente. |
| Pagine abilitate | Un elenco separato da virgole di identificatori di pagina CRMconnect dove il modale ParsePilot è disponibile. |
| Lingue | Suggerimento/i passato/i all'IA indicante/i la/e lingua/e prevista/e dei documenti caricati, migliorando la precisione dell'estrazione. |
| Modale di analisi | L'overlay nella pagina attivato nelle pagine abilitate che consente al personale di caricare un file e rivedere i campi estratti. |
| Ricerca fiscale | Una chiamata API interna (/admin/parsepilot/find_tax_by_rate) che abbina un'aliquota fiscale analizzata a un record fiscale esistente nel database. |
| Formati supportati | PDF e file immagine (PNG, JPG, JPEG, WebP, TIFF e altri tipi MIME corrispondenti a image/*). |
| Dimensione massima upload | 500 MB per file. |
Azioni comuni
- Configurare la chiave OpenAI — Andare su
/admin/parsepilot/settings, inserire la chiave API OpenAI, impostare la/e lingua/e prevista/e del documento e salvare. - Impostare una soglia di confidenza — Nelle impostazioni, inserire un valore decimale tra 0 (accetta tutto) e 1 (solo estrazioni perfettamente certe). I valori al di fuori di questo intervallo vengono limitati automaticamente.
- Abilitare l'analisi su pagine specifiche — Nelle impostazioni, selezionare o inserire gli identificatori di pagina CRMconnect dove il modale ParsePilot deve apparire, quindi salvare.
- Analizzare un documento — Su una pagina abilitata (es. nuova fattura), fare clic sull'icona o sul pulsante ParsePilot per aprire il modale, caricare un PDF o un'immagine e attendere che l'IA restituisca i campi estratti. Rivedere i valori precompilati, apportare correzioni se necessario, quindi salvare il record normalmente.
- Rivedere i campi a bassa confidenza — I campi che scendono al di sotto della soglia di confidenza configurata non vengono precompilati; il personale deve inserirli manualmente, il che è un passaggio deliberato di controllo della qualità.
- Abbinare un'aliquota fiscale analizzata — ParsePilot chiama automaticamente l'endpoint di ricerca fiscale per trovare un'aliquota IVA corrispondente in CRMconnect e collegarla alle voci analizzate; se non viene trovata alcuna corrispondenza, viene mostrato un errore di mancata corrispondenza e il campo fiscale deve essere selezionato manualmente.
Fonte: crm-connect-main/app/modules/parsepilot