> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alyzai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dépannage

> Diagnostiquer un problème transversal avant de modifier ou relancer une action.

> [!NOTE]
>
> Référence · 9 min

Lorsqu’un résultat manque, commencez par déterminer si le problème concerne l’accès, les données, une connexion, l’état d’une ressource ou son affichage. Cette distinction évite les relances qui pourraient dupliquer une action.

## Classer le problème

```mermaid theme={null}
flowchart TD
	A["Le résultat attendu manque"] --> B{"La ressource est-elle accessible ?"}
	B -->|Non| C["Vérifier workspace, rôle et partage"]
	B -->|Oui| D{"L’action possède-t-elle une trace ?"}
	D -->|Non| E["Vérifier saisie, état et déclencheur"]
	D -->|Oui| F{"Un effet réel existe-t-il ?"}
	F -->|Oui| G["Ne pas relancer ; contrôler l’affichage ou le doublon"]
	F -->|Non| H["Ouvrir le premier état ou nœud en erreur"]
```

## Diagnostic en cinq minutes

**1. Décrivez le résultat attendu**

Notez l’action réalisée, le résultat attendu et ce qui s’est réellement passé. Utilisez une
heure et une ressource précises plutôt que « cela ne fonctionne pas ».

**2. Vérifiez le contexte**

Confirmez le workspace, la ressource, votre rôle et l’état affiché : brouillon, publié, en
cours, échoué ou archivé.

**3. Contrôlez la source**

Ouvrez la donnée, le document ou le service externe utilisé. Vérifiez son accès sans
modifier son contenu.

**4. Cherchez une trace**

Consultez l’historique de conversation, de génération, de synchronisation ou d’exécution
selon le module. Notez l’identifiant et le premier état anormal.

**5. Reproduisez sans risque**

Si aucune écriture n’a déjà eu lieu, testez une fois avec une donnée non sensible et un
périmètre réduit.

## Problèmes fréquents

| Symptôme | Premier contrôle |
| - | - |
| Un bouton est absent | rôle, partage et état de la ressource |
| Une donnée n’apparaît pas | source, filtre, date de synchronisation et droits |
| Une réponse semble incomplète | périmètre, mention de source et précision de la demande |
| Un workflow a échoué | premier nœud en erreur et version exécutée |
| Un document est vide | jetons, valeurs obligatoires et modèle publié |
| Une page semble ancienne | actualisez une fois, puis vérifiez l’état réel de la ressource |

## Où trouver la trace utile

| Module | Trace à consulter |
| - | - |
| Assistant | fil, ressource mentionnée, action ou carte de validation |
| Rapports | modèle publié, génération et document déjà créé |
| Automatisations | version, déclencheur, exécution et premier nœud en erreur |
| Connaissances | état du document, connexion et dernière synchronisation |
| Formulaires | version publiée, reçu, Revue et ligne de table |
| Portails | fil de la demande, état, contact et e-mail généré |
| Intégrations | compte, ressource testée et journal |
| Projets | fiche, provenance, commentaires et état |

> [!WARNING]
>
> Avant de relancer un envoi, une création, une synchronisation ou un workflow, vérifiez si
> l’action a déjà produit un effet. Une erreur d’affichage ne signifie pas toujours que l’écriture
> a échoué.

## Préparer une demande d’aide

Relevez l’URL de la page, le nom du workspace, l’heure, les étapes, le message exact et l’identifiant d’exécution s’il existe. Anonymisez les captures et ne transmettez aucun secret.

Ajoutez aussi :

* le module et l’état de la ressource ;
* le compte ou rôle utilisé, sans adresse complète si elle n’est pas nécessaire ;
* la dernière action qui a fonctionné ;
* le résultat d’un seul test contrôlé ;
* l’existence éventuelle d’un effet réel malgré le message d’erreur.

## Limites du dépannage utilisateur

Arrêtez les essais et contactez le support si :

* une action sensible semble s’être exécutée sans validation ;
* plusieurs écritures, envois ou créations inattendues apparaissent ;
* une donnée d’un autre workspace ou d’une audience non autorisée est visible ;
* une connexion ou session inconnue est détectée ;
* la reproduction nécessite un secret ou une donnée confidentielle.

## Questions fréquentes

> [accordion] Dois-je recharger la page ?
>
> Une fois peut aider à distinguer un affichage ancien. Contrôlez ensuite la ressource ou
> l’historique avant de relancer une action d’écriture.

> [accordion] Puis-je refaire exactement la même action ?
>
> Uniquement après avoir vérifié qu’aucun effet n’existe déjà. Une réponse vide ou une erreur
> d’affichage peut survenir après une écriture réussie.

> [accordion] Faut-il supprimer puis recréer la ressource ?
>
> Non en première intention. Cette action peut perdre la configuration ou casser des
> dépendances. Notez l’état et demandez de l’aide.

> [accordion] Que faire si le problème dépend de mon compte ?
>
> Comparez avec un compte représentatif seulement si cela respecte les règles d’accès. Ne
> partagez jamais vos identifiants.

<Snippet file="snippets/support.mdx" />

## Étape suivante

> [card] [Contacter le support](https://docs.alyzai.com/fr/aide/contacter-le-support.md)
>
> Envoyer un signalement exploitable et sécurisé.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.