Introdução aos Fluxos de Trabalho Mistral
Nesta página
Atualização de 2 de novembro de 2026 — Modelos. O Mistral Large 3 (
mistral-large-2512) e o Mistral Medium 3.5 foram descontinuados a 31 de outubro de 2026 e serão retirados de serviço a 30 de abril de 2027. O seu sucessor designado, Mistral Large 4 (mistral-large-4), está em antevisão pública desde 6 de outubro. Os exemplos deste curso utilizam o aliasmistral-large-latest, que ainda aponta para o Mistral Large 3 de acordo com a sua especificação oficial (verificado a 3 de novembro de 2026), tal comomistral-medium-latestaponta para o Mistral Medium 3.5. Estes aliases permanecerão válidos até 30 de abril de 2027. Para novos projetos, teste omistral-large-4, o seu sucessor designado.
Orquestração de Tarefas Complexas de IA
Uma aplicação de IA séria nunca cabe numa única chamada à API. Considere um serviço que gera um relatório de cliente todas as noites: recolhe dados de três sistemas, envia-os para um modelo para processamento, envia o resultado por e-mail, aguarda a aprovação de um gestor e, em seguida, aciona um processo de faturação. Esta cadeia estende-se por horas, por vezes dias, atravessando redes, filas de espera e serviços de terceiros — nenhum dos quais é 100% fiável.
No dia em que a máquina que executa este pipeline reinicia entre o envio do e-mail e o processamento da fatura, depara-se com dois cenários. Ou reinicia tudo do zero e o cliente recebe o relatório uma segunda vez, ou escreveu manualmente um sistema de pontos de verificação, bloqueios e tabelas de estado — centenas de linhas de código que nada têm a ver com o seu negócio principal. A plataforma Mistral AI Workflows, lançada em Antevisão Pública a 27 de abril de 2026, existe para o poupar a esta escolha. Fornece uma garantia fundamental: o seu fluxo de trabalho nunca perderá o seu progresso.
O Que É um Fluxo de Trabalho Durável?
Um fluxo de trabalho durável é um programa onde cada passo é persistido antes do início do seguinte. Retomando o relatório noturno: no momento em que o e-mail é enviado, a plataforma já registou no seu diário que este passo está concluído e gravou o resultado. Se o processo parar um segundo depois, retoma no passo de faturação, não no início — sem perda de dados nem ações duplicadas.
Este mecanismo não é experimental. A plataforma Mistral Workflows é alimentada pelo Temporal, um motor de orquestração comprovado em produção em empresas como a Netflix, a Uber e a Stripe. Herda um modelo de execução que já resistiu a falhas em larga escala, envolto numa camada Mistral que o expõe através de Python moderno.
Passos num Fluxo de Trabalho Típico
Antes de mergulhar nos detalhes das próximas lições, eis o percurso completo que irá realizar, desde a definição do código até à monitorização em produção.
Definir Atividades
Cada unidade de trabalho (chamada à API, consulta à base de dados, processamento de IA) é encapsulada numa função assíncrona chamada atividade.
Criar o Fluxo de Trabalho
O fluxo de trabalho orquestra as atividades: a ordem de execução, as condições e a lógica de ramificação.
Lançar um Worker
O worker é o processo que executa efetivamente os seus fluxos de trabalho e atividades. Liga-se à plataforma Mistral e aguarda tarefas.
Acionar a Execução
Inicia o fluxo de trabalho através do SDK Python ou de uma chamada cURL. A plataforma persiste cada passo e gere a retoma automática.
Observar e Monitorizar
Cada atividade gera traços OpenTelemetry. Pode acompanhar a execução em tempo real e diagnosticar problemas.
Capacidades Principais da Plataforma
A execução é fiável e tolerante a falhas. Os fluxos de trabalho nunca perdem progresso porque cada passo é persistido antes de avançar para o seguinte. Seja uma falha do servidor, uma interrupção de rede ou um erro transitório de um fornecedor, o fluxo de trabalho retoma automaticamente exatamente onde parou, sem qualquer intervenção da sua parte.
A plataforma foi também concebida para cenários nativos de IA. Um agente que encadeia chamadas de ferramentas, uma sequência de modelos ou uma conversa de longa duração com um assistente: estes padrões envolvem longas esperas e retomas frequentes, que é exatamente o caso de uso alvo. Os fluxos de trabalho podem durar de alguns segundos a várias semanas, permitindo cenários impossíveis com um simples pedido HTTP, como aguardar três dias por uma validação humana.
A arquitetura é também totalmente observável de ponta a ponta. Cada ação — conclusão de atividade, sinal, erro — é registada como um evento em tempo real. Pode transmitir estes eventos para sistemas externos, permitindo-lhe, por exemplo, mostrar ao utilizador final uma barra de progresso que reflete o estado real do processamento em vez de uma animação decorativa. Por fim, o SDK Python utiliza decoradores familiares e padrões async/await: se conhece Python, já sabe como escrever fluxos de trabalho.
Casos de Uso Concretos
Quatro famílias de aplicações surgem regularmente. Um pipeline de processamento de documentos encadeia extração, análise, resumo e classificação, passando cada documento pelos mesmos passos para que uma falha no meio de um lote não obrigue a um reinício total. Um agente de apoio ao cliente recupera o contexto, gera uma resposta, escala para um humano se necessário e acompanha tarefas pós-resolução dias após o encerramento do ticket. Um fluxo de trabalho de moderação de conteúdos faz com que múltiplos modelos analisem o mesmo item, aplica uma votação por maioria e escala para um moderador humano em caso de desacordo. Por fim, a geração de relatórios recolhe dados de múltiplas fontes, agrega-os, produz o texto, formata-o e envia o documento.
Antevisão Pública: O Que Isto Significa
A funcionalidade Workflows está em Antevisão Pública desde o seu lançamento a 27 de abril de 2026 (anúncio oficial), e este estatuto tem consequências práticas. Antes de começar, verifique o estado atual na documentação Workflows. As APIs e funcionalidades podem mudar sem aviso prévio: fixe as versões das suas dependências e planeie rever as notas de lançamento antes de cada atualização. A plataforma está pronta para produção, mas exige cautela, o que significa que deve manter um plano de contingência para processos críticos. O feedback dos utilizadores influencia diretamente o roteiro, pelo que o seu contributo tem um peso real. Algumas limitações técnicas ainda existem, e detalhamo-las nas lições seguintes em vez de as ignorar.
Pontos-chave
- O Mistral Workflows permite-lhe orquestrar tarefas complexas de IA com uma garantia de durabilidade
- A plataforma é alimentada pelo Temporal, um motor de orquestração comprovado em produção
- A arquitetura assenta em três componentes: atividades (trabalho real), fluxos de trabalho (orquestração), workers (execução)
- Cada passo é persistido — um fluxo de trabalho interrompido retoma automaticamente
- A funcionalidade está em Antevisão Pública (abril de 2026): as APIs estão sujeitas a alterações