Esercizio - Test del connettore personalizzato in Microsoft Power Platform

  • 15 minuti

Background

L'esercizio finale combina la creazione di un'interfaccia utente di Power Apps, la connessione a un connettore personalizzato e la creazione di un post sui social media generato dall'intelligenza artificiale. Si implementa anche questo flusso di lavoro in Microsoft Copilot Studio.

Definizioni

Le sezioni seguenti forniscono le definizioni degli elementi importanti che è necessario conoscere per questo esercizio.

Power Apps

Power Apps è una suite di app, servizi e connettori. È una piattaforma dati che fornisce un ambiente di sviluppo rapido per la creazione di app personalizzate in grado di soddisfare le esigenze aziendali. Usando Power Apps è possibile creare rapidamente app aziendali personalizzate che si connettono ai dati archiviati nella piattaforma di dati sottostante (Microsoft Dataverse) o in varie origini dati online e locali quali SharePoint, Microsoft 365, Microsoft Dynamics 365, Microsoft SQL Server e altre.

Per altre informazioni, consultare Che cos'è Power Apps?

Microsoft Copilot Studio

Con Microsoft Copilot Studio è possibile creare potenti copiloti basati sull'intelligenza artificiale per una serie di richieste, dalle risposte semplici a domande comuni alla risoluzione di problemi che richiedono conversazioni complesse. È possibile interagire con clienti e dipendenti in più lingue su siti Web, app per dispositivi mobili, Facebook, Microsoft Teams o qualsiasi canale supportato da Azure Bot Framework.

Per altre informazioni, consultare Panoramica di Microsoft Copilot Studio.

Power Fx

Power Fx è il linguaggio con poco codice che le persone usano in Microsoft Power Platform. Si tratta di un linguaggio di programmazione per uso generico, fortemente tipizzato, dichiarativo e funzionale.

Per altre informazioni, consultare Panoramica di Microsoft Power Fx.

Prerequisiti

Prima di iniziare questo esercizio, è necessario completare i tre laboratori precedenti.

Passaggi dell'esercizio

Il video seguente illustra i passaggi per l'esercizio di questa unità.

Creazione di un'app in Power Apps

Per creare un'app in Power Apps, effettuare i passaggi seguenti:

  1. Accedere a Power Apps usando l'account del Piano di sviluppo di Power Apps. Assicurarsi di trovarsi nello stesso ambiente selezionato per il connettore personalizzato creato nell'esercizio Creazione di un connettore personalizzato per il copilota.

  2. Selezionare + Crea nel riquadro di spostamento a sinistra e selezionare Inizia con un canvas vuoto.

  3. Scegliere Dimensioni tablet.

    Screenshot dell'assegnazione del nome all'app in Power Apps.

  4. Dopo aver creato l'app, andare al riquadro di spostamento a sinistra e selezionare Dati > + Aggiungi dati.

    Screenshot dell'aggiunta di dati.

  5. Cercare PodcastCopilot_Connector, quindi selezionare il connettore.

  6. Selezionare Connetti.

    Screenshot della connessione del connettore personalizzato.

  7. Dopo che il sistema ha aggiunto il connettore all'app, è possibile aggiungere i controlli seguenti nella schermata:

    • 1 controllo Input di testo

    • 1 controllo Pulsante

    • 2 controlli Etichetta

    • 1 controllo Immagine

    Disporre i controlli in modo simile a quanto illustrato nell'immagine seguente.

    Screenshot dell'aggiunta di controlli.

    Usare il primo controllo Etichetta per il titolo dell'app. Usare il controllo Input di test per immettere il link all'URL del podcast. Il controllo Pulsante con il testo Genera post attiva il connettore personalizzato per generare il post e l'immagine sui social media. Il secondo controllo Etichetta visualizza il post generato, mentre il controllo Immagine visualizza l'immagine generata.

  8. Assegnare ai controlli i nomi seguenti:

    • Etichetta: lblTitle

    • Input di testo: txtPodcastURL

    • Pulsante: btnGeneratePost

    • Immagine: imgSocialImage

    • Etichetta: lblSocialPost

  9. Selezionare il controllo Pulsante, quindi aggiungere la formula seguente alla proprietà OnSelect:

     //Generate a social media blurb / post
 Set(
     socialMediaBlurb,
     PodcastCopilot_Connector.GetSocialMediaPost(txtPodcastURL.Text).blurb
 );

 //Generate a social media image
 Set(
     socialImage,
     PodcastCopilot_Connector.GetSocialMediaPost(txtPodcastURL.Text).imageUrl
 );

    Questa formula chiama la singola operazione API nel connettore personalizzato e restituisce un record post sui social media con un testo descrittivo e un URL dell'immagine. Il sistema archivia il testo descrittivo per i social media risultante in una variabile socialMediaBlurb e archivia l'immagine risultante in una variabile socialImage.

  10. Selezionare il controllo lblSocialPost, quindi aggiungere la formula seguente alla proprietà Text:

    socialMediaBlurb

    Questa azione visualizza il testo descrittivo per i social media nell'etichetta.

  11. Selezionare il controllo imgSocialImage, quindi aggiungere la formula seguente alla proprietà Image:

    socialImage

    Questa azione visualizza l'immagine nel controllo Immagine.

  12. Usare il pulsante Anteprima per testare l'app. Nel controllo Input di testo immettere il collegamento all'episodio del podcast (l'URL del BLOB copiato nell'esercizio Configurazione del Servizio OpenAI di Azure per generare informazioni sul podcast). Selezionare il pulsante Genera post. Dovrebbero essere visibili il testo descrittivo e l'immagine per i social media (entrambi univoci).

    Screenshot del test dell'app in Power Apps.

La funzionalità principale dell'app è incapsulata nel connettore personalizzato. È possibile usarlo nuovamente in altre app da Power Apps o in altre parti di Microsoft Power Platform, tra cui Microsoft Copilot Studio.

Uso del connettore in Microsoft Copilot Studio

È possibile usare il connettore in Microsoft Copilot Studio effettuando i passaggi seguenti:

  1. Accedere a Microsoft Copilot Studio usando il proprio account Microsoft o lo stesso account usato per questo modulo. Assicurarsi di trovarsi nello stesso ambiente selezionato per il connettore personalizzato creato nell'esercizio Creazione di un connettore personalizzato per il copilota.

  2. Nella home page selezionare il riquadro Nuovo copilota.

    Screenshot della creazione di un copilota in Microsoft Copilot Studio.

  3. Selezionare Ignora per continuare. Assegnare al copilota il nome Podcast Copilot e selezionare Crea.

  4. Dopo aver creato il copilota, selezionare Impostazioni.

  5. Selezionare IA generativa.

  6. Nel pannello principale scorrere fino a trovare l'opzione Come deve rispondere il copilota. Selezionare Generativa (anteprima), quindi selezionare Salva nell'angolo in alto a sinistra.

    Screenshot dell'attivazione delle funzionalità di IA generativa.

  7. Selezionare il copilota dal riquadro di spostamento a sinistra, quindi selezionare Argomenti.

  8. Selezionare + Aggiungi un argomento > Da vuoto.

    Screenshot della creazione di un argomento vuoto nel copilota.

  9. Rinominare l'argomento in Genera post sui social media.

    Screenshot del campo in cui è possibile rinominare un argomento. In questa istanza si rinomina l'argomento in Post sui social media generale.

  10. Nella descrizione Trigger immettere Genera un post sui social media per un episodio del podcast.

    Screenshot dell'aggiunta di una descrizione del trigger.

  11. Aggiungere un nuovo nodo, selezionare Poni una domanda, quindi configurare le impostazioni seguenti:

    • Messaggio: Qual è l'URL dell'episodio del podcast per il quale si desidera generare un post sui social media?

    • Identificazione: selezionare l'intera risposta dell'utente

    • Salva risposta utente come: podcastURL

    Screenshot di come salvare la risposta dell'utente come URL del podcast.

  12. Aggiungere un altro nodo, ma questa volta selezionare Chiama un'azione. Nella finestra pop-up Seleziona un'azione selezionare Crea un flusso per avviare Power Automate.

    Screenshot dell'aggiorna del nodo Chiama un'azione.

  13. Selezionare il trigger Esegui un flusso da Copilot. Nella finestra pop-up, in Parametri, selezionare + Aggiungi un input > Testo.

  14. Sostituire Input con podcastURL e sostituire Immettere l'input con l'URL dell'episodio del podcast.

    Screenshot dell'aggiunta di un parametro al trigger del flusso.

  15. Chiudere la finestra pop-up, quindi aggiungere un'azione nel flusso tra il trigger e il nodo finale. Nella finestra di dialogo Aggiungi un'azione cercare podcastcopilot e selezionare Genera post sui social media.

    Screenshot dell'aggiunta dell'azione Genera post sui social media.

  16. Creare una connessione a PodcastCopilot_Connector selezionando Crea nuovo.

    Screenshot della creazione di una nuova connessione.

  17. Dopo aver creato la connessione, selezionare il campo podcastUrl, quindi selezionare l'icona Contenuto dinamico.

    Screenshot della selezione dell'opzione Contenuto dinamico.

  18. Selezionare podcastURL dall'elenco del contenuto dinamico.

  19. Chiudere la finestra di dialogo, quindi selezionare il nodo Rispondi a Copilot. Nella finestra di dialogo selezionare + Aggiungi un output > Testo. Aggiungere un altro output e selezionare Testo. Configurare gli output come segue:

    • Output: testo descrittivo

    • Valore: selezionare body/blurb dall'elenco del contenuto dinamico

    • Output: imageUrl

    • Valore: selezionare body/imageUrl dall'elenco del contenuto dinamico

    Screenshot dell'aggiunta di output al nodo del valore restituito.

  20. Chiudere la finestra di dialogo, rinominare il flusso in Genera post sui social media, quindi selezionare Salva.

    Dopo aver completato il salvataggio, chiudere Power Automate e tornare a Microsoft Copilot Studio.

  21. In Copilot Studio selezionare Fatto nella finestra di dialogo Salva e aggiorna per aggiornare il nuovo flusso nell'elenco dei flussi.

    Screenshot del salvataggio e dell'aggiornamento del flusso.

  22. Aggiungere un nodo e selezionare Chiama un'azione. Tuttavia, questa volta, nella finestra pop-up Seleziona un'azione selezionare il flusso Genera post sui social media di Power Automate creato.

  23. Impostare l'input nella variabile podcastURL.

    Screenshot dell'impostazione dell'input per il flusso.

  24. Aggiungere un altro nodo e selezionare Invia un messaggio. Nel nodo del messaggio selezionare + Aggiungi e selezionare Scheda adattiva.

  25. Selezionare Scheda adattiva. Nella sezione Proprietà scheda adattiva espandere il contenuto della scheda e modificare Modifica JSON in Modifica formula.

    Screenshot della modifica del formato della scheda adattiva.

  26. Copiare la formula seguente e incollarla nella scheda adattiva:

     {
 '$schema': "http://adaptivecards.io/schemas/adaptive-card.json",
 type: "AdaptiveCard",
 version: "1.3",
 body: [
     {
     type: "TextBlock",
     text: "Generated Post",
     size: "Large",
     weight: "Bolder",
     horizontalAlignment: "Center",
     spacing: "Medium"
     },
     {
     type: "Image",
     size: "large",
     url: Topic.imageUrl,
     horizontalAlignment: "Center"
     },
     {
     type: "RichTextBlock",
     inlines: [
         {
         type: "TextRun",
         size: "medium",
         text: Topic.blurb
         }
     ]
     }
 ]
 }

    Questa formula visualizza il testo descrittivo e l'immagine generati per i social media, formattati in modo ordinato in una scheda adattiva.

  27. Chiudere la scheda adattiva e selezionare Salva per salvare l'argomento.

Test del copilota

Per testare il copilota, effettuare i passaggi seguenti:

  1. Dopo aver salvato il copilota, aprire il progetto PodcastCopilotAPI in Visual Studio ed eseguirlo.

  2. Con l'API in esecuzione, tornare a Microsoft Copilot Studio e selezionare Testa il copilota per aprire il pannello di test del copilota.

  3. Selezionare l'icona Aggiorna nel pannello di test per aggiornare il copilota e testare il nuovo argomento.

  4. Porre la domanda seguente: È possibile creare un post sui social media per l'episodio del podcast?

    Copilot dovrebbe rispondere come illustrato nello screenshot seguente.

    Screenshot della risposta di Copilot in cui chiede l'URL del podcast.

  5. Rispondere con l'URL del frammento audio del podcast caricato in Archiviazione BLOB di Azure nell'esercizio Configurazione del Servizio OpenAI di Azure per generare informazioni sul podcast.

Dopo alcuni secondi, Copilot dovrebbe rispondere con il testo descrittivo e l'immagine sui social media dell'episodio del podcast, formattati in una scheda adattiva.

Screenshot della risposta di Copilot con il testo descrittivo e l'immagine sui social media.

Si sono creati un'app da Power Apps e un copilota che usa il connettore personalizzato per generare un post sui social media e un'immagine dall'URL del podcast usando l'intelligenza artificiale.

Passaggi successivi

Si è appreso come creare un copilota che usa il Servizio OpenAI di Azure. Nell'unità successiva si verificheranno i concetti appresi in questo modulo.