Importar um agente para um ambiente alvo

Implemente agentes em ambientes sandbox ou de teste antes de os implementar em produção. Esta abordagem garante que funcionam corretamente e ajuda-o a evitar potenciais perturbações nas operações do seu negócio.
No Dynamics 365 Sales, utilize as capacidades de Gestão do Ciclo de Vida de Aplicações (ALM) do Power Platform para exportar e importar soluções de agentes em vários ambientes. Exporte a solução do agente a partir do ambiente de origem, como um sandbox ou ambiente de teste, e depois importe-a para o ambiente de destino, normalmente em produção.

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

Melhores práticas

• Crie uma solução por perfil de agente para garantir que cada perfil possa ser empacotado e implementado de forma independente. Incluir múltiplos perfis numa ú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 a funcionar após a migração para outro ambiente. Caso contrário, pode ser necessário atualizar manualmente os filtros após a importação.

Exportar o agente como solução

Exportar o agente do ambiente de origem como solução. Durante o processo de exportação, pode escolher incluir todos os componentes do agente ou selecionar componentes específicos para incluir na solução. Depois de concluída a exportação, tens um ficheiro de solução para importar para o ambiente de destino.

1. No ambiente de origem, vá ao portal Power Apps maker.

2. Selecione o ambiente que contém o agente que quer exportar.

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

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

5. Adiciona os componentes necessários.
   Selecione Adicionar existente>Mais>Outros e depois adicione os seguintes componentes:

   • Perfil do Agente de Vendas. Quando cria o agente, um perfil correspondente é automaticamente criado. No painel Adicionar SalesAgentProfile existente , selecione o perfil do agente da lista de perfis de agentes existentes.
   • SalesAgentConfigurationV2. Quando crias o agente, as configurações correspondentes do agente são automaticamente criadas com o mesmo nome do perfil do agente. No painel Adicionar SalesAgentConfigurationV2 existente , selecione a configuração do agente que tem o mesmo nome do perfil do agente que selecionou.
   • Sequência (apenas para Agente de Qualificação de Vendas). Quando cria o Agente de Qualificação de Vendas, um registo de sequência correspondente é criado automaticamente no módulo de sequência. No painel Adicionar Sequência existente , selecione o registo de sequência com o nome AgenticSequence.

6. Adicione fontes de conhecimento.

   Observação

   Este passo não é aplicável ao Data Enrichment Agent.

   SelecioneAdicionar Agente>> e depois adicione agentes que contenham fontes de conhecimento relevantes para o agente que pretende exportar. Por exemplo, se estiveres a exportar o Sales Opportunity Agent - Account Research, as fontes de conhecimento relacionadas com a pesquisa de contas são automaticamente adicionadas como parte do componente do agente. Cada tipo de agente requer um conjunto específico de agentes na solução. A tabela seguinte mostra os agentes que precisa de adicionar para cada solução de agente.

   Tipo de solução para agentes de vendas	Agentes a acrescentar
   Agente de Qualificação de Vendas	Agente de Vendas D365 - Pesquisa D365 Agente de Vendas - Concorrente Agente de Vendas D365 - Pesquisa Personalizada Agente de Vendas D365 - Prontidão Agente de Vendas D365 - Validação de Email D365 Agente de Vendas - Divulgação D365 Agente de Vendas - Engage Autonomous Agente de Vendas D365 - Agente de Preenchimento TCP Agente de Vendas D365 - Pesquisa de Partes Interessadas D365 Agente de Vendas - Engage Autonomous D365 Agente de Vendas - Sintetizador de Resumo
   Agente de Oportunidades de Vendas	Agente de Oportunidades de Vendas Agente de Oportunidades de Venda - Pesquisa de Contas Agente de Oportunidades de Vendas - Compete Research Agente de Oportunidades de Vendas - Pesquisa Personalizada Agente de Oportunidades de Vendas - Parte Interessada
   Agente de Fechamento de Vendas	Agente de Fechamento de Vendas

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

7. Guarde e publique as personalizações.

8. Selecione Exportar para exportar a solução e guarde-a numa localização no seu computador.
   Durante o processo de exportação, escolha a solução como solução gerida. Uma solução gerida é normalmente utilizada em ambientes de produção. Para mais informações sobre soluções de exportação, consulte Soluções de exportação.

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

Importa o ficheiro de solução exportado para o ambiente de destino. Durante o processo de importação, pode optar por sobrescrever quaisquer componentes existentes no ambiente de destino que tenham o mesmo nome dos da solução. Após a conclusão da importação, o agente está disponível no ambiente de destino.

Importar a solução

1. Vai ao portal de criadores Power Apps no ambiente alvo.
2. Selecione o ambiente alvo onde quer importar a solução do agente.
3. No painel de navegação esquerdo, selecione Soluções.
4. Selecione Importar solução e carregue o ficheiro de solução que exportou do ambiente de origem.
   Para mais informações, consulte Soluções de importação.
5. Siga as instruções para concluir o processo de importação. Durante a importação, opte por sobrescrever quaisquer componentes existentes no ambiente de destino que tenham o mesmo nome dos da solução. Esta opção garante que os componentes do agente são atualizados com os do ambiente de origem. A solução é importada para o ambiente alvo e está listada na página de agentes de IA no seu ambiente.

Configurar e iniciar o agente

Depois de importar a solução, o agente é importado em estado de rascunho. Abra o agente e configure definiçõ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 Oportunidades de Vendas, Agente de Fecho de Vendas e Agente de Enriquecimento de Dados. Siga os passos correspondentes com base no tipo de agente que importou:

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

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

   • Utilizador da aplicação Dataverse
   • Registos obrigatórios de candidaturas

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

   • Para Agente de Qualificação de Vendas, consulte Configurar requisitos para Agente de Qualificação de Vendas.
   • Para o Agente de Oportunidades de Venda, consulte Configurar requisitos para o Agente de Oportunidades de Venda.
   • Para o Agente de Fecho de Vendas, consulte os requisitos de configuração para o Agente de Fecho de Vendas.

3. Selecione o utilizador da aplicação. Os utilizadores da aplicação diferem entre ambientes de origem e de destino.

   1. Vai à página de configuração do agente importado.
   2. Na página de definições do perfil do agente, selecione a aplicação Dataverse criada pelo utilizador para este agente.

4. Revê as regras da tarefa ou critérios de seleção. Alguns valores relacionados com atribuição configurados no ambiente de origem podem não se resolver corretamente no ambiente de destino. Por exemplo, se a regra de atribuição for baseada numa equipa ou utilizador que não existe no ambiente alvo, atualize a regra para garantir que funciona corretamente.

   1. Abre a página de definições das regras de atribuição .
   2. Atualize quaisquer valores e textos não resolvidos ou incorretos para garantir que as regras de atribuição funcionam conforme esperado no ambiente de destino.

5. Verifique as fontes de conhecimento. As fontes de conhecimento aparecem automaticamente após a importação da solução se foram adicionadas aos bots correspondentes no ambiente de origem. No entanto, o conteúdo dentro dessas fontes de conhecimento pode variar entre ambientes. Por exemplo, se uma biblioteca de documentos SharePoint fosse usada como 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 alvo.

   1. Abra a página de Configurações de Fontes de Conhecimento.
   2. Verifique se todas as fontes de conhecimento configuradas estão disponíveis. Se alguma fonte de conhecimento estiver em falta ou não estiver corretamente configurada, atualize-a para garantir que o agente tem acesso à informação necessária.

6. Ativa o agente. Depois de atualizar as definições específicas do ambiente, guarde e inicie o agente.

Para o Agente de Enriquecimento de Dados

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

2. Revisão das regras de seleção de registos. Alguns valores nas regras de seleção de registos podem não ser resolvidos corretamente no ambiente alvo. Por exemplo, se a regra for baseada numa equipa ou utilizador que não existe no ambiente alvo, atualize a regra para garantir que funciona corretamente.

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

3. Verificar o acesso dos utilizadores. O acesso do utilizador ao agente pode variar entre os ambientes de origem e de destino. Garantir que os utilizadores no ambiente de destino têm as permissões necessárias para aceder e usar o agente.

   1. Na página de configuração, vá à página de definições de acesso ao utilizador .
   2. Verifique se todos os utilizadores que precisam de acesso ao agente têm as permissões adequadas.
      Para saber mais sobre o acesso do utilizador, consulte Configurar o acesso do utilizador.

4. Verifique o âmbito do campo. Os campos selecionados para enriquecimento no ambiente de origem podem não ser os mesmos que no ambiente alvo. Revise os campos selecionados para garantir que estão alinhados com os requisitos do ambiente alvo.

   1. Na página de configuração, vai à página de definições de comportamento do agente .
   2. Na secção de âmbito de campo , reveja os campos selecionados e atualize-os se necessário para garantir que o agente enriquece os dados corretos no ambiente alvo.
      Para saber mais sobre o âmbito do campo, consulte Configurar comportamento do agente.

5. Ativa o agente. Depois de atualizar as definições específicas do ambiente, guarde e inicie o agente.

Informações relacionadas

Agentes AI no Dynamics 365 Sales