Ler em inglês

Partilhar via


Empacote o seu próprio modelo utilizando soluções

Depois de ter registado o seu próprio modelo no AI Builder utilizando um pacote Python, pode embalar o seu modelo utilizando soluções para executar tarefas de gestão de ciclo de vida de aplicações (ALM), tais como:

As soluções são utilizadas para transportar aplicações e componentes de um ambiente para outro. Também são utilizadas para aplicar um conjunto de personalizações às aplicações existentes. Para obter informações detalhadas sobre soluções e como são utilizadas para aplicar conceitos de ALM no Microsoft Power Platform, aceda à Descrição geral da gestão do ciclo de vida da aplicação.

Exportar o seu próprio modelo utilizando uma solução

Neste exemplo, exportará duas soluções:

  • A solução que contém apenas o conector personalizado
  • A solução que contém o modelo, a referência de ligação e quaisquer outros componentes
  1. Certifique-se de que registou o seu próprio modelo no ambiente de origem utilizando um pacote Python. Se ainda não o registou, siga o procedimento em Traga o seu próprio tutorial de modelo (no GitHub).

  2. Crie uma solução para armazenar o conector personalizado que está associado ao modelo:

    1. Iniciar sessão no Power Apps ou no Power Automate.
    2. No painel esquerdo, selecione Soluções>Nova solução.
    3. Preencha os campos na caixa de diálogo da Nova solução. Para obter informações detalhadas sobre cada campo, aceda a Criar uma solução.
    4. Selecione Criar.

    Captura de ecrã de como criar uma solução para armazenar o conector personalizado.

  3. Adicione um conector personalizado existente ao selecionar Adicionar existente>Automatização>Conector personalizado.

    Captura de ecrã de como adicionar um conector personalizado existente.

  4. Selecione o conector personalizado que está associado ao modelo.

    O nome estará neste formato: <model_name>-<random number>-v<version>. A versão ajuda a distinguir o conector a adicionar quando atualiza o modelo.

    Captura de ecrã do formato de atribuição de nome do conector personalizado.

  5. Exportar a solução Para obter ajuda sobre como exportar soluções, aceda a Soluções de exportação para o Power Apps ou Soluções de exportação para o Power Automate.

  6. Criar uma nova solução para adicionar o modelo e quaisquer outros componentes:

    1. Selecione Soluções>Novas soluções.
    2. Preencha os campos na caixa de diálogo da Nova solução.
    3. Selecione Criar.

    Captura de ecrã de como criar uma nova solução para adicionar o modelo e quaisquer outros componentes.

  7. Adicione uma referência de ligação existente ao selecionar Adicionar existente>Mais>Referência de ligação (pré-visualização).

    Captura de ecrã de como adicionar uma referência de ligação existente.

  8. Adicione a referência de ligação existente associada ao modelo.

    O formato de atribuição de nome é o mesmo que o conector personalizado no passo 4: <model_name>-<random number>-v<version>.

    Captura de ecrã do formato de atribuição de nome da referência de ligação.

  9. Adicione o modelo de IA ao selecionar Adicionar existente>Modelo de IA.

    Captura de ecrã sobre como adicionar o seu modelo de IA ao AI Builder.

    A sua solução deve conter os componentes indicados na seguinte imagem.

    Captura de ecrã dos três componentes adicionados: um modelo de IA, uma referência de ligação e um conector personalizado.

  10. (Opcional) Adicione todos os componentes que desejar. Neste exemplo, vamos adicionar um fluxo de cloud que utiliza o modelo.

    Captura de ecrã de novos componentes adicionados.

  11. Exportar a solução Para obter ajuda sobre como exportar soluções, aceda a Soluções de exportação para o Power Apps ou Soluções de exportação para o Power Automate.

Importar o seu próprio modelo para o ambiente de destino

Neste exemplo, irá importar duas soluções que criou na secção anterior:

  • A solução que contém apenas o conector personalizado
  • A solução que contém o modelo, a referência de ligação e quaisquer outros componentes

Para obter ajuda sobre como importar soluções, aceda a Soluções de importação para o Power Apps ou Soluções de importação para o Power Automate.

  1. Iniciar sessão no Power Apps ou no Power Automate.

  2. Importe a solução que contém apenas o conector personalizado.

  3. Importe a solução que contém o modelo, a referência de ligação e quaisquer outros componentes.

  4. Durante o processo de importação, crie a ligação ao seu ponto final externo:

    • Se o seu ponto final não estiver seguro, selecione Criar.
    • Se o seu ponto final estiver seguro com uma chave API, insira-a no campo de Chave API e, em seguida, selecione Criar.

    Captura de ecrã da ligação a um ponto final externo.

O seu modelo está agora pronto para ser consumido no seu ambiente de destino.

Captura de ecrã das soluções importados.

Se tiver problemas com a sua importação, aceda a Resolução de problemas da importação de soluções.

Atualizar o seu próprio modelo

Atualize a sua solução para o número de versão mais recente para que acumule todos os patches anteriores num só passo. Qualquer componente associado à versão anterior da solução e que não esteja na versão da solução mais recente será eliminado. Isto garante que os componentes desatualizados não serão incluídos na solução.

Nos exemplos, irá atualizar duas soluções:

  • A solução que contém apenas o conector personalizado
  • A solução que contém o modelo, a referência de ligação e quaisquer outros componentes

Para obter ajuda sobre como atualizar, aceda a Atualizar uma solução.

Atualizar o seu próprio modelo em ambientes de origem ou destino

  1. Certifique-se de que registou o seu modelo atualizado no ambiente de origem ao utilizar um pacote Python. Se ainda não o registou, siga o procedimento em Traga o seu próprio tutorial de modelo (no GitHub).

  2. Iniciar sessão no Power Apps ou no Power Automate.

  3. Na solução que contém apenas o conector personalizado, adicione um novo conector personalizado existente ao selecionar Adicionar.

  4. Preencha os campos e introduza a nova versão. Neste exemplo, é v2 porque esta é a segunda versão.

  5. Remova a versão mais antiga do conector personalizado da solução:

    1. Selecione as reticências verticais (⋮) ao lado da versão mais antiga.
    2. Selecione Remover>Remover desta solução.

    Captura de ecrã sobre como remover uma versão mais antiga de uma solução.

  6. Exporte a solução selecionando Exportar. Por definição, a versão será incrementada durante a exportação.

  7. Na solução que contém o modelo, a referência de ligação e quaisquer outros componentes, atualize a referência de ligação para apontar para a versão mais recente:

    1. A ligação personalizada terá o mesmo nome que o conector personalizado que adicionou no passo 4. Neste exemplo, v2 é a versão mais recente.
    2. Remova a versão mais antiga da referência de ligação da solução selecionando o nome a remover (neste exemplo, v1) e, em seguida, selecione Remover>Remover desta solução.
  8. Exporte a solução selecionando Exportar. O modelo de IA e qualquer componente que se refere ao modelo são automaticamente atualizados para apontar para a versão mais recente.

Atualizar o seu próprio modelo em ambientes de destino

  1. Iniciar sessão no Power Apps ou no Power Automate.

  2. Importe a solução que contém apenas o conector ao selecionar Importar>Atualizar.

  3. Importe a solução que contém o modelo, referência de ligação e qualquer outro componente ao selecionar Importar>Atualizar.

  4. Criar novas ligações com o novo ponto final:

    1. Se o seu ponto final não estiver seguro, selecione Criar.
    2. Se o seu ponto final estiver seguro com uma chave API, insira-a no campo de Chave API e, em seguida, selecione Criar.

    Captura de ecrã da ligação a um novo ponto final externo.

O modelo irá agora fazer referência ao novo ponto final no ambiente de destino.

Captura de ecrã do modelo relativo ao novo ponto final no ambiente de destino.

Preparar o seu próprio modelo para atualizar

Preparar o seu modelo para atualizar apenas o importa para a organização. Não o torna ativo. Neste cenário, os componentes relativos ao modelo no ambiente irão fazer referência à versão antiga até concluir este procedimento ao aplicar a atualização.

Para obter ajuda sobre como importar soluções, aceda a Soluções de importação para o Power Apps ou Soluções de importação para o Power Automate.

  1. Iniciar sessão no Power Apps ou no Power Automate.

  2. Importe a solução que contém apenas o conector ao selecionar Importar>Atualizar.

  3. Importe a solução que contém o modelo, a referência de ligação e qualquer outro componente ao selecionar Importar>Preparar para atualizar.

  4. Criar novas ligações com o novo ponto final:

    1. Se o seu ponto final não estiver seguro, selecione Criar.
    2. Se o seu ponto final estiver seguro com uma chave API, insira-a no campo de Chave API e, em seguida, selecione Criar.

    Captura de ecrã da ligação a um novo ponto final externo.

    Verá duas versões da solução: a base e a atualização. Qualquer componente no ambiente fora destas soluções continuará a remeter para a versão antiga do modelo. Os componentes dentro destas soluções continuarão a remeter para a versão antiga do modelo contido na solução correspondente.

    No exemplo seguinte, o fluxo de cloud na solução base remete para a versão antiga e o fluxo de cloud na nova solução remete para a nova versão.

    Captura de ecrã dos componentes antes de serem preparados para atualizar.

  5. Para atualizar a versão antiga, selecione Aplicar atualização.

    Captura de ecrã dos componentes após a atualização ser aplicada.

Todos os componentes do ambiente remetem agora para a nova versão do modelo.

Descrição geral da gestão do ciclo de vida das aplicações
Noções básicas do ALM
Importar soluções
Atualizar a versão ou atualizar uma solução