Dans la liste de vos projets, sélectionnez le projet souhaité puis l’onglet Agents. Repérez l’agent que vous souhaitez exécuter.

Cliquez sur “Exécuter” ou “Run”. Une fenêtre s’ouvre où vous pouvez saisir un prompt / input libre ou choisir des options pré‑remplies si l’agent en propose.

• Si l’agent attend plusieurs inputs (liste, fichiers, etc.), fournissez-les dans les champs correspondants.
• Pour tester, commencez par un input court et ciblé.

Sélectionnez où envoyer les outputs : e‑mail, webhook externe, intégration Notion, ou simplement les conserver dans le projet.

• Si vous choisissez un webhook, vérifiez que la destination existe et possède les autorisations nécessaires.
• Si vous choisissez l’email, vérifiez la liste de diffusion et la configuration d’envoi.

Cliquez sur “Confirmer” ou “Lancer”. Vous recevrez une notification de démarrage. L’exécution se fait en arrière‑plan ; surveillez la barre de progression et les notifications.

À la fin, ouvrez l’onglet Changelogs / Générations pour :

• voir les documents produits,
• consulter le prompt final envoyé au modèle,
• vérifier le statut (Succès / Échec / Partiel).
• Si l’exécution a échoué, examinez le message d’erreur et relancez après correction.

Si vous déclenchez depuis une application externe, préparez l’appel en fournissant :

• l’identifiant du projet,
• l’identifiant de l’agent à exécuter,
• l’input (texte ou structure) que vous souhaitez fournir,
• la destination souhaitée (si vous voulez que le résultat soit routé).

Assurez‑vous que l’intégration / clé utilisée a les droits sur le projet et la destination choisie. Testez avec un petit input pour vérifier les droits et la latence.

Déclenchez l’exécution et surveillez les notifications et les logs du projet pour confirmer que l’exécution a bien démarré et s’est terminée.

En cas d’erreur, récupérez le message retourné, corrigez l’input ou les permissions, puis relancez. Préférez les runs tests avant des runs de production.

Dans le projet, ouvrez le dialogue “Gérer les Hooks” ou “Agent Hook” pour ajouter/modifier un hook.

Sélectionnez :

• “Git” si vous voulez déclencher sur push, pull request, ou tag ;
• “Planifié” si vous voulez une exécution récurrente (ex. tous les jours, toutes les semaines).

Définissez les filtres d’entrée :

• branches concernées,
• patterns de fichiers ou chemins,
• limite des commits à traiter,
• champs de pré‑filtrage pour n’exécuter que sur certains changements. Utilisez la prévisualisation pour vérifier le nombre d’éléments qui correspondent.

Pour un hook planifié, renseignez la fréquence :

• nombre (ex. 1) et unité (jour / semaine / mois / année). Saisissez une date/heure de prochaine exécution si vous voulez démarrer à un moment précis.

Choisissez où envoyer les outputs (email, webhook, stockage interne). Activez ou non les notifications par e‑mail pour recevoir un résumé de chaque run.

Sauvegardez le hook, puis :

• lancez un test manuel (si disponible) ;
• ou attendez le prochain événement (push ou planification). Vérifiez la création de logs et la route des outputs.

Depuis la configuration du hook, cliquez sur “Prévisualiser” pour obtenir un échantillon des documents/commits qui correspondent aux filtres.

Consultez le nombre estimé d’items ; cela permet d’évaluer la consommation de crédits avant exécution.

Si le nombre est trop élevé, affinez vos filtres (branche, pattern, période) pour réduire le volume.

Répétez jusqu’à ce que l’estimation corresponde à ce que vous êtes prêts à consommer.

Après chaque exécution, un log est créé et listé dans l’onglet Changelogs / Générations. Ouvrez l’entrée correspondant à la run.

Les éléments importants à vérifier :

• statut final (Succès / Échec / Interrompu) ;
• prompt envoyé (permet de reproduire ou ajuster le prompt) ;
• nombre d’outputs générés ;
• destination(s) et éventuels échecs de livraison.

Consultez le contexte attaché : commits inclus, auteur, message, et tout identifiant de batch qui facilite la traçabilité.

En cas de succès, publiez, annotez ou exportez les outputs. En cas d’erreur, corrigez le prompt/filtres/destination et relancez.

Les appels vers le modèle (LLM) pendant l’exécution d’un agent consomment des crédits :

• chaque prompt envoyé et chaque réponse (tokens générés) sont comptabilisés,
• plus le prompt ou la réponse est long, plus la consommation augmente.

Un output est un élément généré (fichier, page, document). Selon votre offre, vous avez un quota d’outputs mensuels et un plafond d’outputs par run. L’utilisation des crédits LLM peut être distincte des “outputs” facturés, vérifiez vos règles de facturation dans l’interface Billing.

Avant un run important :

• utilisez la prévisualisation pour estimer le nombre de documents ;
• testez avec un petit batch pour mesurer la consommation moyenne par document ;
• multipliez pour estimer la consommation totale.

Si la plateforme estime qu’une exécution dépassera un seuil de sécurité (consommation projetée > limite), l’exécution peut être interrompue automatiquement et vous serez notifié.

Consultez la page Facturation / Consommation pour :

• solde de crédits restants,
• historique des consommations par projet,
• alertes de dépassement ou blocage.

Idéale pour validations ponctuelles, tests ou runs ponctuels avant publication. Permet de:

• fournir un input ad hoc,
• choisir une destination,
• visualiser les résultats immédiatement.

Convient pour automatisations continues (release notes, synthèses de PR). Avantages:

• déclenchements automatiques sur événements Git,
• workflows sans intervention humaine,
• nécessite des filtres précis pour éviter sur‑génération.

Pour exécutions régulières (quotidien, hebdo) ou intégration avec d’autres systèmes :

• utile pour rapports périodiques, résumés automatiques,
• combiner avec destination webhook vers votre outil de tickets ou CMS.