Assistant DocAI/Canali e integrazioni: differenze tra le versioni
AdA, Connettore MCP e Assistant DocAI |
DocAI: eventi webhook e strumenti AI |
||
| Riga 12: | Riga 12: | ||
== Webhook == | == Webhook == | ||
In {{Percorso menu|Configurazione|Webhook}} registri gli indirizzi da avvisare quando un documento | In {{Percorso menu|Configurazione|Webhook}} registri gli indirizzi da avvisare quando succede qualcosa a un documento. Le notifiche sono '''firmate''' (il programma che le riceve può verificare che arrivano da DocAI); ogni sottoscrizione si può provare, i singoli invii si possono rivedere e reinviare, e il segreto di firma si può rinnovare. In alternativa ai webhook, un programma può leggere gli stessi eventi in ''polling'' dall'API. | ||
{| class="wikitable" | |||
! Evento !! Quando | |||
|- | |||
| <code>document.received</code> || Un documento è stato creato (anche i documenti nati dalla divisione di un PDF). | |||
|- | |||
| <code>document.ready_for_review</code> || Il documento è pronto per la revisione. | |||
|- | |||
| <code>document.approved</code> / <code>document.rejected</code> || Il documento è stato approvato o rifiutato. | |||
|- | |||
| <code>document.delivered</code> || Il documento è stato consegnato a tutte le destinazioni. | |||
|- | |||
| <code>delivery.succeeded</code> || Una consegna è riuscita. | |||
|- | |||
| <code>delivery.uncertain</code> || L'esito di una consegna è incerto: va verificato nella destinazione. | |||
|- | |||
| <code>delivery.failed</code> || La consegna non è riuscita dopo i tentativi. | |||
|- | |||
| <code>document.superseded</code> || Il documento è stato sostituito da altri dopo aver corretto la divisione delle pagine. | |||
|- | |||
| <code>document.purged</code> || Il documento è stato eliminato (diritto all'oblio o fine del periodo di conservazione). | |||
|} | |||
== Intelligenza artificiale == | == Intelligenza artificiale == | ||
Tramite il [[Connettore MCP]], [[AdA]] e gli altri assistenti AI possono lavorare con DocAI per conto dell'utente e con i suoi permessi. | Tramite il [[Connettore MCP]], [[AdA]] e gli altri assistenti AI possono lavorare con DocAI per conto dell'utente e con i suoi permessi: | ||
{| class="wikitable" | |||
! Cosa !! Strumenti | |||
|- | |||
| Inviare documenti e seguirne lo stato || <code>docai_submit_document</code>, <code>docai_get_submission</code> | |||
|- | |||
| Cercare e leggere i documenti || <code>docai_list_documents</code>, <code>docai_search_documents</code>, <code>docai_get_document</code>, <code>docai_get_context</code> | |||
|- | |||
| Revisionare || <code>docai_correct_field</code>, <code>docai_approve_document</code>, <code>docai_reject_document</code> | |||
|- | |||
| Consegne || <code>docai_list_deliveries</code>, <code>docai_retry_delivery</code> | |||
|- | |||
| Configurare (solo bozze, pubblichi tu) || <code>docai_draft_reading_instruction</code>, <code>docai_draft_rule</code>, <code>docai_draft_output_mapping</code> | |||
|- | |||
| Consumi || <code>docai_get_usage</code> | |||
|} | |||
Con una chiave API (senza utente) l'AI può solo leggere: le operazioni che modificano dati richiedono l'accesso con l'account dell'utente. | |||
{{Navbox Assistant DocAI}} | {{Navbox Assistant DocAI}} | ||
[[Categoria:Intelligenza artificiale]] | [[Categoria:Intelligenza artificiale]] | ||
[[Categoria:Guide]] | [[Categoria:Guide]] | ||
Versione attuale delle 00:38, 7 nov 2026
In breve. I canali da cui Assistant DocAI riceve i documenti (caricamento, API, caselle Microsoft 365, IMAP e PEC, cartelle SFTP), i profili dei mittenti, le chiavi API, i webhook per avvisare i programmi esterni e gli strumenti per l'intelligenza artificiale.
Si applica a: Assistant DocAI
Canali
In attivi e configuri le fonti dei documenti (vedi Caricare i documenti). Per le caselle Microsoft 365 serve la registrazione dell'app nel tenant Microsoft dell'azienda: la prepara QCSNET con il vostro amministratore IT.
Mittenti
In vedi, per ogni mittente, il tipo di documento che DocAI ha imparato dalle classificazioni dei revisori, e puoi disattivarlo.
API
I programmi esterni possono inviare documenti e leggere stato e risultati con una chiave API di DocAI. La documentazione tecnica dell'API (OpenAPI) è disponibile su richiesta all'assistenza QCSNET.
Webhook
In registri gli indirizzi da avvisare quando succede qualcosa a un documento. Le notifiche sono firmate (il programma che le riceve può verificare che arrivano da DocAI); ogni sottoscrizione si può provare, i singoli invii si possono rivedere e reinviare, e il segreto di firma si può rinnovare. In alternativa ai webhook, un programma può leggere gli stessi eventi in polling dall'API.
| Evento | Quando |
|---|---|
document.received |
Un documento è stato creato (anche i documenti nati dalla divisione di un PDF). |
document.ready_for_review |
Il documento è pronto per la revisione. |
document.approved / document.rejected |
Il documento è stato approvato o rifiutato. |
document.delivered |
Il documento è stato consegnato a tutte le destinazioni. |
delivery.succeeded |
Una consegna è riuscita. |
delivery.uncertain |
L'esito di una consegna è incerto: va verificato nella destinazione. |
delivery.failed |
La consegna non è riuscita dopo i tentativi. |
document.superseded |
Il documento è stato sostituito da altri dopo aver corretto la divisione delle pagine. |
document.purged |
Il documento è stato eliminato (diritto all'oblio o fine del periodo di conservazione). |
Intelligenza artificiale
Tramite il Connettore MCP, AdA e gli altri assistenti AI possono lavorare con DocAI per conto dell'utente e con i suoi permessi:
| Cosa | Strumenti |
|---|---|
| Inviare documenti e seguirne lo stato | docai_submit_document, docai_get_submission
|
| Cercare e leggere i documenti | docai_list_documents, docai_search_documents, docai_get_document, docai_get_context
|
| Revisionare | docai_correct_field, docai_approve_document, docai_reject_document
|
| Consegne | docai_list_deliveries, docai_retry_delivery
|
| Configurare (solo bozze, pubblichi tu) | docai_draft_reading_instruction, docai_draft_rule, docai_draft_output_mapping
|
| Consumi | docai_get_usage
|
Con una chiave API (senza utente) l'AI può solo leggere: le operazioni che modificano dati richiedono l'accesso con l'account dell'utente.
| Guide di Assistant DocAI | |
|---|---|
| Introduzione | Come funziona |
| Lavoro quotidiano | Inbox e revisione · Caricare i documenti |
| Configurazione | Lettura · Automazioni · Uscita · Canali e integrazioni |
| Collegati | AdA · Connettore MCP · Assistant Evolution |