Output JSON

Per impostazione predefinita, il prompt genera testo come risposta. Il testo può essere comodo per molti casi d'uso; tuttavia, se la risposta contiene diversi elementi che devono essere identificati singolarmente, l'opzione testo può essere limitata.

Vantaggi dell'uso dell'output JSON

L'output JSON consente di creare una struttura JSON per la risposta al prompt invece del testo. JSON rende più facile elaborare risposte con più elementi in agenti, flussi cloud o app.

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 messaggi e-mail o dati da Dataverse.
  • Ottieni più categorie o valutazioni da un testo.

Creare un prompt con output JSON

Questa sezione descrive come selezionare JSON come output e modificare il formato JSON.

Seleziona JSON come output

Per modificare il modo in cui viene eseguito il rendering della risposta al prompt, seleziona JSON come output nell'angolo in alto a destra.

Screenshot delle selezioni nella pagina

Modifica formato JSON

Per visualizzare o modificare il formato JSON, seleziona l'icona delle impostazioni a sinistra di Output: JSON.

Screenshot delle impostazioni di output.

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.

Screenshot del

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.

Puoi ripristinare la modalità di rilevamento automatico selezionando l'icona Torna al rilevamento automatico.

Screenshot dell'icona

Per testare e salvare il prompt, attieniti alla seguente procedura:

  1. Per confermare l'esempio appena modificato, seleziona Applica.
  2. Per verificare il rendering della risposta al prompt con il nuovo formato, seleziona Test.
  3. Al termine delle modifiche, seleziona Salva 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. Questo significa che, quando usi il prompt in un agente, un flusso cloud o un'app, viene utilizzato il formato salvato e rimane invariato.

In qualsiasi momento, puoi controllare lo schema JSON generato dagli esempi JSON selezionando </>. Al momento non puoi modificare questo schema.

Utilizzare un prompt con output JSON in Power Automate

Questa sezione ti guida a creare il seguente flusso cloud:

Schermata di creazione di un flusso cloud con un prompt

  1. Crea un prompt per elaborare le fatture utilizzando un'immagine o un documento come input.

    Altre informazioni in Aggiungere input di testo, immagini o documenti a un prompt.

    Screenshot di un prompt di elaborazione fatture.

  2. Aggiorna il formato JSON fornendo il seguente esempio JSON:

    Screenshot di un formato JSON personalizzato.

  3. Crea un flusso cloud con il trigger Quando arriva una nuova e-mail. Per elaborare e-mail specifiche, assicurati di impostare i filtri.

    Ulteriori informazioni in Attività iniziali con i trigger.

  4. Aggiungi l'azione Esegui un prompt e seleziona il prompt che hai creato nel primo passaggio.

  5. Nell'input della fattura, aggiungi l'allegato e-mail dall'azione di attivazione.

    Screenshot dei parametri del prompt in un flusso cloud.

  6. Aggiungi l'azione Invia un'e-mail.

  7. Modifica il corpo del messaggio e-mail per includere gli elementi estratti dal prompt in formato JSON.

    Screenshot di un corpo dell'e-mail che mostra i campi JSON.

Domande frequenti

Non è stato possibile generare un JSON

Potresti riscontrare il seguente errore durante il test di un prompt: Non è stato possibile generare un output JSON. Modifica l'istruzione del prompt 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 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.

Video: generatore di prompt: output JSON nel generatore di prompt

  • Last updated on