Exemples de cookbook

Utilisez les modèles de cookbook Workflows lorsque vous souhaitez démarrer avec des exemples complets. Chaque cookbook illustre un schéma différent, comme la validation humaine, le traitement parallèle ou les sous-workflows.

Après la configuration, chaque projet généré intègre le code du workflow, des données d'exemple, un point d'entrée du worker et des commandes utilitaires pour lancer l'exemple.

Avant de commencer

Avant d'exécuter un cookbook, assurez-vous d'avoir :

Un compte Mistral.
Python 3.12 installé.
uvx disponible dans votre shell.
Une clé API Mistral pour l'espace de travail sur lequel vous souhaitez lancer vos workflows.

Vous pouvez consulter la chronologie d'exécution ou réaliser une étape de validation humaine dans Studio.

Configurer un projet cookbook

Exécutez la commande de configuration et sélectionnez le modèle de cookbook que vous souhaitez générer :

uvx mistralai-workflows-cli setup

uvx mistralai-workflows-cli setup

Une fois la configuration terminée, placez-vous dans le dossier du projet généré et lancez les exemples :

cd my-workflow # or the name of the folder you created
make start-examples

cd my-workflow # or the name of the folder you created
make start-examples

Cela enregistre les workflows cookbook auprès de votre espace de travail et laisse le worker prêt à traiter les exécutions. Vous pouvez lancer une exécution soit depuis un second terminal avec la commande d'exemple présente dans chaque cookbook, soit depuis Studio.

Cookbooks disponibles

Cookbook	Ce qu'il démontre	Nom du workflow principal dans Studio
Cargo release	Validation humaine, sous-workflows, sorties structurées	`cargo-release-compliance`
Insurance claims	Activités parallèles, reprises sur erreur, routage déterministe	`insurance-claims-triage`
Code modernization	Sous-workflows parallèles, validation de syntaxe, validation humaine	`code-modernization`
Résumé Linear	Connecteurs, stratégies de nouvelle tentative, validation humaine, sortie structurée du LLM	`linear-summarization`

Conformité cargo et marchandises dangereuses

Ce que fait ce cookbook

Ce cookbook automatise la libération de cargaison pour la logistique maritime. Il extrait le document d’expédition, classe la cargaison, réalise les contrôles pour marchandises dangereuses si nécessaire, vérifie la conformité douanière et suspend l’exécution pour une validation manuelle en cas d’anomalie détectée.

Utilisez cet exemple pour comprendre l’utilisation de wait_for_input(), des sous-workflows, et des sorties typées des LLM dans un processus de bout en bout.

Comment l'exécuter

Lancez le parcours par défaut avec le document d'exemple fourni :

make execute-cargo-release

make execute-cargo-release

Lancez le parcours anomalie pour déclencher une validation humaine :

make execute-cargo-release \
  input='{"document_uri":"examples/cargo_release/sample_data/shipping_doc_anomaly.png","shipment_id":"BL-2024-RTD-004812"}'

make execute-cargo-release \
  input='{"document_uri":"examples/cargo_release/sample_data/shipping_doc_anomaly.png","shipment_id":"BL-2024-RTD-004812"}'

Vous pouvez aussi démarrer cargo-release-compliance dans Studio avec cet input :

{
  "document_uri": "examples/cargo_release/sample_data/shipping_doc_anomaly.png",
  "shipment_id": "BL-2024-HAM-009371"
}

{
  "document_uri": "examples/cargo_release/sample_data/shipping_doc_anomaly.png",
  "shipment_id": "BL-2024-HAM-009371"
}

À quoi faire attention

Dans Studio, inspectez le sous-workflow de vérification des marchandises dangereuses, puis repérez l'événement wait_for_input sur le parcours anomalie. Approuvez ou bloquez l'expédition, et vérifiez que le workflow parent reprend à l'étape de validation plutôt que de réexécuter les étapes précédentes.

Triage des sinistres avec analyse visuelle

Ce que fait ce cookbook

Ce cookbook trie un dossier de sinistre à partir des textes et photos. Il analyse les photos en parallèle, contrôle la description pour détecter des incohérences, attribue un niveau de gravité déterministe, évalue le risque de fraude et retourne un rapport de triage structuré.

Utilisez cet exemple pour voir comment un workflow associe exécution d’activités en parallèle, routage déterministe et sorties structurées.

Comment l'exécuter

Lancez le workflow par défaut :

make execute-insurance-claims

make execute-insurance-claims

Vous pouvez fournir vos propres données :

make execute-insurance-claims input='{"claim_id":"CLM-001","claimant_name":"Jane","description":"My car was hit.","photos":["examples/insurance_claims/sample_data/photos/claim_low_scratch_door.jpg"]}'

make execute-insurance-claims input='{"claim_id":"CLM-001","claimant_name":"Jane","description":"My car was hit.","photos":["examples/insurance_claims/sample_data/photos/claim_low_scratch_door.jpg"]}'

Ou démarrer le workflow dans Studio avec ces données :

{
  "claim_id": "CLM-2024-001",
  "claimant_name": "Maria Gonzalez",
  "description": "My car was T-boned at an intersection.",
  "photos": [
    "examples/insurance_claims/sample_data/photos/claim_high_totaled_front.jpg",
    "examples/insurance_claims/sample_data/photos/claim_high_totaled_side.jpg"
  ]
}

{
  "claim_id": "CLM-2024-001",
  "claimant_name": "Maria Gonzalez",
  "description": "My car was T-boned at an intersection.",
  "photos": [
    "examples/insurance_claims/sample_data/photos/claim_high_totaled_front.jpg",
    "examples/insurance_claims/sample_data/photos/claim_high_totaled_side.jpg"
  ]
}

À quoi faire attention

Dans Studio, vérifiez que les activités analyze_photo démarrent en parallèle, puis inspectez les étapes de cohérence, le scoring de fraude et le rapport final typé. L'aiguillage est défini par le code du workflow, pas par un appel à un modèle séparé.

Assistant de modernisation de code

Ce que fait ce cookbook

Ce cookbook modernise une base de code Python existante, fichier par fichier. Le workflow parent scanne le dépôt, déclenche un sous-workflow par fichier, valide le code généré dans un sous-processus, regroupe les résultats dans un jeu de modifications et suspend l’exécution pour validation humaine avant de soumettre une proposition de PR.

Utilisez cet exemple pour apprendre à combiner du fan-out de sous-workflows et une validation humaine robuste.

Comment l'exécuter

Lancez le workflow par défaut :

make execute-code-modernization

make execute-code-modernization

Vous pouvez aussi démarrer code-modernization dans Studio avec cet input :

{
  "repo_path": "examples/code_modernization/sample_data/legacy_repo",
  "target": "Python 2.7 → 3.12"
}

{
  "repo_path": "examples/code_modernization/sample_data/legacy_repo",
  "target": "Python 2.7 → 3.12"
}

À quoi faire attention

Dans Studio, vérifiez que chaque fichier source apparaît comme sa propre exécution fille. Après la fin des sous-workflows, repérez la pause wait_for_input, approuvez ou refusez le jeu de modifications, puis assurez-vous que le workflow ne crée la PR qu'après validation.

Résumé Linear

Ce que fait ce cookbook

Ce livre de recettes génère des résumés Hebdomadaire concis des activités dans les Projets Linear. Il accepte un nom ou un ID d’équipe et un nom ou un ID de Projet, récupère en parallèle les problems récents, exécute la synthèse LLM, et marque une pause pour clarification humaine si l’équipe ou le Projet ne peut pas être identifié.

Utilisez cet exemple pour voir comment les Connecteurs, l’authentification on-behalf-of (OBO), les activités parallèles et la validation humaine fonctionnent ensemble dans un seul workflow.

Prérequis

Ce livre de recettes utilise le Connecteur Linear avec le mode on-behalf-of (OBO), qui nécessite un déploiement renforcé. Avant de l’exécuter :

Créez un Connecteur Linear dans Studio › Contexte › Connecteurs. Nommez-le linear pour qu’il corresponde au code du workflow.
Suivez le flux d’authentification pour ajouter l’identifiant sous l’onglet Identifiants du connecteur.
Initialisez votre déploiement, puis renforcez-le dans Paramètres › Déploiements renforcés. Réenregistrez le workflow après renforcement afin que le workflow OBO puisse s’enregistrer avec succès.

Pour plus de détails, consultez déploiements renforcés et connecteurs.

Comment l'exécuter

Lancez le workflow par défaut :

make execute-linear-summary

make execute-linear-summary

Quand aucune entrée n’est fournie, le workflow marque une pause et invite à entrer l’équipe et le Projet dans Studio. Vous pouvez également fournir une entrée directement :

make execute-linear-summary \
  input='{"team":"Engineering","project":"*"}'

make execute-linear-summary \
  input='{"team":"Engineering","project":"*"}'

Ou lancez linear-weekly-summary dans Studio avec cette entrée :

{
  "team": "Engineering",
  "project": "*"
}

{
  "team": "Engineering",
  "project": "*"
}

À quoi faire attention

Dans Studio, confirmez que les activités de récupération des problems et de génération de résumés s’exécutent en parallèle. Si le nom de l’équipe ou du Projet ne peut pas être résolu, le workflow marque une pause à une étape wait_for_input — répondez à l’invite dans Studio et vérifiez que l’exécution reprend avec les valeurs corrigées. Vérifiez la sortie finale pour un résumé structuré en JSON.

Prochaines étapes

Quand un modèle de cookbook vous convient, ouvrez les fichiers de workflow générés dans src/workflows/ et adaptez les activités, les modèles d'entrée et les cheminements d'exécution à votre cas d'usage.

Pour comprendre l'architecture de ces exemples, poursuivez avec Concepts fondamentaux - Workflows et Construire des workflows.