Assistant DocAI/Canali e integrazioni: differenze tra le versioni

Riga 12:

== Webhook ==

In {{Percorso menu|Configurazione|Webhook}} registri gli indirizzi da avvisare quando un documento ~~arriva, è pronto o viene consegnato~~. Le notifiche sono firmate; si possono ~~provare~~ e reinviare.

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 ==

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.

[[Categoria:Intelligenza artificiale]]

[[Categoria:Guide]]

@@ Riga 12: / Riga 12: @@
 == Webhook ==
-In {{Percorso menu|Configurazione|Webhook}} registri gli indirizzi da avvisare quando un documento arriva, è pronto o viene consegnato. Le notifiche sono firmate; si possono provare e reinviare.
+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 ==
-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}}
 [[Categoria:Intelligenza artificiale]]
 [[Categoria:Guide]]