Agente operativo: esecuzioni, nuovi tentativi e report

Ogni volta che un trigger avvia l'agente viene registrata un'esecuzione. Le esecuzioni sopravvivono a riavvii e aggiornamenti: ogni passaggio viene salvato appena completato e un'esecuzione ripresa da un altro server continua da dove si era fermata.

Aprire un'esecuzione#

La pagina Esecuzioni dell'agente elenca ogni esecuzione con esito, trigger, quanto ha lavorato e quanto è costata. Aprite un'esecuzione per vedere ogni passaggio su una linea temporale:

• quanto è durato e quanti byte ha ricevuto e prodotto;
• il JSON ricevuto e prodotto, esattamente ciò che ha ottenuto il passaggio successivo;
• quando un endpoint remoto è fallito, cosa ha risposto l'altra parte (lo stato HTTP e l'inizio della risposta) e ogni tentativo fallito;
• le risposte del report e il download Excel, quando è stato eseguito un passaggio di report;
• il blocco Fatturazione dell'esecuzione: cosa ha gestito e quanto è costata.

Sulla lavagna, fate clic su un passaggio dopo un'esecuzione per vedere gli stessi dati nell'ispettore.

Stati dei passaggi#

• Completato, In esecuzione, In coda, In attesa (dei passaggi precedenti).
• In attesa di ripetizione: un passaggio è fallito e riproverà all'ora indicata; anche i passaggi successivi attendono. L'esecuzione riprende da sola.
• Fallito: il passaggio ha esaurito i tentativi. I passaggi successivi vengono saltati, a meno che non abbiate disegnato un ramo di errore.
• Saltato: il passaggio era su un ramo non seguito, oppure non aveva niente da fare, per esempio nessuna registrazione per una chiamata persa. Un'esecuzione i cui passaggi non avevano niente da fare si completa comunque.
• Parzialmente fallita sull'esecuzione: alcuni rami si sono completati e altri no.

Politica di nuovo tentativo#

Ogni passaggio ha una politica di nuovo tentativo (il pannello Politica di nuovo tentativo nell'ispettore): quanti tentativi, da 1 a 24, e quanti minuti tra l'uno e l'altro, da 1 a 1440. I valori predefiniti:

• passaggi che chiamano un endpoint remoto (webhook, distributore, download della registrazione, storage): 24 tentativi, uno all'ora, finché l'endpoint non risponde 2xx;
• trascrizione, riassunto ed e-mail: 3 tentativi a dieci minuti di distanza; report da domande: 2 tentativi a dieci minuti di distanza.

Un endpoint remoto ha ricevuto la chiamata quando risponde 2xx; qualsiasi altra risposta, o nessuna, è un tentativo fallito. Un'impostazione che solo voi potete correggere, come un destinatario mancante o un indirizzo non consentito, fallisce subito invece di riprovare tutto il giorno. Le ore in cui un'esecuzione attende una ripetizione non vengono fatturate.

In un'esecuzione, premete Riprova ora su un passaggio fallito o in attesa: viene rieseguito subito, poi tutto ciò che segue. Un webhook può, raramente, essere consegnato due volte; porta una chiave di idempotenza che il vostro endpoint può usare per ignorare il duplicato.

Log#

La pagina Log dell'agente mostra ogni passaggio delle ultime 100 esecuzioni su una riga, dal più recente, con il suo tentativo e il suo messaggio. Filtratela su Fallito o In attesa di ripetizione per vedere a colpo d'occhio cosa richiede attenzione; fate clic su una riga per aprire la sua esecuzione.

Tutte le esecuzioni del progetto#

Esecuzioni nel menu a sinistra della console elenca le esecuzioni di tutti gli agenti operativi del progetto in un periodo che scegliete (il mese corrente per impostazione predefinita), filtrabili per agente. Sopra l'elenco: il numero di esecuzioni, i minuti di automazione, i minuti del piano usati, il valore di listino e quanto è stato addebitato. Esporta in Excel scarica il periodo, fino a 5.000 esecuzioni per file; restringete le date per averne di più.

La dashboard può mostrare chiamate, esecuzioni o entrambe per giorno, settimana o mese: scegliete Operativi o Tutti gli agenti nel suo filtro per tipo di agente.

Quando qualcosa va storto#

• Un'esecuzione non è partita: verificate che l'agente sia attivo e abbia il trigger giusto. Per un trigger del centralino, aprite Integrazioni e verificate che il centralino risulti Connesso e che la chiamata compaia tra le sue chiamate recenti; la scheda Tutte le richieste dal centralino mostra ogni richiesta inviata dal centralino, comprese quelle rifiutate. Per un webhook, usate Ascolta per vedere se la richiesta arriva.
• Un passaggio continua a riprovare: aprite l'esecuzione e leggete Cosa ha risposto l'altra parte. Correggete l'endpoint, poi premete Riprova ora.
• Un valore arriva vuoto: aprite l'esecuzione, fate clic sul passaggio che avrebbe dovuto produrlo e controllate il nome del campo nel suo output; usate Ascolta per vedere i dati reali del trigger.