Importar um agente para um ambiente de destino

Implante agentes em ambientes de área restrita ou de teste antes de implantá-los em produção. Essa abordagem garante que eles funcionem corretamente e ajuda você a evitar possíveis interrupções em suas operações de negócios.
Em Dynamics 365 Sales, use os recursos de ALM (Gerenciamento de Ciclo de Vida do Aplicativo) do Power Platform para exportar e importar soluções de agente entre ambientes. Exporte a solução do agente de um ambiente de origem, como uma área restrita ou um ambiente de teste, e importe-a para o ambiente de destino, normalmente produção.

Use este procedimento para importar uma solução de agente de vendas, como Agente de Qualificação de Vendas, Agente de Oportunidade de Vendas, Agente de Fechamento de Vendas ou Agente de Enriquecimento de Dados para um ambiente de destino.

Práticas Recomendadas

• Crie uma solução por perfil de agente para garantir que cada perfil possa ser empacotado e implantado de forma independente. A inclusão de vários perfis em uma única solução pode resultar na exportação de alterações não intencionais ou não testadas.

• Use filtros independentes da organização nos critérios de seleção para que os perfis continuem funcionando após a migração para outro ambiente. Caso contrário, talvez seja necessário atualizar manualmente os filtros após a importação.

Exportar o agente como uma solução

Exporte o agente do ambiente de origem como uma solução. Durante o processo de exportação, você pode optar por incluir todos os componentes do agente ou selecionar componentes específicos a serem incluídos na solução. Depois que a exportação for concluída, você terá um arquivo de solução para importar para o ambiente de destino.

1. No ambiente de origem, vá para o portal do criador do Power Apps.

2. Selecione o ambiente que contém o agente que você deseja exportar.

3. No painel de navegação esquerdo, selecione Soluções.

4. Selecione Nova solução para criar uma solução e insira os detalhes necessários, como nome, editor e versão.

5. Adicionar componentes necessários.
   Selecione AdicionarMais>Outros> e adicione os seguintes componentes:

   • SalesAgentProfile. Quando você cria o agente, um perfil de agente correspondente é criado automaticamente. No painel Add existing SalesAgentProfile, selecione o perfil do agente da lista de perfis de agente existentes.
   • SalesAgentConfigurationV2. Quando você cria o agente, as configurações de agente correspondentes são criadas automaticamente com o mesmo nome que o perfil do agente. No painel Adicionar SalesAgentConfigurationV2 existente , selecione a configuração do agente que tem o mesmo nome do perfil do agente selecionado.
   • Sequência (somente para Agente de Qualificação de Vendas ). Quando você cria o Agente de Qualificação de Vendas, um registro de sequência correspondente é criado automaticamente no componente de sequência. No painel Adicionar Sequência existente , selecione o registro de sequência com o nome AgenticSequence.

6. Adicione fontes de conhecimento.

   Note

   Esta etapa não é aplicável ao Agente de Enriquecimento de Dados.

   Selecione Adicionaragente>existente> e, em seguida, adicione agentes que contêm fontes de conhecimento relevantes para o agente que você deseja exportar. Por exemplo, se você estiver exportando o Agente de Oportunidade de Vendas – Pesquisa de Conta, fontes de conhecimento relacionadas à pesquisa de conta serão adicionadas automaticamente como parte do componente do agente. Cada tipo de agente requer um conjunto específico de agentes na solução. A tabela a seguir mostra os agentes que você precisa adicionar para cada solução de agente.

   Tipo de solução do agente de vendas	Agentes a serem adicionados
   Agente de Qualificação de Vendas	Agente de Vendas D365 – Pesquisa Agente de Vendas D365 – Concorrente Agente de Vendas D365 – Pesquisa Personalizada Agente de Vendas D365 – Preparação Agente de Vendas D365 – Validação por email Agente de Vendas D365 – Divulgação Agente de Vendas D365 – Engajar Autônomo Agente de Vendas D365 – Agente de Pré-preenchimento TCP Agente de Vendas D365 – Pesquisa de Stakeholders Agente de Vendas D365 – Engajar Autônomo Agente de Vendas D365 – Sintetizador de Resumo
   Agente de Oportunidade de Vendas	Agente de Oportunidade de Vendas Agente de Oportunidade de Vendas – Pesquisa de Contas Agente de Oportunidade de Vendas – Pesquisa de Competência Agente de Oportunidade de Vendas – Pesquisa Personalizada Agente de Oportunidades de Vendas – Parte Interessada
   Agente de Fechamento de Vendas	Agente de Fechamento de Vendas

   A imagem a seguir mostra um exemplo dos componentes adicionados para o Agente de Qualificação de Vendas.
   

7. Salve e publique as personalizações.

8. Selecione Exportar para exportar a solução e salvá-la em um local em seu computador.
   Durante o processo de exportação, escolha a solução como solução gerenciada. Uma solução gerenciada normalmente é usada para ambientes de produção. Para obter mais informações sobre como exportar soluções, consulte Exportar soluções.

Importar a solução do agente para o ambiente de destino

Importe o arquivo de solução exportado para o ambiente de destino. Durante o processo de importação, você pode optar por substituir todos os componentes existentes no ambiente de destino que tenham o mesmo nome que os da solução. Depois que a importação for concluída, o agente estará disponível no ambiente de destino.

Importar a solução

1. Acesse o portal do Power Apps maker no ambiente de destino.
2. Selecione o ambiente de destino em que você deseja importar a solução do agente.
3. No painel de navegação esquerdo, selecione Soluções.
4. Selecione Importar solução e carregue o arquivo de solução exportado do ambiente de origem.
   Para obter mais informações, consulte Importar soluções.
5. Siga os prompts para concluir o processo de importação. Durante a importação, escolha substituir todos os componentes existentes no ambiente de destino que tenham o mesmo nome que os da solução. Essa opção garante que os componentes do agente sejam atualizados com os do ambiente de origem. A solução é importada para o ambiente de destino e está listada na página agentes de IA em seu ambiente.

Configurar e iniciar o agente

Depois de importar a solução, o agente é importado em estado de rascunho. Abra o agente e defina as configurações específicas do ambiente antes de iniciar o agente. Configurar e iniciar o agente é diferente para Agente de Qualificação de Vendas, Agente de Oportunidade de Vendas, Agente de Fechamento de Vendas e Agente de Enriquecimento de Dados. Siga as etapas correspondentes com base no tipo de agente importado:

Para Agente de Qualificação de Vendas, Agente de Oportunidade de Vendas e Agente de Fechamento de Vendas

1. Crie os seguintes componentes manualmente no ambiente de destino, pois eles são específicos do ambiente e não estão incluídos na solução exportada:

   • Usuário do aplicativo Dataverse
   • Registros de aplicativo necessários

2. Configure os pré-requisitos. A solução exportada não inclui pré-requisitos porque geralmente contêm valores específicos do ambiente que podem diferir entre ambientes de origem e de destino.

   • Para o Agente de Qualificação de Vendas, consulte Configurar requisitos para o Agente de Qualificação de Vendas.
   • Para o Agente de Oportunidade de Vendas, consulte Configurar requisitos para o Agente de Oportunidade de Vendas.
   • Para o Agente de Fechamento de Vendas, consulte Configurar requisitos para o Agente de Fechamento de Vendas.

3. Selecione o usuário do aplicativo. Os usuários do aplicativo diferem entre os ambientes de origem e de destino.

   1. Vá para a página de configuração do agente importado.
   2. Na página de configurações de perfil do agente, selecione o usuário do aplicativo Dataverse criado para esse agente.

4. Examine as regras de atribuição ou os critérios de seleção. Alguns valores relacionados à atribuição configurados no ambiente de origem podem não ser resolvidos corretamente no ambiente de destino. Por exemplo, se a regra de atribuição for baseada em uma equipe ou usuário que não existe no ambiente de destino, atualize a regra para garantir que ela funcione corretamente.

   1. Abra a página de configurações de regras de atribuição .
   2. Atualize qualquer texto e valores não resolvidos ou incorretos para garantir que as regras de atribuição funcionem conforme o esperado no ambiente de destino.

5. Verifique as fontes de conhecimento. As fontes de conhecimento aparecerão automaticamente após a importação da solução se forem adicionadas aos bots correspondentes no ambiente de origem. No entanto, o conteúdo dentro dessas fontes de conhecimento pode ser diferente entre ambientes. Por exemplo, se uma biblioteca de documentos SharePoint foi usada como uma fonte de conhecimento no ambiente de origem, a mesma biblioteca de documentos pode não estar disponível no ambiente de destino. Atualize as fontes de conhecimento para apontar para o conteúdo correto no ambiente de destino.

   1. Abra a página de configurações de fontes de dados de conhecimento .
   2. Verifique se todas as fontes de conhecimento configuradas estão disponíveis. Se alguma fonte de conhecimento estiver ausente ou não estiver configurada corretamente, atualize-a para garantir que o agente tenha acesso às informações necessárias.

6. Ative o agente. Depois de atualizar as configurações específicas do ambiente, salve e inicie o agente.

Para o Agente de Enriquecimento de Dados

1. Configure os pré-requisitos. A solução exportada não inclui pré-requisitos porque geralmente contêm valores específicos do ambiente que podem diferir entre ambientes de origem e de destino. Consulte Configurar pré-requisitos para obter mais informações.

2. Examine as regras de seleção de registro. Alguns valores nas regras de seleção de registro podem não ser resolvidos corretamente no ambiente de destino. Por exemplo, se a regra for baseada em uma equipe ou usuário que não existe no ambiente de destino, atualize a regra para garantir que ela funcione corretamente.

   1. Na página de configuração, vá para as configurações de seleção de registro.
   2. Atualize quaisquer valores não resolvidos ou incorretos para garantir que as regras de seleção de registro funcionem conforme o esperado no ambiente de destino.
      Para saber mais sobre a seleção de registros, consulte Selecionar registros para enriquecimento.

3. Verifique o acesso do usuário. O acesso do usuário ao agente pode ser diferente entre ambientes de origem e de destino. Verifique se os usuários no ambiente de destino têm as permissões necessárias para acessar e usar o agente.

   1. Na página de configuração, vá para a página Configurações de acesso do usuário .
   2. Verifique se todos os usuários que precisam de acesso ao agente têm as permissões apropriadas.
      Para saber mais sobre o acesso do usuário, consulte Configurar o acesso do usuário.

4. Verifique o escopo do campo. Os campos selecionados para enriquecimento no ambiente de origem podem não ser os mesmos do ambiente de destino. Examine os campos selecionados para garantir que eles estejam alinhados com os requisitos no ambiente de destino.

   1. Na página de configuração, vá para a página de configurações de comportamento do Agente .
   2. Na seção Escopo de campo , examine os campos selecionados e atualize-os, se necessário, para garantir que o agente enriqueça os dados corretos no ambiente de destino.
      Para saber mais sobre o escopo do campo, consulte Configurar o comportamento do agente.

5. Ative o agente. Depois de atualizar as configurações específicas do ambiente, salve e inicie o agente.

Informações relacionadas

agentes de Inteligência Artificial no Dynamics 365 Sales