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 consente di generare una struttura JSON per la risposta alla richiesta anziché il testo. JSON semplifica l'elaborazione delle 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 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 il modo in cui viene eseguito il rendering della risposta alla richiesta, seleziona JSON come output nell'angolo in alto a destra.

Modifica formato JSON

Per visualizzare o modificare il formato JSON, seleziona l'icona delle impostazioni a sinistra di Output: 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.

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

Per testare e salvare la richiesta, attieniti alla seguente procedura:

1. Per confermare l'esempio appena modificato, seleziona Applica.
2. Per verificare il rendering della risposta alla richiesta 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. Ciò significa che quando utilizzi la richiesta in un agente, in un flusso cloud o in un'app, 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

Questa sezione ti guida a creare il flusso cloud seguente:

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

   Altre informazioni in Aggiungere input di testo, immagini o documenti a una richiesta.

   

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

   

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 una richiesta e seleziona la richiesta che hai creato nel primo passaggio.

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

   

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

7. Modifica il corpo del messaggio e-mail per includere 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 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.

Informazioni correlate

Video: AI Builder: Output JSON nel generatore di prompt