Output JSON

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

Vantaggi dell'uso dell'output JSON

L'output JSON consente di generare una struttura JSON per la risposta della richiesta anziché il testo. JSON semplifica l'elaborazione delle risposte con più elementi negli agenti, nei flussi cloud o nelle app.

Di seguito è riportato un esempio di casi d'uso che diventano possibili con l'output JSON:

• Visualizzare contenuto strutturato, ad esempio pianificazione del progetto o informazioni sul prodotto.
• Estrarre dati da testo come fatture, ordine di acquisto, moduli di consegna e molti altri.
• Identificare gli attributi dell'oggetto da origini di testo, ad esempio messaggi di posta elettronica o dati di Dataverse.
• Ottenere più categorie o sentimenti da un testo.

Creare un prompt con l'output JSON

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

Selezionare JSON come output

Per modificare il rendering della risposta alla richiesta, selezionare JSON come output nell'angolo in alto a destra.

Modificare il formato JSON

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

Per impostazione predefinita, il formato viene rilevato automaticamente. Questo formato indica ogni volta che si testa la richiesta, il formato associato alla richiesta viene aggiornato con quello rilevato in fase di test. Questo formato è utile quando si esegue l'iterazione delle istruzioni di richiesta e si vuole sapere come si evolve il formato di risposta.

Se si aggiorna l'esempio JSON, il formato diventa Personalizzato e non viene mai aggiornato se si testa nuovamente il prompt. Questo formato è utile quando non si desidera modificare il prompt per influenzare il formato o se è necessario seguire un formato specifico.

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

Per testare e salvare il prompt, seguire questa procedura:

1. Per confermare l'esempio appena modificato, selezionare Applica.
2. Per verificare il rendering della risposta al comando con il nuovo formato, selezionare Test.
3. Al termine delle modifiche, selezionare Salva personalizzato. Se si ignora questo passaggio, le modifiche andranno perse.

Quando si salva il prompt, si blocca il formato rilevato automaticamente più recente o il formato personalizzato definito. Ciò significa che quando si usa il prompt in un agente, in un flusso cloud o in un'app, viene utilizzato il formato salvato, senza variazioni.

In qualsiasi momento, è possibile controllare lo schema JSON che viene generato dagli esempi JSON selezionando </>. Attualmente non è possibile modificare questo schema.

Usare un prompt con l'output JSON in Power Automate

Questa sezione illustra come creare il flusso cloud seguente:

Screenshot di un flusso cloud con una richiesta

1. Creare una richiesta di elaborazione delle fatture usando un'immagine o un documento come input.

   Per ulteriori informazioni, vedere Aggiungere testo, immagine o input del documento a una richiesta.

   

2. Aggiornare il formato JSON fornendo l'esempio JSON seguente:

   

3. Creare un flusso cloud con il trigger Quando arriva un nuovo messaggio di posta elettronica . Per elaborare messaggi di posta elettronica specifici, assicurarsi di impostare i filtri.

   Per altre informazioni, vedere Introduzione ai trigger.

4. Aggiungere l'azione Esegui richiesta e selezionare la richiesta creata nel primo passaggio.

5. Nell'input della fattura aggiungere l'allegato di posta elettronica dall'azione trigger.

   Screenshot dei parametri di richiesta in un flusso cloud.

6. Aggiungere l'azione Invia un messaggio di posta elettronica .

7. Modificare il corpo del messaggio di posta elettronica per includere gli elementi estratti dal prompt con output JSON.

   

Domande frequenti

Non è stato possibile generare un codice JSON

È possibile che si verifichi l'errore seguente durante il test di una richiesta: impossibile generare un codice JSON. Modificare l'istruzione del prompt e riprovare.

Questo errore potrebbe essere dovuto al fatto che il modello racchiude l'output JSON con informazioni sui metadati che impediscono la corretta verifica del formato JSON richiesto. Per risolvere il problema, provare ad aggiungere le istruzioni seguenti al prompt: Non includere il markdown JSON nella risposta.

Non viene restituito alcun json in modalità di rilevamento automatico

È possibile che non venga restituito alcun codice JSON dopo aver selezionato Richiesta di test con la modalità di rilevamento automatico attivata. Potrebbe essere dovuto al fatto che le istruzioni della richiesta sono in contrasto con l'istruzione di sistema di restituzione di un codice JSON. Potrebbe essere risolto modificando l'istruzione del prompt e testando di nuovo.

Il formato JSON non viene aggiornato al runtime del prompt

Al momento del salvataggio, viene registrato il formato JSON più recente rilevato in modalità di rilevamento automatico o definito in modalità personalizzata. Questo formato JSON registrato viene applicato al runtime del prompt, garantendo la coerenza del formato di risposta anche quando cambiano gli input dinamici al prompt.

Limitazioni

• Non è possibile modificare uno schema JSON.
• Non è supportata la definizione di un formato JSON senza chiavi di campo.
  Esempio: ["abc", "def"] non è supportato ma [{"Field1": "abc"}, {"Field1": "def"}] è supportato.

Informazioni pertinenti

Video: prompt builder: output JSON nel prompt builder