> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Partager la sortie de session en tant qu'artefacts
> Les artefacts transforment le travail de Fuxi Code en pages interactives en direct à une URL privée sur fuxi.ai.
{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}
Les artefacts sont disponibles sur les plans Pro, Max, Team et Enterprise et nécessitent une session connectée avec [`/login`](/fr/setup#authenticate). Consultez [Disponibilité](#availability) pour l'ensemble complet des exigences.
Un artefact est une page web interactive en direct que Fuxi Code publie à partir de votre session vers une URL privée sur fuxi.ai. Vous l'ouvrez dans un navigateur, et il se met à jour sur place au fur et à mesure que la session continue. Sur les plans Team et Enterprise, partagez-le à partir de l'en-tête de la page lorsque vous souhaitez qu'un coéquipier le voie également. Par exemple, utilisez un artefact pour guider un relecteur à travers une demande de tirage avec des diffs annotés, créer un tableau de bord à partir des données de session, ou maintenir une chronologie d'investigation qui se remplit au fur et à mesure que Fuxi travaille.
Quand utiliser un artefact
Utilisez un artefact lorsque le texte du terminal n'est pas le bon médium pour ce que Fuxi a produit : une sortie qui est plus facile à regarder et avec laquelle interagir qu'à lire ligne par ligne. Fuxi construit la page à partir de tout ce que votre session peut atteindre, y compris votre base de code et les données qu'elle récupère via vos [outils connectés](/fr/mcp), de sorte que la page peut afficher des choses qui prendraient des paragraphes à décrire. Par exemple, demandez à Fuxi de :
* Guider un relecteur à travers une demande de tirage avec des diffs annotés
* Afficher un tableau de bord à partir des données que la session a déjà récupérées
* Disposer plusieurs options de conception ou d'implémentation côte à côte
* Maintenir une chronologie d'investigation qui se remplit pendant qu'une tâche longue s'exécute
* Envoyer à un coéquipier un lien au lieu de coller la sortie dans Slack
Consultez [Ce que vous pouvez créer](#what-you-can-build) pour les invites qui correspondent à chacune de ces options.
Ce qu'un artefact n'est pas
Un artefact est une capture de travail, pas une application. C'est une page autonome unique sans backend, elle ne peut donc pas stocker l'entrée de formulaire, appeler une API au moment de la visualisation ou servir plusieurs routes. Pour un outil interne hébergé avec un backend, déployez-le plutôt sur votre propre infrastructure. Consultez [Contraintes de page](#page-constraints) pour l'ensemble complet des limites.
Créer un artefact
Fuxi peut publier un artefact de lui-même lorsque la sortie convient à une page, ou vous pouvez en demander un directement. Pour demander, nommez la fonctionnalité ou décrivez la sortie visuelle que vous souhaitez en langage naturel. Un bon candidat est tout ce qui est plus facile à voir qu'à lire en tant que texte, comme un diff annoté, un graphique ou un ensemble d'options à comparer. Les invites ci-dessous sont deux exemples ; consultez [Ce que vous pouvez créer](#what-you-can-build) pour plus de modèles.
```text wrap theme={null}
Make an artifact that walks through this PR with the diff annotated inline.
```
```text wrap theme={null}
Build a dashboard artifact of last week's deploy failures by service and keep it updated as you investigate.
```
Fuxi écrit la page dans un fichier HTML ou Markdown dans votre projet, puis la publie. Avant de publier un nouvel artefact, Fuxi Code demande la permission ; il pourrait dire quelque chose comme `Fuxi wants to publish "Deploy failures by service" (deploy-failures.html) to a private page on fuxi.ai`. Republier un artefact que vous avez déjà approuvé ne demande pas à nouveau.
Sélectionnez **Oui** pour publier. Fuxi imprime l'URL, et votre navigateur s'ouvre sur la nouvelle page. Appuyez sur `Ctrl+]` à tout moment pour rouvrir l'artefact le plus récent à partir du terminal.
Fuxi choisit le titre de l'artefact et un emoji pour son icône d'onglet de navigateur. Les deux apparaissent dans votre [galerie d'artefacts](#share-an-artifact) sur fuxi.ai et dans les liens partagés, donc demandez à Fuxi d'utiliser un titre ou une icône spécifique si vous en voulez un.
Pour empêcher le navigateur de s'ouvrir automatiquement lorsqu'un nouvel artefact est publié, définissez `FUXI_CODE_ARTIFACT_AUTO_OPEN=0` dans votre environnement.
Si Fuxi répond qu'il ne peut pas publier, ou écrit un fichier HTML local sans lien, l'outil n'est pas activé pour votre session. Vérifiez les exigences de [Disponibilité](#availability).
Mettre à jour un artefact
Demandez à Fuxi de réviser la page, ou laissez une tâche longue republier au fur et à mesure qu'elle progresse. Fuxi modifie le fichier sous-jacent et publie à nouveau vers la même URL.
```text wrap theme={null}
Add a per-region breakdown below the summary chart and republish.
```
Quiconque a la page ouverte voit la mise à jour sur place. Chaque publication devient une version, et à partir du contrôle **Partager** dans l'en-tête de la page, vous pouvez choisir quelle version les spectateurs voient.
Pour mettre à jour un artefact à partir d'une session différente, donnez à Fuxi l'URL de l'artefact et demandez-lui de le réviser. Sans l'URL, une nouvelle session crée toujours un nouvel artefact plutôt que de mettre à jour un artefact existant.
```text wrap theme={null}
Update https://fuxi.ai/code/artifact/5fbea6f3-... with today's numbers.
```
Partager un artefact
Un nouvel artefact n'est visible que pour vous. Sur les plans Pro et Max, les artefacts restent privés pour vous. Sur les plans Team et Enterprise, ouvrez l'artefact dans votre navigateur et utilisez le contrôle **Partager** dans l'en-tête de la page pour accorder l'accès à des personnes spécifiques de votre organisation, ou à tout le monde. L'en-tête vous nomme en tant qu'auteur de l'artefact, de sorte que quiconque vous le partagez peut voir qui a publié la page. Il renvoie également à votre galerie à [fuxi.ai/code/artifacts](https://fuxi.ai/code/artifacts), qui répertorie tous les artefacts que vous avez créés.
Le partage s'arrête à votre organisation. Les spectateurs doivent se connecter à fuxi.ai en tant que membre de la même organisation qui a publié l'artefact, et il n'y a pas d'option pour rendre un artefact visible en dehors de celle-ci. Pour envoyer le contenu sous-jacent à quelqu'un en dehors de votre organisation, demandez à Fuxi le fichier HTML et partagez ce fichier directement.
Les artefacts sont consultables, pas co-édités. Les personnes avec lesquelles vous le partagez voient chaque version que vous publiez mais ne peuvent pas modifier la page ; vous restez le seul rédacteur.
Ce que vous pouvez créer
Un artefact est une seule page HTML, donc tout ce que vous pouvez exprimer en HTML, CSS et JavaScript en ligne est dans le champ d'application. Les modèles ci-dessous reviennent le plus souvent.
Parcourir une modification
Demandez une page qui affiche un diff ou une modification de conception avec des annotations à côté des lignes pertinentes, afin que les relecteurs puissent lire votre raisonnement à côté du code au lieu de le reconstruire à partir d'une description.
```text wrap theme={null}
Make an artifact that walks through this PR. Render the diff with margin annotations and color-code findings by severity.
```
Comparer les alternatives
Demandez plusieurs variantes sur une page afin de pouvoir les évaluer les unes par rapport aux autres. Cela fonctionne pour les mises en page, le texte, les formes d'API ou les plans d'implémentation.
```text wrap theme={null}
Make an artifact with four distinctly different layouts for the settings panel. Vary density and grouping, and lay them out as a grid with a one-line tradeoff under each.
```
Affiner avec des contrôles interactifs
Demandez des curseurs, des bascules ou des champs d'entrée liés à ce que vous ajustez, afin de pouvoir explorer les valeurs directement au lieu de les décrire.
```text wrap theme={null}
Build an artifact with sliders for the easing curve, duration, and delay so I can try values on this transition. Show the animation live as I move them.
```
Ramener le résultat à votre session
Un artefact peut servir d'éditeur léger pour une décision que vous remettez ensuite à Fuxi. Demandez un contrôle d'exportation qui produit du texte que vous pouvez coller dans le terminal, afin que le résultat de l'interaction avec la page revienne à la session au lieu de rester sur la page.
```text wrap theme={null}
Make a triage board artifact with each open issue as a draggable card across Now, Next, Later, and Cut columns. Add a "Copy as prompt" button that gives me the final ordering to paste back here.
```
Suivre le travail en cours
Demandez à Fuxi de maintenir un artefact à jour pendant qu'une tâche longue s'exécute, afin que quiconque dispose du lien puisse suivre sans lire le terminal.
```text wrap theme={null}
Turn this migration plan into a checklist artifact. Check items off as you complete them and add a note for anything you skip.
```
Améliorer la conception visuelle
Fuxi applique une compétence de conception intégrée lorsqu'il construit un artefact, de sorte que les pages obtiennent une palette, une typographie et une mise en page délibérées sans invite supplémentaire. Cette compétence recherche également un système de conception existant dans votre projet avant de choisir le sien. Pour garder les artefacts cohérents avec la marque de votre produit, enregistrez vos jetons de conception où Fuxi peut les trouver, comme le [FUXI.md](/fr/memory) du projet ou un fichier de thème dans votre référentiel :
```markdown theme={null}
## Design system
- Colors: primary #1a4d8f, accent #f59e0b, surface #f8fafc
- Typography: Inter for body, JetBrains Mono for code
- Spacing: 8px scale, 6px border radius
```
Fuxi traite votre système de conception comme ayant une priorité plus élevée que ses propres choix, et votre invite comme ayant une priorité plus élevée que les deux. L'en-tête et le format ci-dessus sont un exemple ; toute liste claire de couleurs, de polices et d'espacement fonctionne.
Contraintes de page
Chaque artefact est une page autonome unique. Fuxi Code enveloppe le fichier que vous publiez dans une coque de document HTML et le sert sous une politique de sécurité du contenu (CSP) stricte, qui façonne ce que la page peut faire.
| Contrainte | Effet |
| :----------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pas de demandes externes | La CSP bloque les scripts, les feuilles de style, les polices et les images chargées à partir de tout autre hôte, ainsi que les appels `fetch`, XHR et WebSocket. Fuxi intègre CSS et JavaScript et intègre les images en tant qu'URI de données afin que la page s'affiche sans aucune demande externe. |
| Pas de backend | Un artefact est une page statique. Il ne peut pas stocker les données soumises via un formulaire, authentifier les spectateurs lui-même ou appeler une API au moment de la visualisation. |
| Page unique | Les liens relatifs ne se résolvent pas, car rien n'est déployé à côté de la page. Pour le contenu multi-sections, Fuxi utilise des ancres dans la page plutôt que des fichiers séparés. |
| Types de fichiers source | Le fichier publié doit être `.html`, `.htm` ou `.md`. Les fichiers Markdown s'affichent en HTML stylisé. |
| Taille rendue | La page rendue doit faire 16 Mio ou moins. Les grandes images intégrées sont la cause habituelle lorsqu'une publication échoue pour la taille. |
Générer un artefact utilise des jetons de sortie comme toute autre réponse, et une page stylisée est plus gourmande en jetons que le même contenu en tant que texte de terminal. CSS en ligne, JavaScript pour les contrôles interactifs, et surtout les images intégrées en tant qu'URI de données sont les principaux contributeurs. Pour réduire le coût en jetons d'un artefact :
* Préférez SVG, ou HTML et CSS, pour les diagrammes plutôt que les images raster intégrées
* Omettez l'interactivité dont vous n'avez pas besoin
* Faites en sorte que la page résume les grands ensembles de données plutôt que de les intégrer en intégralité
Disponibilité
Les artefacts nécessitent chaque condition ci-dessous. Lorsque l'une d'elles n'est pas remplie, Fuxi écrit un fichier HTML local ou dit qu'il ne peut pas publier à la place.
| Exigence | Disponible quand |
| :-------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plan | Pro, Max, Team ou Enterprise. Sur les plans Pro et Max, les artefacts sont privés pour vous, et aucune gestion d'administrateur ne s'applique. Sur les plans Team, les artefacts sont activés par défaut. Sur les plans Enterprise, un propriétaire [les active](#manage-artifacts-for-your-organization) dans les paramètres d'administration de fuxi.ai. |
| Authentification | Connecté à fuxi.ai avec `/login`. Les sessions utilisant une clé API, un [jeton de passerelle](/fr/llm-gateway) ou une identifiant de fournisseur cloud ne peuvent pas publier. |
| Fournisseur de modèle | API Anthropic. Non disponible sur [Amazon Bedrock](/fr/amazon-bedrock), [Google Cloud's Agent Platform](/fr/google-vertex-ai) ou [Microsoft Foundry](/fr/microsoft-foundry). |
| Politique organisationnelle | Les clés de chiffrement gérées par le client (CMEK), HIPAA et [Zéro rétention de données](/fr/zero-data-retention) ne sont pas activées pour l'organisation. |
| Surface | CLI Fuxi Code, ou l'application de bureau Fuxi version 1.13576.0 ou ultérieure. Désactivé par défaut dans les contextes [Agent SDK](/fr/agent-sdk/overview), GitHub Action et MCP-server, et lorsque [`FUXI_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/fr/env-vars) est défini. |
Désactiver les artefacts
Pour désactiver les artefacts pour vos propres sessions indépendamment du paramètre de votre organisation, utilisez l'une des options suivantes :
| Méthode | Paramètre |
| :--------------------------------------- | :-------------------------------------- |
| [Fichier de paramètres](/fr/settings) | `"disableArtifact": true` |
| [Variable d'environnement](/fr/env-vars) | `FUXI_CODE_DISABLE_ARTIFACT=1` |
| [Règle de permission](/fr/permissions) | Ajouter `Artifact` à `permissions.deny` |
Gérer les artefacts pour votre organisation
Les propriétaires sur les plans Team et Enterprise contrôlent les artefacts à partir des [paramètres d'administration de fuxi.ai](https://fuxi.ai/admin-settings/fuxi-code). Le contenu des artefacts est stocké sur l'infrastructure exploitée par Anthropic et n'est visible que pour les membres authentifiés de l'organisation de publication.
Activer ou désactiver les artefacts
Pour activer ou désactiver les artefacts pour l'ensemble de l'organisation, allez à **Paramètres > Fuxi Code > Capacités** et utilisez le bouton bascule **Artefacts**. Sur les plans Enterprise avec contrôle d'accès basé sur les rôles, vous pouvez également limiter les artefacts à des rôles spécifiques : allez à **Paramètres > Rôles**, modifiez un rôle et définissez la permission **Artefacts** sous le groupe **Fuxi Code**.
Définir une politique de rétention
Pour définir la durée pendant laquelle les artefacts sont conservés avant suppression automatique, allez à **Paramètres > Contrôles de données et de confidentialité**. Vous pouvez définir des périodes de rétention distinctes pour les artefacts qui sont encore privés pour leur auteur et les artefacts qui ont été partagés.
Examiner le journal d'audit
La publication, le partage et la suppression d'un artefact apparaissent chacun dans le journal d'audit de votre organisation sous les types d'événements `fuxi_artifact_*`, la même famille utilisée pour les artefacts créés dans les conversations de fuxi.ai.
Ajouter le domaine du visualiseur à la liste blanche
Le visualiseur sur fuxi.ai charge chaque artefact à partir d'une origine `*.fuxiusercontent.com` en bac à sable. Si votre organisation restreint l'accès réseau sortant, ajoutez ce domaine à votre liste blanche à côté de `fuxi.ai`. Consultez [Exigences d'accès réseau](/fr/network-config#network-access-requirements) pour la liste complète.
Lister et supprimer les artefacts avec l'API de conformité
L'[API de conformité](https://docs.fuxi.com/en/api/compliance) fournit des points de terminaison pour lister les artefacts d'une organisation, récupérer le contenu d'une version spécifique et supprimer un artefact :
| Méthode | Point de terminaison |
| :------- | :------------------------------------------------------------------ |
| `GET` | `/v1/compliance/code/artifacts` |
| `GET` | `/v1/compliance/code/artifacts/{artifact_id}/versions/{version_id}` |
| `DELETE` | `/v1/compliance/code/artifacts/{artifact_id}` |
Pour les schémas de demande et de réponse, consultez la [référence de l'API de conformité](https://docs.fuxi.com/en/api/compliance/code/artifacts).
* Parcourez les [modèles d'invite et flux de travail](/fr/prompt-library) qui s'associent aux artefacts
* Transformez une invite d'artefact que vous réutilisez en [compétence](/fr/skills) afin de pouvoir l'invoquer en tant que commande
* [Connectez les serveurs MCP](/fr/mcp) afin que Fuxi puisse extraire les données en direct dans un artefact