> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-locadex-parallel-t9n-main-cs60c8p4o6ik99tylxgp3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Utiliser les automatisations avec ARIA

> Créez une automatisation W&B qui envoie un prompt basé sur un modèle à ARIA et démarre une nouvelle conversation lorsqu'un événement spécifique se produit.

export const AriaChatBubbles = ({prompt, response}) => {
  const [isDark, setIsDark] = useState(false);
  const [promptCopied, setPromptCopied] = useState(false);
  useEffect(() => {
    const root = document.documentElement;
    const sync = () => setIsDark(root.classList.contains('dark'));
    sync();
    const obs = new MutationObserver(sync);
    obs.observe(root, {
      attributes: true,
      attributeFilter: ['class']
    });
    return () => obs.disconnect();
  }, []);
  useEffect(() => {
    if (!promptCopied) {
      return undefined;
    }
    const timeout = setTimeout(() => setPromptCopied(false), 2000);
    return () => clearTimeout(timeout);
  }, [promptCopied]);
  const copyText = text => {
    navigator.clipboard.writeText(text).then(() => setPromptCopied(true)).catch(console.error);
  };
  const userBg = isDark ? '#363C44' : '#F8F8F8';
  const userBorder = isDark ? '#4B535C' : '#DFE0E2';
  const textColor = isDark ? '#E8E8E9' : '#2B3038';
  const iconColor = isDark ? '#8F949E' : '#79808A';
  const iconHoverBg = isDark ? 'rgba(255,255,255,0.10)' : 'rgba(0,0,0,0.05)';
  const bubbleText = {
    fontSize: '15px',
    color: textColor,
    overflowWrap: 'anywhere'
  };
  const bubbleBase = {
    maxWidth: '85%'
  };
  const copyIcon = promptCopied ? <svg aria-hidden="true" focusable="false" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" style={{
    color: '#FCBC32'
  }}>
      <path d="M20 6 9 17l-5-5" />
    </svg> : <svg aria-hidden="true" focusable="false" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
      <rect width="14" height="14" x="8" y="8" rx="2" ry="2" />
      <path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" />
    </svg>;
  return <div aria-label="ARIA chat example" className="not-prose flex flex-col gap-3" role="group">
      {}
      <div className="flex w-full justify-end">
        <div className="flex w-fit items-start gap-1 rounded-2xl py-2 pl-3 pr-1.5" style={{
    ...bubbleBase,
    backgroundColor: userBg,
    border: `1px solid ${userBorder}`
  }}>
          <div className="min-w-0 flex-1 hyphens-auto whitespace-pre-wrap" style={bubbleText}>
            {prompt}
          </div>
          <button type="button" className="mt-0.5 shrink-0 rounded-lg p-1.5 cursor-pointer" style={{
    color: iconColor,
    background: 'transparent'
  }} onMouseEnter={e => {
    e.currentTarget.style.backgroundColor = iconHoverBg;
  }} onMouseLeave={e => {
    e.currentTarget.style.backgroundColor = 'transparent';
  }} onClick={() => copyText(prompt)} aria-label="Copy user prompt">
            {copyIcon}
          </button>
        </div>
      </div>
      {}
      <div className="flex w-full justify-start">
        <div className="w-fit rounded-2xl py-2 px-3" style={{
    ...bubbleBase,
    border: '1px solid #CDF4F7'
  }}>
          <div className="hyphens-auto whitespace-pre-wrap" style={bubbleText}>
            {response}
          </div>
        </div>
      </div>
    </div>;
};

Utilisez une automatisation W\&B pour envoyer un prompt à ARIA lorsqu'un événement spécifique se produit. Chaque fois que l'événement se produit, l'automatisation démarre une nouvelle conversation ARIA et lui envoie le prompt configuré.

Une automatisation qui envoie un prompt à ARIA comporte deux parties principales :

* L'[événement](/fr/models/automations/automation-events) qui déclenche l'automatisation.
* Le prompt qu'ARIA reçoit lorsque l'événement se produit.

Utilisez ce flux de travail pour explorer les résultats d'expériences, résumer des runs ou en faire un rapport, ou encore examiner des métriques qui franchissent un seuil.

L'envoi d'un prompt à ARIA est l'une des actions qu'une automatisation W\&B peut effectuer. Pour créer des automatisations qui envoient des notifications vers d'autres destinations, référez-vous à [Créer une automatisation Slack](/fr/models/automations/create-automations/slack) ou [Créer une automatisation webhook](/fr/models/automations/create-automations/webhook).

Vous pouvez également demander à ARIA de créer et de gérer des automatisations W\&B à votre place. Pour plus de détails, voir [Créer et gérer des automatisations avec ARIA](#create-and-manage-automations-with-aria).

<Note>
  Disponible uniquement sur le [W\&B Cloud mutualisé](/fr/platform/hosting/#wb-multi-tenant-cloud).

  ARIA fonctionne dans les projects d'équipe, et non dans votre entité personnelle. Votre administrateur de l'organisation doit également activer les **Smart features**. Voir [Gouvernance et sécurité](/fr/aria/governance).
</Note>

<div id="requirements">
  ## Exigences
</div>

Avant de créer une automatisation qui envoie un prompt à ARIA, vérifiez les points suivants :

* ARIA doit être activé pour votre organisation. Si **Trigger ARIA** n'apparaît pas dans la liste **Action type**, c'est qu'ARIA n'est pas disponible pour votre organisation, votre portée ou votre déploiement. L'option est alors simplement absente de la liste, sans explication. Voir [Gouvernance et sécurité](/fr/aria/governance).
* Vous devez disposer d'un accès en écriture au project, au registre ou à la collection sur lesquels porte la portée de l'automatisation.
* Pour définir la portée d'une automatisation W\&B sur un registre et envoyer des prompts à ARIA, vous devez appartenir à une équipe de la même organisation. Chaque conversation ARIA est associée à une équipe : vous ne pouvez donc pas créer d'automatisation dont la portée est un registre si vous n'appartenez à aucune équipe de cette organisation.

Chaque fois qu'une automatisation ARIA s'exécute, elle démarre une conversation ARIA comptabilisée dans l'utilisation de votre organisation, au même titre qu'une conversation que vous démarrez vous-même.

<div id="create-an-automation">
  ## Créer une automatisation
</div>

Sélectionnez **registre** ou **Project** selon la portée à laquelle vous souhaitez appliquer l'automatisation. Suivez ensuite ces étapes pour créer une automatisation qui envoie un prompt à ARIA.

<Note>
  Pour appliquer une automatisation à plus grande échelle, créez-la depuis le hub **Automations** global et sélectionnez la portée **équipe** ou **organisation**. Les étapes sont identiques à celles décrites ci-dessous. À ces portées, W\&B ne prend en charge que les événements d'artifact et de collection. Voir [Hub Automations](/fr/models/automations#automations-hub).
</Note>

<Tabs>
  <Tab title="registre">
    Un admin de registre peut créer des automatisations dans ce registre.

    1. Connectez-vous à W\&B.
    2. Cliquez sur le nom d'un registre pour afficher ses détails.
    3. Pour créer une automatisation limitée au registre, cliquez sur l'onglet **Automations**, puis sur **Create automation**. Une automatisation limitée à un registre s'applique automatiquement à toutes ses collections, y compris celles créées ultérieurement.
    4. Choisissez l'[événement](/fr/models/automations/automation-events/#registry-events) à surveiller.

       Renseignez les champs supplémentaires qui s'affichent ; ceux-ci varient selon l'événement. Par exemple, si vous sélectionnez **An artifact alias is added**, vous devez renseigner le champ **Alias regex**.

       Cliquez sur **Next step**.
    5. Sélectionnez l'équipe qui héberge la conversation ARIA. Voir [Où la conversation apparaît](#where-the-conversation-appears).
    6. Définissez **Action type** sur **Trigger ARIA**.
    7. Dans le champ **Prompt**, rédigez le prompt à envoyer à ARIA. Voir [Rédiger le prompt](#write-the-prompt). Cliquez sur **Next step**.
    8. Donnez un nom à l'automatisation. Vous pouvez également ajouter une description.
    9. Cliquez sur **Create automation**.

    L'automatisation est désormais active : elle démarre une nouvelle conversation ARIA chaque fois que l'événement choisi se produit dans le registre.
  </Tab>

  <Tab title="Project">
    Un admin W\&B peut créer des automatisations dans un projet.

    1. Connectez-vous à W\&B.
    2. Accédez à la page du projet, cliquez sur l'onglet **Automations**, puis sur **Create automation**.
    3. Choisissez l'[événement](/fr/models/automations/automation-events/#project) à surveiller.

       1. Renseignez les champs supplémentaires qui s'affichent. Par exemple, si vous sélectionnez **An artifact alias is added**, vous devez renseigner le champ **Alias regex**.

          1. Pour les automatisations déclenchées par un run, vous pouvez éventuellement définir un ou plusieurs filtres de runs :

             * **Filter to one user's runs** : n'inclut que les runs créés par l'utilisateur spécifié. Cliquez sur le bouton bascule pour activer le filtre, puis indiquez un nom d'utilisateur.
             * **Filter on run name** : n'inclut que les runs dont le nom correspond à l'expression régulière indiquée. Cliquez sur le bouton bascule pour activer le filtre, puis indiquez une expression régulière.
       2. Cliquez sur **Next step**.
    4. Sélectionnez l'équipe propriétaire du projet.
    5. Définissez **Action type** sur **Trigger ARIA**.
    6. Dans le champ **Prompt**, rédigez le prompt à envoyer à ARIA. Voir [Rédiger le prompt](#write-the-prompt). Cliquez sur **Next step**.
    7. Donnez un nom à l'automatisation. Vous pouvez également ajouter une description.
    8. Cliquez sur **Create automation**.

    L'automatisation est désormais active : elle démarre une nouvelle conversation ARIA chaque fois que l'événement choisi se produit dans le projet.
  </Tab>
</Tabs>

<div id="create-and-manage-automations-with-aria">
  ## Créer et gérer des automatisations avec ARIA
</div>

ARIA peut créer, supprimer, activer et désactiver des automatisations à la demande.

Demandez à ARIA de créer une automatisation :

<AriaChatBubbles prompt="Créez une automatisation : lorsqu'un run réussit, demandez à ARIA de rédiger un report destiné à votre équipe qui résume le run, les métriques et le résultat." response="Je peux créer une automatisation activée à l'échelle du project, nommée **Résumer un run réussi**. Elle se déclenchera dès qu'un run passera à l'état `FINISHED` et demandera à ARIA de rédiger un report résumant la configuration du run, les métriques clés, le résultat et les observations notables." />

Interrogez ARIA sur vos automatisations existantes :

<AriaChatBubbles prompt="Quelles automatisations existent dans ce project ?" response="Vous avez 2 automatisations au niveau du project, toutes deux activées...." />

<div id="write-the-prompt">
  ## Rédiger le prompt
</div>

Le prompt est le seul élément que vous configurez pour une action ARIA. Rédigez-le comme vous rédigeriez un message dans la fenêtre de chat d'ARIA, et incluez des [variables de modèle](#template-variables) pour indiquer quel run, artifact ou métrique ARIA doit examiner.

Gardez à l'esprit les contraintes suivantes :

* Un prompt est requis et ne peut pas dépasser 4 000 caractères. W\&B vérifie de nouveau la longueur après avoir substitué les variables de modèle : un prompt enregistré avec succès peut donc échouer lors de l'exécution de l'automatisation si les valeurs substituées sont longues. Un prompt qui échoue à cette vérification est consigné comme exécution en échec dans l'[historique d'exécution](/fr/models/automations/view-automation-history) de l'automatisation.
* Une variable de modèle qui ne s'applique pas à l'événement est résolue en chaîne vide plutôt qu'en son propre nom. Utilisez uniquement les variables listées pour votre événement.
* ARIA démarre une nouvelle conversation à chaque exécution de l'automatisation. Elle ne poursuit pas une conversation précédente et ne garde aucune mémoire des exécutions antérieures de la même automatisation.

Pour insérer une variable, cliquez sur le **<Icon icon="plus" iconType="solid" />** situé à côté d'elle dans la liste sous le champ **Prompt**. W\&B ajoute la variable à la fin du prompt. La liste n'affiche que les variables applicables à l'événement que vous avez sélectionné.

Par exemple, ce prompt analyse chaque nouvelle version de modèle liée :

```text theme={null}
Une nouvelle version de ${artifact_collection_name} vient d'être liée à ${project_name} par ${event_author}.

Compare ${artifact_version_string} avec l'alias production actuel. Résume les éventuelles régressions des métriques d'évaluation et indique s'il faut la promouvoir.
```

Vous pouvez demander à ARIA de vous aider à formuler un prompt avant d'enregistrer l'automatisation :

<AriaChatBubbles prompt="Je veux une automatisation qui se déclenche chaque fois qu'un run échoue dans ce projet. Rédige un prompt qui te demande de diagnostiquer l'échec." response="Voici un prompt à coller dans l'automatisation : « Le run ${run_name} du projet ${project_name} vient d'échouer. Examine ses journaux, sa configuration et ses métriques système, compare-le aux derniers runs réussis, et indique-moi la cause la plus probable ainsi qu'une correction concrète à essayer. »" />

<div id="template-variables">
  ## Variables de modèle
</div>

Les variables de modèle utilisent la syntaxe `${variable_name}`. Les variables disponibles pour un prompt dépendent de l'événement surveillé par l'automatisation.

Les variables suivantes sont disponibles pour tous les événements :

| Variable             | Description                                                              |
| -------------------- | ------------------------------------------------------------------------ |
| `${automation_name}` | Le nom de l'automatisation qui a déclenché l'action.                     |
| `${event_type}`      | Le type d'événement qui a déclenché l'action.                            |
| `${event_author}`    | L'utilisateur qui a déclenché l'action.                                  |
| `${entity_name}`     | Le nom de l'entité propriétaire de l'événement qui a déclenché l'action. |
| `${project_name}`    | Le nom du projet propriétaire de l'événement qui a déclenché l'action.   |

Selon l'événement, les variables suivantes s'ajoutent aux précédentes :

| Événement                                                                | Variables supplémentaires                                                                                                                   |
| ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Une version d'artifact est créée, liée ou dissociée                      | `${artifact_collection_name}`, `${artifact_version}`, `${artifact_version_string}`, `${artifact_version_index}`, `${artifact_metadata.KEY}` |
| Un alias d'artifact est ajouté ou mis à jour                             | Les variables d'artifact précédentes, plus `${alias}`                                                                                       |
| Un tag d'artifact est ajouté ou supprimé                                 | Les variables d'artifact précédentes, plus `${tag}`                                                                                         |
| Un tag de collection est ajouté ou supprimé                              | `${artifact_collection_name}`, `${tag}`                                                                                                     |
| Une métrique de run franchit un seuil, change ou change selon le z-score | `${run_name}`, `${metric_name}`, `${metric_values}`, `${metric_filter}`, `${metric_filter_short}`, `${metric_current_status}`               |
| Un run change de statut                                                  | `${run_name}`, `${run_status}`                                                                                                              |
| Une métrique Weave franchit un seuil                                     | `${alert_name}`, `${metric_name}`, `${metric_value}`, `${threshold}`, `${comparison_op}`, `${message}`                                      |

Les remarques suivantes s'appliquent à certaines variables :

* `${artifact_version}` se résout en une instance d'artifact, par exemple `wandb-artifact://_id/QXJ0aWZhY3Q6NTE3ODg5ODg3`. Pour désigner la version par son nom, utilisez `${artifact_version_string}`.
* `${artifact_metadata.KEY}` lit une valeur de metadata personnalisée dans la version d'artifact ayant déclenché l'événement. Remplacez `KEY` par la clé de metadata souhaitée. Seules les clés de metadata de premier niveau sont prises en charge.

Pour connaître les événements disponibles à chaque portée, voir [Événements et portée des automatisations](/fr/models/automations/automation-events).

<div id="view-conversations-created-by-automations">
  ## Consulter les conversations créées par les automatisations
</div>

L'automatisation crée la conversation ARIA sous le compte de l'utilisateur qui a créé l'automatisation, et non de l'utilisateur dont l'action a déclenché l'événement. La conversation apparaît dans l'historique de conversation ARIA de cette personne, sous **Past conversations**, aux côtés des conversations qu'elle a elle-même démarrées. Pour identifier l'utilisateur à l'origine de l'événement, incluez `${event_author}` dans le prompt.

L'emplacement de la conversation dépend de la portée de l'automatisation :

* **Automatisations dont la portée est un projet ou une équipe** : la conversation est créée dans le projet où l'événement s'est produit.
* **Automatisations dont la portée est un registre** : un registre appartient à votre organisation et non à une équipe, or les conversations ARIA doivent appartenir à une équipe. La conversation est donc créée dans l'équipe que vous avez sélectionnée lors de la création de l'automatisation, dans un projet nommé `wandb_agent_default_project`. Cherchez-la à cet endroit plutôt que dans le registre.

  `wandb_agent_default_project` est un projet réservé que W\&B maintient pour chaque équipe afin d'héberger les conversations qui ne sont rattachées à aucun projet que vous avez ouvert. Vous n'avez pas à le créer, et il est normalement vide en dehors de ces conversations.

Pour vérifier que l'automatisation s'est bien exécutée, ouvrez son [historique d'exécution](/fr/models/automations/view-automation-history). Une exécution ARIA réussie affiche le prompt envoyé par W\&B ainsi qu'un corps de réponse contenant le `thread_id` de la conversation. W\&B ne fournit aucun lien entre l'exécution et la conversation, et une conversation créée par une automatisation n'est pas signalée différemment dans votre historique de conversation.

<div id="view-and-manage-automations">
  ## Afficher et gérer les automatisations
</div>

Affichez et gérez les automatisations depuis l'onglet **Automations** d'un projet ou d'un registre, ou depuis le hub **Automations** global. Dans la liste des automatisations, l'action s'affiche sous le nom **ARIA**.

Seul le créateur d'une automatisation qui envoie des prompts à ARIA peut la modifier, car la conversation ARIA s'exécute sous l'identité de cet utilisateur. Les membres de l'équipe disposant d'un accès en écriture au projet ou au registre peuvent afficher et supprimer l'automatisation, mais l'option **Edit** ne leur est pas proposée.

Vous ne pouvez pas transférer la propriété d'une automatisation. Supprimez-la plutôt et demandez au nouveau propriétaire de la recréer. Procédez de la même manière pour récupérer une automatisation dont le créateur a quitté l'équipe.

<div id="limitations">
  ## Limitations
</div>

* Les automatisations ARIA sont disponibles uniquement sur le [Cloud mutualisé de W\&B](/fr/platform/hosting/#wb-multi-tenant-cloud), dans les projects d'équipe, et seulement si votre administrateur de l'organisation a activé les **Smart features**.
* Chaque automatisation peut démarrer au maximum trois conversations ARIA par minute. Au-delà de cette limite, W\&B consigne les exécutions dans l'historique de l'automatisation avec le statut **Skipped**, ce qui signifie que l'automatisation correspondait à l'événement mais n'a pas exécuté son action.
* Si la personne ayant créé l'automatisation perd l'accès en écriture au project ou si son compte est désactivé, toutes les exécutions suivantes échouent. L'échec apparaît dans l'historique d'exécution de l'automatisation.
* Seul le créateur de l'automatisation peut la modifier.
* La bibliothèque Python `wandb` ne prend pas en charge les automatisations ARIA. Voir [Gérer les automatisations avec l'API](/fr/models/automations/api).

<div id="next-steps">
  ## Étapes suivantes
</div>

* [Événements et portée des automatisations](/fr/models/automations/automation-events)
* [Consulter l'historique d'une automatisation](/fr/models/automations/view-automation-history)
* [Chat avec ARIA](/fr/aria/chat)
* [Aperçu d'ARIA](/fr/aria/overview)