Velocizzare l'esecuzione del flusso dell'agente con la modalità rapida (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Per impostazione predefinita, un agente o un'app avvia un flusso dell'agente che ha esito negativo se sono necessari più di due minuti per rispondere all'agente chiamante o all'app. Questo errore influisce sulla funzionalità e sull'usabilità dell'agente o dell'app che chiama il flusso.

Screenshot dell'avviso di timeout del flusso dell'agente.

Importante

Questo articolo contiene la documentazione sull'anteprima di Microsoft Copilot Studio ed è pertanto soggetto a modifiche.

Le funzionalità di anteprima non sono destinate all'uso in produzione e potrebbero avere funzionalità limitate. Queste funzionalità sono disponibili prima di una versione ufficiale in modo che sia possibile ottenere l'accesso iniziale e inviare commenti.

Se stai creando un agente destinato alla produzione, vedi Panoramica di Microsoft Copilot Studio.

Quando si usa la modalità rapida, il flusso può ottenere tempi di esecuzione più rapidi. Questa funzionalità aumenta la probabilità che i flussi dell'agente possano essere completati entro la finestra di due minuti e forniscano una risposta nel tempo.

L'immagine seguente mostra un esempio di aumento di velocità per un flusso specifico con e senza modalità rapida.

Screenshot del confronto delle prestazioni tra senza modalità rapida e con modalità rapida.

Note

La velocità varia in base alla complessità del flusso e alle azioni usate al suo interno. La modalità Rapida è ideale per i flussi che non spostano molti dati dai connettori, ma richiedono molto tempo di elaborazione. Testare i flussi per verificare se la modalità rapida è adatta per lo scenario specifico e quanto migliora le prestazioni del flusso. Se si verifica un errore di runtime del flusso che indica una limitazione dei dati, disattivare la modalità rapida e provarla con altri flussi.

Prerequisiti

Per usare la modalità rapida, il flusso deve soddisfare i requisiti seguenti:

  • Il flusso deve avere il trigger o Quando un agente chiama un flusso o Quando un'app chiama un flusso.
  • Il flusso deve avere un'azione Risposta, rispondi all'agente o Rispondi all'app.
  • Al flusso deve essere associato un piano di Copilot Studio.
  • L'ambiente Power Automate deve essere su una nuova infrastruttura. Per altre informazioni, vedere Disponibilità .

Attivare la modalità rapida

  1. Selezionare Flussi e quindi selezionare il flusso per il quale si vuole attivare la modalità rapida.

  2. Nella sezione Dettagli della pagina Panoramica selezionare Modifica.

    Viene visualizzato il pannello Dettagli .

  3. Attivare la modalità Express. L'interruttore si trova nella parte inferiore del pannello.

    Screenshot dell'interruttore della modalità espressa nella pagina dei dettagli del flusso.

Note

Puoi anche attivare la modalità express dal trigger Quando un agente chiama un flusso o dal trigger Quando un'app chiama un flusso mentre costruisci il flusso nel designer sulla scheda trigger.

Screenshot che mostra l'interruttore della modalità express sulla scheda trigger nel flow designer.

Linee guida per l'uso della modalità rapida

Quando usare la modalità rapida Quando non usare la modalità rapida
Flussi a logica complessa: il flusso dell'agente non restituisce quantità elevate di dati dalle risposte del connettore (le grandi quantità di dati superano il limite di memoria della modalità express). Flussi pesanti di dati: il tuo flusso dell'agente sposta molti dati (ad esempio, elenca le righe in una grande tabella, oppure un'azione *get items* restituisce 1.500 righe di dati con 100 colonne).
Il flusso dell'agente ha un'azione di risposta, ovvero il flusso è sensibile al tempo. Un agente attende che il flusso venga eseguito e invii una risposta il più velocemente possibile. Il flusso dell'agente non ha un'azione di risposta. Il flusso è di tipo "fire-and-forget", ovvero non richiede che venga monitorato una volta avviato. Non è necessario inviare una risposta a un agente chiamante o a un'app.
La modalità Rapida viene eseguita correttamente e in modo ottimale durante il test. La modalità Express fallisce durante il test a causa di un limite di dimensione variabile o di memoria. Se il flusso ha esito negativo durante un test, è probabile che si riscontrino questi problemi quando il flusso viene distribuito e avviato in produzione.

Availability

La modalità Rapida è attualmente disponibile solo per gli ambienti aggiornati usando la nuova architettura supportata. Microsoft sta eseguendo l'aggiornamento degli ambienti per supportare la modalità rapida. Non è necessario eseguire alcuna azione per aggiornare l'ambiente.

Per verificare se la modalità rapida è disponibile nell'ambiente:

  1. Assicurarsi di avere un semplice flusso agente in Copilot Studio con il trigger Quando un agente chiama un flusso o Quando un'app chiama un flusso, e alcune azioni. Se non si ha un flusso con questi elementi, crearne uno.

  2. Verifica la presenza dell'interruttore modalità rapida nella finestra di progettazione della scheda trigger.

Se la modalità rapida non viene visualizzata, l'ambiente non supporta ancora questa funzionalità.

Note

Se l'ambiente non è ancora presente nella nuova infrastruttura, alcuni flussi potrebbero ritardare l'aggiornamento dell'ambiente. Per risolvere il blocco dell'aggiornamento automatico futuro, vedi Gli ambienti di Power Automate passano alla nuova architettura.

Licensing

La modalità Rapida è disponibile solo per i flussi nel piano di Copilot Studio. Non c'è alcun costo aggiuntivo nell'esecuzione dei flussi in questa modalità. Vieni comunque addebitato per il numero di azioni utilizzate nella misurazione di Copilot Studio.

Limitations

Tenere presente queste limitazioni note quando si usa la modalità rapida.

Limitazioni durante la pubblicazione del flusso

Azioni di ritardo e webhook nel flusso non sono supportate quando è attivata la modalità express. Si verificano errori durante il salvataggio del flusso. Per questi casi, provare a disattivare la modalità rapida e riprovare.

Limitazioni in fase di esecuzione del flusso

Esistono alcune limitazioni di runtime quando si usa la modalità rapida.

Tempo di esecuzione

Quando si attiva la modalità rapida, i flussi devono essere completati in due minuti. I flussi che richiedono un timeout più lungo.

Dimensioni del flusso

  • Non includere più di 100 azioni in un'esecuzione del flusso. Il conteggio delle azioni include cicli, che vengono conteggiati come un'azione per ogni iterazione del ciclo. I limiti seguenti si applicano ai cicli:
    • Applica a ogni ciclo in una matrice: massimo 100 elementi
    • Ripeti finché: numero massimo di 100 iterazioni
  • Limite variabile di contenuto: 1.024 caratteri. Se è possibile, trovare soluzioni alternative per non inserire più di 1.024 caratteri in variabili come Imposta variabile, Aggiungi a variabile stringa o Inizializza variabile.

100 azioni è un limite sicuro per le dimensioni del flusso. In pratica, potrebbe essere possibile includere più di 100 azioni, a seconda delle dimensioni del flusso e della quantità di elaborazione dei dati eseguita dal flusso. Altre informazioni sulla gestione delle dimensioni del flusso sono disponibili in Linee guida per l'uso della modalità rapida.

Dimensione del messaggio

Il limite di dimensioni dei messaggi per i dati passati in una singola azione (risposta del connettore) è di 64 KB.

Messaggistica degli errori

La messaggistica degli errori di runtime descrive in dettaglio il motivo per cui il flusso non è riuscito se è dovuto a una delle limitazioni di runtime indicate in precedenza. Se si dispone di un flusso che non soddisfa i prerequisiti per la modalità rapida, eseguire il flusso con la modalità rapida Disattivato.

Altre limitazioni quando si usa la modalità rapida

  • Il test automatico del flusso non funziona nel progettista di flussi. Il test utilizza automaticamente il riinvio del flusso, e il riinvio del flusso non può essere utilizzato con flussi attivati dall'agente o attivati dall'app.
  • Le iterazioni del ciclo non vengono visualizzate nella visualizzazione dettagli di esecuzione Run details quando una risposta del connettore supera il limite di memoria. In alcuni casi, è possibile notare che le iterazioni del ciclo non vengono visualizzate quando si monitora un ciclo (Applica a ciascuno o Esegui fino a quando). Testare il flusso in un ambiente di sviluppo e quindi attivare la modalità rapida per il debug prima della pubblicazione in produzione.