> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/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 à ARIA un prompt basé sur un modèle, afin de démarrer une nouvelle conversation lorsqu’un événement donné 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 occurrence de l’événement, l’automatisation démarre une nouvelle conversation ARIA et lui envoie le prompt configuré.

Une automatisation qui envoie un prompt à ARIA se compose de deux parties principales :

* L’[événement](/fr/products/wandb/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 produire des rapports à leur sujet, ou encore analyser les 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, reportez-vous à [Créer une automatisation Slack](/fr/products/wandb/automations/create-automations/slack) ou à [Créer une automatisation webhook](/fr/products/wandb/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 dans le [Cloud mutualisé de W\&B](/fr/products/wandb/platform/hosting#wb-multi-tenant-cloud).

  ARIA fonctionne dans les projets d’équipe, et non dans votre entity personnel. L’administrateur de votre organisation doit également activer **Smart features**. Voir [Gouvernance et sécurité](/fr/products/aria/governance).
</Note>

<h2 id="requirements">
  Exigences
</h2>

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**, 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/products/aria/governance).
* Vous devez disposer d’un accès en écriture au projet, au registre ou à la collection auquel l’automatisation est limitée.
* Pour limiter une automatisation W\&B à un registre et envoyer des prompts à ARIA, vous devez appartenir à une équipe de la même organisation. Chaque conversation ARIA étant associée à une équipe, vous ne pouvez pas créer d’automatisation limitée à un registre si vous n’appartenez à aucune équipe de cette organisation.

Chaque exécution d’une automatisation ARIA démarre une conversation ARIA, qui est décomptée de l’utilisation de votre organisation au même titre qu’une conversation que vous démarrez vous-même.

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

Sélectionnez **Registre** ou **Projet** selon la portée à laquelle l’automatisation doit s’appliquer. Suivez ensuite ces étapes pour créer une automatisation qui envoie un prompt à ARIA.

<Note>
  Pour appliquer une automatisation plus largement, créez-la depuis le hub global **Automations** et sélectionnez la portée **Team** ou **Organization**. Les étapes sont identiques à celles décrites ci-dessous. Avec ces portées, W\&B prend uniquement en charge les événements d’artifact et de collection. Voir [Hub Automations](/fr/products/wandb/automations#automations-hub).
</Note>

<Tabs>
  <Tab title="Registre">
    Un administrateur 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/products/wandb/automations/automation-events#registry-events) à surveiller.

       Renseignez les éventuels champs supplémentaires qui s’affichent selon l’événement choisi. 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. Les registres appartiennent à votre organisation et non à une équipe, mais chaque conversation ARIA doit appartenir à une équipe. Voir [Afficher les conversations créées par des automatisations](#view-conversations-created-by-automations).
    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. Indiquez un nom pour l’automatisation et, si vous le souhaitez, une description.
    9. Cliquez sur **Create automation**.

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

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

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

       1. Renseignez les éventuels 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 spécifier un ou plusieurs filtres de run :

             * **Filter to one user's runs** : inclut uniquement 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** : inclut uniquement les runs dont le nom correspond à l’expression régulière indiquée. Cliquez sur le bouton bascule pour activer le filtre, puis saisissez 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. Indiquez un nom pour l’automatisation et, si vous le souhaitez, une description.
    8. Cliquez sur **Create automation**.

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

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

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

Demandez à ARIA de créer une automatisation :

<AriaChatBubbles prompt="Crée une nouvelle automatisation : lorsqu'un run réussit, déclenche ARIA pour qu'il rédige à l'intention de ton équipe un rapport résumant le run, les métriques et le résultat." response="Je peux créer une automatisation activée à l'échelle du projet, nommée **Summarize successful run**. Elle se déclenchera chaque fois qu'un run passe à l'état `FINISHED` et demandera à ARIA de rédiger un rapport résumant la configuration du run, ses principales métriques, son résultat et les observations notables." />

Interrogez ARIA sur vos automatisations existantes :

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

Demandez à ARIA de renommer une automatisation :

<AriaChatBubbles prompt="Renomme old-name en production-alert." response="Voulez-vous procéder au renommage ?" />

Une fois que vous avez confirmé, ARIA renomme l'automatisation.

<h3 id="view-your-aria-automations-in-chat">
  Afficher vos automatisations ARIA dans le chat
</h3>

Ouvrez ARIA, cliquez sur **Reveal chat history** dans l’en-tête du chat, puis ouvrez la section **Customize** en bas de la barre latérale de l’historique de conversation et sélectionnez **My automations**.

**My automations** remplace la vue de conversation dans le panneau principal d’ARIA au lieu de s’ouvrir à côté. Pour revenir à la conversation, sélectionnez une conversation ou démarrez un nouveau chat. Le volet n’est pas conservé après un rechargement : actualiser la page vous ramène donc également à votre conversation.

Le volet répertorie uniquement les automatisations que vous avez créées et qui envoient des prompts à ARIA. Les automatisations qui utilisent d’autres actions n’y figurent pas, pas plus que les automatisations ARIA de vos coéquipiers.

Le volet est en lecture seule. Vous pouvez voir si une automatisation est activée ou désactivée, mais pour l’activer, la désactiver, la modifier ou la supprimer, cliquez sur **View all automations** afin d’ouvrir la page Automations complète dans un nouvel onglet. Voir [Afficher et gérer les automatisations](#view-and-manage-automations).

Effectuez une recherche par nom ou parcourez les résultats par pages de 20 avec **Previous** et **Next**. La liste affiche le nom, l’**Event type** et le **Scope** de chaque automatisation.

Cliquez sur une automatisation pour ouvrir sa vue détaillée, qui affiche les champs **Description**, **Scope**, **Created by**, **Created**, **Status** (**Enabled** ou **Disabled**), **Event type** et le **Prompt ARIA** qu’elle envoie.

La section **Automation history** indique, pour chaque exécution, l’heure de déclenchement (**Triggered**) et le **Status**, ainsi qu’une colonne **Conversation**. Cliquez sur **Open thread** pour ouvrir la conversation créée par une exécution. La valeur **No thread** signifie que l’exécution n’a créé aucune conversation. Les exécutions restent affichées pendant 6 mois au maximum.

Utilisez **Back to chat** ou **Back to My automations** pour quitter la liste ou une vue détaillée.

Cliquez sur **Create automation** pour en créer une. Aucun formulaire ne s’ouvre : un nouveau chat ARIA démarre, avec le prompt suivant déjà envoyé en votre nom :

<AriaChatBubbles prompt="Guidez-moi dans la création d’une automatisation qui envoie un prompt à ARIA. Demandez-moi ce que je souhaite automatiser, aidez-moi à choisir sa portée et son déclencheur, et rédigez le prompt avec moi." response="Avec plaisir. Quel événement doit la déclencher, et l’automatisation doit-elle se trouver dans un projet ou dans un registre ? Une fois ce point réglé, je vous aiderai à formuler le prompt." />

**Create automation** est désactivé si vous disposez d’un accès à la facturation en lecture seule. **My automations** n’est pas disponible pour les comptes personnels : sélectionnez une organisation pour afficher vos automatisations. Le volet ne nécessite aucun feature flag distinct. Il est soumis aux mêmes contrôles d’accès que ceux décrits dans [Exigences](#requirements).

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

Le prompt est le seul élément à configurer 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 le run, l’artifact ou la métrique qu’ARIA doit examiner.

Tenez compte des contraintes suivantes :

* Le prompt est obligatoire et ne peut pas dépasser 4 000 caractères. W\&B vérifie à nouveau la longueur après avoir substitué les variables de modèle : un prompt enregistré sans erreur peut donc tout de même échouer lors de l’exécution de l’automatisation si les valeurs substituées sont longues. Un prompt qui ne passe pas cette vérification est consigné comme une exécution en échec dans l’[historique des exécutions](/fr/products/wandb/automations/view-automation-history) de l’automatisation.
* Une variable de modèle qui ne s’applique pas à l’événement est remplacée par une chaîne vide, et non par son propre nom. Utilisez uniquement les variables répertoriées pour votre événement.
* ARIA démarre une nouvelle conversation à chaque exécution de l’automatisation. Il ne reprend 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 **<Icon icon="plus" iconType="solid" />** à côté de celle-ci dans la liste située sous le champ **Prompt**. W\&B ajoute la variable à la fin du prompt. La liste n’affiche que les variables applicables à l’événement sélectionné.

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

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

Comparez ${artifact_version_string} à la version portant actuellement l’alias de production. Résumez toute régression des métriques d’évaluation et indiquez s’il est recommandé de promouvoir cette version.
```

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édigez un prompt qui vous demande de diagnostiquer l’échec." response="Voici un prompt à coller dans l’automatisation : « Le run ${run_name} du projet ${project_name} vient d’échouer. Examinez ses journaux, sa configuration et ses métriques système, comparez-le aux derniers runs réussis, puis indiquez-moi la cause la plus probable ainsi qu’un correctif concret à essayer. »" />

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

Les variables de modèle utilisent la syntaxe `${variable_name}`. Les variables disponibles dans 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’entity à laquelle appartient l’événement déclencheur de l’action. |
| `${project_name}` | Le nom du projet auquel appartient l’événement déclencheur de l’action. |

Selon l’événement, les variables suivantes sont également disponibles, en plus des précédentes :

| Événement | Variables supplémentaires |
| - | - |
| Une version d’artifact est créée, liée ou délié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 varie selon un 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 concernent certaines variables en particulier :

* `${artifact_version}` est résolue 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 métadonnées personnalisées dans la version d’artifact qui a déclenché l’événement. Remplacez `KEY` par la clé de métadonnées voulue. Seules les clés de métadonnées de premier niveau sont prises en charge.

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

<h2 id="view-conversations-created-by-automations">
  Afficher les conversations créées par les automatisations
</h2>

L’automatisation crée la conversation ARIA sous le compte de l’utilisateur qui l’a créée. La conversation apparaît dans la barre latérale de l’historique de conversation ARIA de cette personne, à côté des conversations qu’elle a elle-même lancé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 limitées à un projet ou à une équipe** : la conversation est créée dans le projet où l’événement s’est produit.
* **Automatisations limitées à 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 gère pour chaque équipe afin d’accueillir les conversations qui ne sont liées à aucun projet que vous avez ouvert. Vous n’avez pas à le créer, et il ne contient normalement rien d’autre que ces conversations.

Pour vérifier que l’automatisation s’est bien exécutée, ouvrez son [historique d’exécution](/fr/products/wandb/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. Pour ouvrir cette conversation, utilisez le lien **Open thread** du volet [My automations](#view-your-aria-automations-in-chat) d’ARIA, généré à partir du même `thread_id`. Dans votre historique de conversation, rien ne distingue une conversation créée par une automatisation des autres.

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

Affichez et gérez les automatisations depuis l’onglet **Automations** d’un projet ou d’un registre, ou depuis le hub global **Automations**. Dans la liste des automatisations, l’action apparaît 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.

Il est impossible de transférer la propriété d’une automatisation. Supprimez-la, puis 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.

<h2 id="limitations">
  Limitations
</h2>

Les automatisations ARIA présentent les limitations suivantes :

* Les automatisations ARIA sont disponibles uniquement sur le [Cloud mutualisé de W\&B](/fr/products/wandb/platform/hosting#wb-multi-tenant-cloud), dans les projets d’équipe, et seulement si l’administrateur de votre organisation a activé **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 a bien détecté l’événement, mais n’a pas exécuté son action.
* Si la personne qui a créé l’automatisation perd l’accès en écriture au projet ou si son compte est désactivé, toutes les exécutions ultérieures échouent. L’échec est consigné 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/products/wandb/automations/api).
* Le volet [My automations](#view-your-aria-automations-in-chat) du chat est en lecture seule. Pour activer, désactiver, modifier ou supprimer une automatisation, utilisez plutôt l’onglet **Automations** ou le hub.

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

Pour aller plus loin, consultez les ressources suivantes :

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