Leggere in inglese

Condividi tramite


Creare un pacchetto del modello utilizzando soluzioni

Dopo che hai registrato il tuo modello in AI Builder utilizzando un pacchetto Python, puoi creare un pacchetto del tuo modello utilizzando le soluzioni per eseguire attività di gestione del ciclo di vita delle applicazioni (ALM), come ad esempio:

Le soluzioni sono utilizzate per trasportare app e componenti da un ambiente all'altro. Vengono usate anche per applicare una serie di personalizzazioni alle app esistenti. Per informazioni dettagliate sulle soluzioni e su come vengono utilizzate per applicare i concetti di gestione del ciclo di vita delle applicazioni tramite Microsoft Power Platform, vai a Panoramica della gestione del ciclo di vita delle applicazioni.

Esportare il modello utilizzando una soluzione

In questo esempio esporterai due soluzioni:

  • La soluzione che contiene solo il connettore personalizzato
  • La soluzione che contiene il modello, il riferimento alla connessione e qualsiasi altro componente
  1. Assicurati di aver registrato il modello nell'ambiente di origine utilizzando un pacchetto Python. Se non lo hai già registrato, segui la procedura nell'esercitazione Importa il tuo modello (su GitHub).

  2. Crea una soluzione per registrare il connettore personalizzato associato al modello:

    1. Accedi a Power Apps o Power Automate.
    2. Nel riquadro sinistro, seleziona Soluzioni>Nuova soluzione.
    3. Nella finestra di dialogo Nuova soluzione, completa i campi. Per informazioni dettagliate su ciascun campo, vai a Creare una soluzione.
    4. Seleziona Crea.

    Screenshot di come creare una soluzione per registrare il connettore personalizzato.

  3. Aggiungi un connettore personalizzato esistente selezionando Aggiungi esistente>Automazione>Connettore personalizzato.

    Screenshot di come aggiungere un connettore personalizzato esistente.

  4. Seleziona il connettore personalizzato associato al modello.

    Il nome sarà in questo formato: <model_name>-<random number>-v<version>. La versione consente di determinare quale connettore aggiungere quando si aggiorna il modello.

    Screenshot del formato di denominazione del connettore personalizzato.

  5. Esportare la soluzione. Per informazioni su come esportare soluzioni, vai a Esportare soluzioni per Power Apps o Esportare soluzioni per Power Automate.

  6. Crea una nuova soluzione per aggiungere il modello ed eventuali altri componenti:

    1. Seleziona Soluzioni>Nuove soluzioni.
    2. Nella finestra di dialogo Nuova soluzione, completa i campi.
    3. Seleziona Crea.

    Screenshot di come creare una nuova soluzione per aggiungere il modello ed eventuali altri componenti.

  7. Aggiungi un riferimento di connessione esistente selezionando Aggiungi esistente>Altro>Riferimento di connessione (anteprima).

    Screenshot di come aggiungere un riferimento di connessione esistente.

  8. Aggiungere il riferimento di connessione esistente associato al modello.

    Il formato di denominazione è lo stesso del connettore personalizzato nel passaggio 4: <model_name>-<random number-v>-v<version>.

    Screenshot del formato di denominazione del riferimento di connessione.

  9. Aggiungi il modello di intelligenza artificiale selezionando Aggiungi esistente>Modello di intelligenza artificiale.

    Screenshot di come aggiungere il modello IA in AI Builder.

    La soluzione deve contenere i componenti mostrati nell'immagine seguente.

    Screenshot dei tre componenti aggiunti: un modello di intelligenza artificiale, un riferimento di connessione e un connettore personalizzato.

  10. (Facoltativo) Aggiungi tutti i componenti necessari. In questo esempio, aggiungeremo un flusso cloud che utilizza il modello.

    Screenshot dei nuovi componenti aggiunti.

  11. Esportare la soluzione. Per informazioni su come esportare soluzioni, vai a Esportare soluzioni per Power Apps o Esportare soluzioni per Power Automate.

Importare il modello nell'ambiente di destinazione

In questo esempio importerai due soluzioni che hai creato nella sezione precedente:

  • La soluzione che contiene solo il connettore personalizzato
  • La soluzione che contiene il modello, il riferimento alla connessione e qualsiasi altro componente

Per informazioni su come importare soluzioni, vai a Importare soluzioni per Power Apps o Importare soluzioni per Power Automate.

  1. Accedi a Power Apps o Power Automate.

  2. Importa la soluzione che contiene solo il connettore personalizzato.

  3. Importa la soluzione che contiene il modello, il riferimento di connessione e qualsiasi altro componente.

  4. Durante il processo di importazione, crea la connessione all'endpoint esterno:

    • Se il tuo endpoint non è protetto, seleziona Crea.
    • Se il tuo endpoint è protetto con una chiave API, immettilo nel campo Chiave API, quindi seleziona Crea.

    Screenshot della connessione a un endpoint esterno.

Il modello è ora pronto per essere utilizzato nell'ambiente di destinazione.

Screenshot delle soluzioni importate.

Se riscontri problemi con l'importazione, vai a Risoluzione dei problemi di importazione della soluzione.

Aggiornare il modello

Aggiorna la soluzione all'ultima versione di modo che venga eseguito il roll up di tutte le patch precedenti in un unico passaggio. Tutti i componenti associati alla versione precedente della soluzione che non sono presenti nella versione più recente della soluzione verranno eliminati. In questo modo i componenti obsoleti non saranno inclusi nella soluzione.

Negli esempi, aggiornerai due soluzioni:

  • La soluzione che contiene solo il connettore personalizzato
  • La soluzione che contiene il modello, il riferimento alla connessione e qualsiasi altro componente

Per assistenza su come eseguire l'aggiornamento, vai a Aggiornare una soluzione.

Aggiornare il modello nell'ambiente di origine

  1. Assicurati di aver registrato il modello aggiornato nell'ambiente di origine utilizzando un pacchetto Python. Se non lo hai già registrato, segui la procedura nell'esercitazione Importa il tuo modello (su GitHub).

  2. Accedi a Power Apps o Power Automate.

  3. Nella soluzione che contiene solo il connettore personalizzato, aggiungi un nuovo connettore personalizzato esistente selezionando Aggiungi.

  4. Completa i campi e immetti la nuova versione. In questo esempio, è v2 perché questa è la seconda versione.

  5. Rimuovi la versione precedente del connettore personalizzato dalla soluzione:

    1. Seleziona i puntini di sospensione verticali (⋮) accanto alla versione precedente.
    2. Seleziona Rimuovi>Rimuovi dalla soluzione.

    Screenshot della rimozione di una versione precedente da una soluzione.

  6. Esporta la soluzione selezionando Esporta. Per impostazione predefinita, la versione verrà incrementata durante l'esportazione.

  7. Nella soluzione che contiene il modello, il riferimento di connessione e qualsiasi altro componente, aggiorna il riferimento di connessione di modo che punti alla versione più recente:

    1. La connessione personalizzata avrà lo stesso nome del connettore personalizzato aggiunto nel passaggio 4. In questo esempio, v2 è l'ultima versione.
    2. Rimuovi la versione precedente del riferimento di connessione dalla soluzione selezionando il nome da rimuovere (in questo esempio v1), quindi selezionando Rimuovi>Rimuovi dalla soluzione.
  8. Esporta la soluzione selezionando Esporta. Il modello di intelligenza artificiale e qualsiasi componente che fa riferimento al modello vengono aggiornati automaticamente di modo che puntino alla versione più recente.

Aggiornare il modello nell'ambiente di destinazione

  1. Accedi a Power Apps o Power Automate.

  2. Importa la soluzione che contiene solo il connettore selezionando Importa>Aggiorna.

  3. Importa la soluzione che contiene il modello, il riferimento di connessione e qualsiasi altro componente selezionando Importa>Aggiorna.

  4. Crea nuove connessioni al nuovo endpoint:

    1. Se il tuo endpoint non è protetto, seleziona Crea.
    2. Se il tuo endpoint è protetto con una chiave API, immettilo nel campo Chiave API, quindi seleziona Crea.

    Screenshot della connessione a un nuovo endpoint.

Il modello ora farà riferimento al nuovo endpoint nell'ambiente di destinazione.

Screenshot del modello che fa riferimento al nuovo endpoint nell'ambiente di destinazione.

Eseguire lo staging del modello per l'aggiornamento

Lo staging del modello per l'aggiornamento lo importa solo nell'organizzazione. Non lo rende attivo. In questo scenario, i componenti che fanno riferimento al modello nell'ambiente faranno riferimento alla versione precedente fino al completamento di questa procedura applicando l'aggiornamento.

Per informazioni su come importare soluzioni, vai a Importare soluzioni per Power Apps o Importare soluzioni per Power Automate.

  1. Accedi a Power Apps o Power Automate.

  2. Importa la soluzione che contiene solo il connettore selezionando Importa>Aggiorna.

  3. Importa la soluzione che contiene il modello, il riferimento di connessione e altri componenti selezionando Importa>Fase di aggiornamento.

  4. Crea nuove connessioni al nuovo endpoint:

    1. Se il tuo endpoint non è protetto, seleziona Crea.
    2. Se il tuo endpoint è protetto con una chiave API, immettilo nel campo Chiave API, quindi seleziona Crea.

    Screenshot della connessione a un nuovo endpoint.

    Vedrai due versioni della soluzione: la base e l'aggiornamento. Qualsiasi componente nell'ambiente al di fuori di queste soluzioni farà ancora riferimento alla versione precedente del modello. I componenti in queste soluzioni faranno riferimento alla versione del modello contenuta nella soluzione corrispondente.

    Nell'esempio seguente, il flusso cloud nella soluzione di base fa riferimento alla versione precedente e il flusso cloud nella nuova soluzione fa riferimento alla nuova versione.

    Screenshot dei componenti prima che venga eseguito lo staging per l'aggiornamento.

  5. Per aggiornare la versione precedente, seleziona Applica aggiornamento.

    Screenshot dei componenti dopo l'applicazione dell'aggiornamento.

Tutti i componenti nell'ambiente ora fanno riferimento alla nuova versione del modello.

Panoramica della gestione del ciclo di vita dell'applicazione
Nozioni di base di ALM
Importare soluzioni
Aggiornare o eseguire l'upgrade di una soluzione