Acelere a execução do fluxo do agente com o modo expresso (versão prévia)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Por padrão, um fluxo de agente iniciado por um agente ou aplicativo falhará se levar mais de dois minutos para responder ao agente de chamada ou aplicativo. Essa falha afeta a funcionalidade e a usabilidade do agente ou aplicativo que chama o fluxo.

Captura de tela do aviso de tempo limite do fluxo do agente.

Importante

Este artigo contém a documentação de versão prévia do Microsoft Copilot Studio e está sujeito a alterações.

Os recursos de visualização não são destinados ao uso de produção e podem ter funcionalidade restrita. Esses recursos estão disponíveis antes de um lançamento oficial para que você possa obter acesso antecipado e fornecer comentários.

Se você estiver criando um agente pronto para produção, confira a visão geral do Microsoft Copilot Studio.

Com o modo expresso, um fluxo pode alcançar tempos de execução mais rápidos. Esse recurso aumenta a probabilidade de que os fluxos de agentes possam ser concluídos dentro da janela de dois minutos e fornecer uma resposta a tempo.

A imagem a seguir mostra um exemplo da aceleração de um fluxo específico com modo expresso e sem ele.

Captura de tela da comparação de desempenho entre sem modo expresso e com o modo expresso.

Observação

A aceleração varia de acordo com a complexidade do fluxo e as ações usadas dentro dele. O modo Express funciona melhor para fluxos que não transferem muitos dados dos conectores, mas que exigem bastante tempo de processamento. Recomendamos testar seus fluxos para ver se o modo expresso é adequado para seu cenário específico e o quanto ele melhora o desempenho do fluxo. Se você encontrar um erro de execução de fluxo mencionando uma limitação de dados, sugerimos que você desative o modo rápido e tente com outros fluxos.

Pré-requisitos

Para usar o modo expresso, seu fluxo deve atender aos seguintes requisitos:

  • O fluxo deve ter o gatilho Quando um agente chama um fluxo ou Quando um aplicativo chama um fluxo.
  • O fluxo deve ter uma ação resposta, responder ao agente ou responder ao aplicativo.
  • O fluxo deve ter um plano do Copilot Studio associado a ele.
  • O ambiente Power Automate deve estar em uma nova infraestrutura. Consulte Disponibilidade para obter mais informações.

Ativar o modo expresso

  1. Selecione Fluxos e selecione o fluxo para o qual você deseja ativar o modo expresso.

  2. Na seção Detalhes da página Visão Geral , selecione Editar.

    O painel Detalhes é exibido.

  3. Habilite o modo Express. O alternador está na parte inferior do painel.

    Captura de tela do interruptor do modo expresso na página de detalhes do fluxo.

Observação

Você também pode ativar o modo expresso a partir do gatilho Quando um agente chama um fluxo ou Quando um aplicativo chama um fluxo enquanto você está criando o fluxo no designer no cartão do gatilho.

Captura de tela mostrando o modo expresso de ativar no cartão de gatilho no designer de fluxo.

Diretrizes para usar o modo expresso

Quando usar o modo expresso Quando não usar o modo expresso
Fluxos pesados lógicos: o fluxo do agente que não retorna grandes volumes de dados da resposta dos conectores (grandes volumes de dados excedem o limite de memória do modo expresso). Fluxos de dados intensivos: Seu fluxo agente processa grandes volumes de dados (por exemplo, listar as linhas em uma tabela grande, ou uma ação de obtenção de itens devolve 1.500 linhas de dados com 100 colunas).
O fluxo do agente tem uma ação de resposta, o que significa que o fluxo é sensível ao tempo. Um agente aguarda a execução do fluxo e reenvia uma resposta o mais rápido possível. O fluxo do agente não tem uma ação de resposta. O fluxo é do tipo "dispare e esqueça". Ele não precisa enviar de volta uma resposta a um agente de chamada ou aplicativo.
O modo Express é executado com êxito e de forma ideal durante o teste. O modo expresso falha durante o teste devido a um limite de tamanho ou de memória variável. Se o fluxo falhar durante um teste, provavelmente você enfrentará esses problemas quando o fluxo for implantado e executado em produção.

Disponibilidade

Atualmente, o modo Express só está disponível para alguns ambientes que são atualizados para uma nova arquitetura que dá suporte a ele. A Microsoft está em processo de atualização de ambientes para dar suporte ao modo expresso. Nenhuma ação é necessária de sua parte para atualizar seu ambiente.

Para verificar se o modo expresso está disponível em seu ambiente:

  1. Verifique se você tem um fluxo de agente simples no Copilot Studio, com o gatilho Quando um agente chama um fluxo ou Quando um aplicativo chama um fluxo, e alguma ação. Se você não tiver um fluxo com esses elementos, crie um.

  2. Verifique se o modo expresso alterna no designer do cartão de gatilho.

Se o modo expresso não aparecer, seu ambiente ainda não oferecerá suporte a esse recurso.

Observação

Se seu ambiente ainda não está na nova infraestrutura, pode ter alguns fluxos que estão atrasando a atualização do ambiente. Você pode seguir algumas etapas descritas nos ambientes do Power Automate, migrar para uma nova arquitetura para ajudar a desbloquear a atualização automática futura.

Licenciamento

O modo expresso está disponível apenas para fluxos no plano Copilot Studio. Não há custo adicional para rodar seus fluxos nesse modo. Você ainda é cobrado pelo número de ações usadas no sistema de medição do Copilot Studio.

Limitações

Aqui estão algumas limitações conhecidas a serem observadas ao usar o modo expresso.

Limitações na publicação de fluxo

Ações de Atraso e webhook no fluxo não têm suporte quando o modo expresso está ativado. Erros aparecem ao salvar o fluxo. Para esses casos, tente desativar o modo expresso e tente novamente.

Limitações em tempo de execução de fluxo

Há algumas limitações de runtime ao usar o modo expresso.

Tempo de execução

Com o modo expresso ativado, os fluxos devem ser concluídos em dois minutos. Fluxos que ultrapassam o tempo limite.

Tamanho do fluxo

  • Você não deve incluir mais de 100 ações em uma execução de fluxo. A contagem de ações inclui loops, que contam como uma ação para cada iteração de loop. Os seguintes limites se aplicam a loops:
    • Aplicar a cada loop em uma matriz: máximo de 100 itens
    • Faça até loop: máximo de 100 iterações
  • Limite de conteúdo variável: 1.024 caracteres. Se puder, encontre soluções alternativas para não inserir mais de 1.024 caracteres em variáveis como Set variable, Append to String Variable ou Initialize variable.

100 ações é um limite seguro para o tamanho do fluxo. Você pode conseguir fazer mais de 100 ações, dependendo do volume do fluxo e da quantidade de processamento de dados que ele faz. Para mais informações sobre como gerenciar o tamanho do fluxo, veja Diretrizes para uso do modo expresso.

Tamanho da mensagem

O limite de tamanho da mensagem para dados passados em uma ação individual (resposta do conector) é de 64 KB.

Mensagens de erro

Mostramos mensagens de erro em runtime detalhando por que o fluxo falhou se for devido a qualquer uma das limitações de runtime mencionadas anteriormente. Se você tiver um fluxo que não atenda aos pré-requisitos para o modo expresso, recomendamos executar o fluxo com o modo expresso Desativado.

Outras limitações ao usar o modo expresso

  • Testar o fluxo automaticamente não funciona no designer de fluxo. O teste utiliza automaticamente o reenvio de fluxo e o reenvio de fluxo não pode ser utilizado com fluxos acionados pelo agente ou acionados pelo aplicativo.
  • As iterações de loop não aparecem no modo de exibição Executar detalhes quando uma resposta do conector excede o limite de memória. Em alguns casos, você pode notar que as iterações de loop não aparecem quando você monitora um loop (Aplicar a cada loop ou Fazer até). Teste seu fluxo em um ambiente de desenvolvimento e ative o modo expresso para depuração antes de publicar na produção.