Modificare l'output della richiesta
Per impostazione predefinita, la richiesta genera testo come risposta. Il testo può essere utile per molti casi d'uso. Tuttavia, se la risposta contiene più elementi che devono essere identificati singolarmente, l'opzione testuale può essere limitata.
Vantaggi dell'uso dell'output JSON
L'output JSON ti consente di generare una struttura JSON per la tua risposta alla richiesta invece di un testo. JSON consente un'elaborazione più semplice delle risposte con più elementi in Power Automate o Power Apps.
Di seguito è riportato un esempio di casi d'uso che diventano possibili con l'output JSON:
- Visualizza contenuti strutturati come la pianificazione del progetto o le informazioni sul prodotto.
- Estrai dati da testi come fatture, ordini di acquisto, moduli di consegna e molto altro.
- Identifica gli attributi degli oggetti da origini di testo come e-mail o dati Dataverse.
- Ottieni più categorie o valutazioni da un testo.
Creare una richiesta con output JSON
Questa sezione descrive come selezionare JSON come output e modificare il formato JSON.
Seleziona JSON come output
Per modificare la modalità di visualizzazione della risposta alla richiesta, attieniti alla seguente procedura:
Nel riquadro direttamente sotto l'intestazione Impostazioni richiesta, seleziona Output>JSON.
In basso a sinistra, seleziona Esegui test richiesta per verificare come viene visualizzata la risposta alla richiesta in JSON.
Modifica formato JSON
Per impostazione predefinita, il formato è Rilevato automaticamente. Questo formato significa che ogni volta che si testa la richiesta, il formato associato alla richiesta viene aggiornato con quello rilevato al momento del test. Questo formato è utile quando si ripetono le istruzioni tempestive e si desidera sapere come si evolve il formato della risposta.
Se aggiorni l'esempio JSON, il formato diventa Personalizzato e non verrà mai aggiornato se testi nuovamente la richiesta. Questo formato è utile quando non vuoi che le modifiche immediate influenzino il formato o se devi seguire un formato specifico.
È possibile ripristinare la modalità di rilevamento automatico selezionando Torna al rilevamento automatico.
Per testare e salvare la richiesta, attieniti alla seguente procedura:
Per confermare l'esempio appena modificato, seleziona Applica.
Per verificare come viene resa la risposta alla richiesta con il nuovo formato, seleziona Esegui test richiesta.
Una volta completate le modifiche, seleziona Salva richiesta personalizzato.
Se salti questo passaggio, le modifiche andranno perse.
Quando salvi il messaggio, blocchi il formato Rilevato automaticamente più recente o il formato Personalizzato definito. Ciò significa che quando utilizzi la richiesta in Power Automate o in Power Apps, viene utilizzato il formato salvato, che non varia.
In qualsiasi momento, puoi controllare lo schema JSON generato dagli esempi JSON selezionando </>. Al momento non puoi modificare questo schema.
Usare una richiesta con output JSON in Power Automate
Dopo aver aggiunto l'azione Testo creato con GPT in un flusso Power Automate, puoi utilizzare tutti i campi JSON come valori dinamici senza aggiungere logica complessa per analizzare la risposta.
L'esempio seguente mostra come elaborare una fattura ricevuta via e-mail utilizzando la richiesta descritta in Creare una richiesta con output JSON in questo articolo.
Crea un flusso con il trigger, Quando arriva una nuova e-mail.
Per ulteriori informazioni, vai a Attività iniziali con i trigger.
Se hai solo bisogno di elaborare e-mail specifiche, assicurati di impostare i filtri.
Estrai il testo degli allegati con l'azione Riconosci il testo in un'immagine o in un documento PDF.
Per ulteriori informazioni su come creare e modificare un flusso nella finestra di progettazione, vai a Comprendere la progettazione dei flussi cloud.
Poiché l'azione precedente restituisce una tabella di righe all'interno di una tabella della pagina, è più conveniente aggregare tutte le righe in un'unica variabile.
Inizializza una variabile e aggiungi il valore dinamico Testo dall'azione Riconoscimento del testo in un'immagine o in un documento PDF in questa variabile.
Completa il flusso eseguendo la procedura seguente:
- Nel flusso, seleziona Crea testo con GPT usando una richiesta.
- Nella scheda Parametri nel campo Richiesta, seleziona richiesta con JSON come output.
- Aggiungi la variabile fattura creata nella richiesta di input.
La seguente procedura consente di utilizzare in modo semplice e sicuro più valori estratti da un testo utilizzando una richiesta.
Nel flusso, seleziona Invia un'e-mail.
Nella scheda Parametri, invia un'e-mail che contiene gli elementi estratti dalla richiesta con output JSON.
Domande frequenti
Non è stato possibile generare un JSON
Potresti riscontrare il seguente errore durante il test di una richiesta: Non è stato possibile generare un output JSON. Modifica l'istruzione della richiesta e riprova.
Il motivo di questo errore potrebbe essere che il modello racchiude l'output JSON con informazioni sui metadati che impediscono la verifica corretta del formato JSON richiesto. Per risolvere il problema, prova ad aggiungere le seguenti istruzioni al prompt per risolvere il problema: Non includere il markdown JSON nella risposta.
Nessun JSON viene restituito in modalità di rilevamento automatico
È possibile che non venga restituito alcun JSON dopo aver selezionato Esegui test richiesta con la modalità di rilevamento automatico attivata. Potrebbe essere perché le istruzioni tempestive sono in contraddizione con l'istruzione del sistema di restituire un JSON. Potrebbe essere risolto modificando le istruzioni rapide e testando nuovamente.
Il formato JSON non viene aggiornato in fase di esecuzione della richiesta
L'ultimo formato JSON rilevato in modalità di rilevamento automatico o l'ultimo formato JSON definito in modalità personalizzata viene registrato al momento del salvataggio richiesto. Questo formato JSON registrato viene applicato in fase di esecuzione della richiesta, garantendo la coerenza del formato della risposta anche quando gli input dinamici alla richiesta cambiano.
Limiti
- In genere non puoi modificarle uno schema JSON.
- Non supportiamo la definizione di un formato JSON senza chiavi di campo.
Esempio:["abc", "def"]non è supportato ma[{"Field1": "abc"}, {"Field1": "def"}]è supportato.