> For the complete documentation index, see [llms.txt](https://guides.ia.numerique.gouv.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.ia.numerique.gouv.fr/assistant-ia/depannage/erreurs.md).

# Comprendre les erreurs de l'Assistant

Cette section vous aide à résoudre les problèmes les plus courants rencontrés avec l'Assistant IA. **L'Assistant vous indiquera toujours l'erreur qu'il rencontre**, soit via un message d'erreur technique, soit par un message explicite comme :

> *"Je n'arrive pas à accéder à internet, vérifiez que la configuration me l'autorise."*

Pensez à **rafraîchir la page** (F5 ou Ctrl+R) pour vérifier s'il n'y a pas un **bandeau d'erreur** en haut de l'interface indiquant l'indisponibilité de certaines fonctionnalités. Ces dernières peuvent être configurées par l'équipe de l'Assistant ou mises à jour automatiquement lorsque des fonctionnalités cassées sont détectées.

Si vous rencontrez un **vrai message d'erreur technique** (qui ne ressemble pas à une réponse normale de l'Assistant), vous pouvez réessayer dans une nouvelle conversation. La plupart de ces erreurs vous empêcherons de continuer dans cette conversation, car celle-ci est en message d'erreur.

***

## Problèmes de connexion

### Je n'arrive pas à me connecter

**Symptômes :**

* La page de connexion ne répond pas
* Erreur après identification ProConnect
* Message "Accès refusé"

**Solutions :**

1. **Vérifiez votre connexion ProConnect**
   * Assurez-vous d'utiliser vos identifiants professionnels
   * Si vous avez oublié votre mot de passe, réinitialisez-le via [ProConnect](https://proconnect.gouv.fr/)
2. **Vérifiez votre éligibilité**
   * L'Assistant IA est accessible à tous les agents des **administrations de l'État et de leurs organismes de tutelle**
   * Si vous pensez avoir droit à l'accès mais que la connexion échoue, contactez votre référent IA ministériel
3. **Problèmes techniques**
   * Essayez un autre navigateur (Chrome, Firefox, Edge recommandés)
   * Vide le cache de votre navigateur
   * Désactivez les extensions qui pourraient bloquer la connexion
4. **Maintenance en cours**
   * Les maintenances sont annoncées dans l'interface par l'intermédiaire de bannières situées en haut de la partie centrale. Une page de statut vera bientôt le jour.

{% hint style="info" %}
Si le problème persiste, [signalez-le à l'équipe](/assistant-ia/depannage/report-issue.md).
{% endhint %}

### Les réponses sont incomplètes ou coupées

**Solutions :**

1. **Attendez quelques secondes** - La génération peut être lente selon la charge
2. **Actualisez la conversation**
3. **Reformulez votre demande** de manière plus concise
4. **Divisez les questions complexes** en plusieurs messages

***

## Problèmes avec les documents

### Je ne peux pas téléverser de documents

**Symptômes :**

* Bouton de téléversement grisé
* Erreur lors du glisser-déposer
* Message **"Type de fichier non supporté"** (affiché par l'Assistant)

**Solutions :**

1. **Vérifiez le type de fichier**
   * Formats supportés : PDF, images (JPG, PNG), documents bureautiques (.md, .docx, .pptx, .xlsx)
   * Taille maximale : 10 Mo par fichier (variable selon la configuration) : un message d'erreur précisant la taille maximale s'affichera si le téléversement échoue.
2. **Vérifiez la disponibilité de la fonctionnalité**
   * Le téléversement de documents peut être temporairement désactivé pour maintenance
   * Un **bandeau d'erreur** peut apparaître en haut de page
3. **Essayez un autre navigateur**

### L'Assistant ne comprend pas mon document

**Solutions :**

1. **Vérifiez la qualité du document**
   * Les PDF mal scannés ou les images de mauvaise qualité peuvent ne pas être lisibles
   * Essayez de fournir le texte directement
2. **Soyez précis dans vos questions**
   * Au lieu de "Qu'est-ce qu'il y a dans ce document ?", demandez "Quel est le montant total mentionné dans la section budget ?"
3. **Donnez du contexte**
   * "Ce document est un compte rendu de réunion. Peux-tu m'en faire un résumé ?"

***

## Problèmes avec la recherche web

### La recherche web ne fonctionne pas

**Symptômes :**

* Bouton de recherche web grisé
* Pas de résultats de recherche
* Erreur **"Impossible d'effectuer la recherche"** ou **"La recherche web est désactivée"** (affiché par l'Assistant)

**Solutions :**

1. **Vérifiez que la recherche est activée**
   * Cliquez sur l'icône 🌐 dans la barre de message
   * Ou activez la "recherche intelligente" dans vos paramètres
2. **Vérifiez votre question**
   * La recherche fonctionne mieux avec des questions claires et précises
   * Évitez les questions trop vagues
3. **Problème temporaire**
   * Le service de recherche peut être temporairement indisponible
   * **Rafraîchissez la page** pour vérifier l'affichage d'un bandeau d'erreur
   * Réessayez plus tard

***

## Problèmes de performance

### L'application est lente

**Solutions :**

1. **Vérifiez votre connexion internet**
2. **Fermez les onglets inutilisés**
3. **Utilisez un navigateur moderne** (Chrome, Firefox, Edge, Safari récent)
4. **Videz le cache** de votre navigateur

### Les conversations mettent du temps à charger

**Solutions :**

1. **Utilisez la recherche** pour trouver des conversations spécifiques au lieu de tout parcourir

***

## Problèmes d'affichage

### L'interface ne s'affiche pas correctement

**Solutions :**

1. **Actualisez la page** (F5 ou Ctrl+R)
2. **Videz le cache** du navigateur
3. **Essayez un autre navigateur**
4. **Vérifiez la résolution** de votre écran
5. **Désactivez le mode zoom** (Ctrl+0 pour réinitialiser)

### Les messages ne s'affichent pas correctement

**Solutions :**

1. **Actualisez la conversation**
2. **Vérifiez que JavaScript est activé** dans votre navigateur
3. **Essayez de copier-coller** le message problématique

***

## Problèmes divers

### L'Assistant donne des réponses incorrectes

**Solutions :**

1. **Vérifiez les faits** - L'Assistant peut faire des erreurs, toujours croiser les informations
2. **Reformulez votre question** de manière plus précise
3. **Fournissez plus de contexte** ou de documents de référence
4. **Activez la recherche web** pour des informations actualisées
5. **Signalez l'erreur** pour aider à améliorer le service

**Rappel :** L'Assistant est un **outil d'aide**, pas une source de vérité absolue. Vous conservez la responsabilité finale de vérifier les informations.

***

## Besoin d'aide supplémentaire ?

Si vous ne trouvez pas de solution à votre problème :

1. [**Consultez les questions fréquentes**](/assistant-ia/depannage/faq.md)
2. [**Signalez un problème**](/assistant-ia/depannage/report-issue.md) à l'équipe technique
3. **Contactez votre référent IA** ministériel
4. **Rejoignez le canal Tchap** de la communauté pour voir si d'autres utilisateurs ont déjà rencontré le même problème : [Lien vers le canal Tchap](https://tchap.gouv.fr/#/room/!eAHyPLdVHMxNhKAbaC:agent.dinum.tchap.gouv.fr?via=agent.dinum.tchap.gouv.fr\&via=agent.education.tchap.gouv.fr\&via=agent.justice.tchap.gouv.fr)

{% hint style="warning" %}
Le canal de la communauté à pour but de créer un lieu d'échange entre utilisateurs. Les demandes d'accès à l'Assistant par des personnes ne remplissant pas les conditions énoncées dans cette documentation seront supprimées.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://guides.ia.numerique.gouv.fr/assistant-ia/depannage/erreurs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.