Modificare l'output del prompt (anteprima)

[Questo argomento fa parte della documentazione di pre-rilascio, pertanto è soggetto a modifiche.]

Per impostazione predefinita, il prompt 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 al prompt 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.

Crea un prompt 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 al prompt, attieniti alla seguente procedura:

1. Nel riquadro direttamente sotto l'intestazione Impostazioni prompt, seleziona Output>JSON (anteprima).

2. In basso a sinistra, seleziona Esegui test prompt per verificare come viene visualizzata la risposta al prompt in JSON.

   

Modifica formato JSON

Per impostazione predefinita, il formato è Rilevato automaticamente. Questo formato significa che ogni volta che si testa il prompt, il formato associato al prompt 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 il prompt. 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 il prompt, attieniti alla seguente procedura:

1. Per confermare l'esempio appena modificato, seleziona Applica.

2. Per verificare come viene resa la risposta al prompt con il nuovo formato, seleziona Esegui test prompt.

3. Una volta completate le modifiche, Seleziona Save richiesta personalizzata.

   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 il prompt in Power Automate o 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 un prompt 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 il prompt descritto in Creare un prompt con output JSON in questo articolo.

1. Crea un flusso con il trigger, Quando arriva una nuova e-mail.

   Per ulteriori informazioni, vai a Attività iniziali con i trigger.

2. Se hai solo bisogno di elaborare e-mail specifiche, assicurati di impostare i filtri.

3. 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.

4. 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.

   

5. Completa il flusso eseguendo la procedura seguente:

   1. Nel flusso, seleziona Crea testo con GPT usando una richiesta.
   2. Nella scheda Parametri nel campo Prompt, seleziona prompt con JSON come output.
   3. Aggiungi la variabile fattura creata nel prompt di input.

La seguente procedura consente di utilizzare in modo semplice e sicuro più valori estratti da un testo utilizzando un prompt.

1. Nel flusso, seleziona Invia un'e-mail.

2. Nella scheda Parametri, invia un'e-mail che contiene gli elementi estratti dal prompt con output JSON.

   

Domande frequenti

Non è stato possibile generare un JSON

Potresti riscontrare il seguente errore durante il test di un prompt: Impossibile generare un JSON. Modifica l'istruzione del prompt e riprova.

Questo errore potrebbe essere Dato che il modello racchiude l'output JSON con informazioni sui metadati che impediscono la verifica corretta del formato JSON richiesto. Prova ad aggiungere la seguente istruzione 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 prompt 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 del prompt

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 del prompt, garantendo la coerenza del formato della risposta anche quando gli input dinamici al prompt 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.