Compartilhar via


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 runtime de fluxo mencionando uma limitação de dados, sugerimos que você desative o modo expresso 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 nova infraestrutura. Consulte Disponibilidade e Licenciamento para 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 'Quando um agente chama um fluxo ' ou do 'Quando um app chama um gatilho de fluxo enquanto você está construindo o fluxo no designer no cartão de gatilho'.

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

Diretrizes para usar o modo expresso

Quando usar o modo expresso Quando não usar o modo expresso
Fluxos pesados em lógica: Seu fluxo de agentes não retorna grandes quantidades de dados da resposta do conector (grandes quantidades de dados excedem o limite de memória do modo expresso). Fluxos pesados em dados: Seu fluxo de agente move muitos dados (por exemplo, listar as linhas em uma tabela grande, ou uma ação obter 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 rodado 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 alguns passos descritos nos ambientes 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 na 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.