> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/creer-avec-lia/limitations-and-faq.md). # Limites et FAQ Ce que le serveur Avonni MCP et les compétences ne couvrent pas, ainsi que les correctifs pour les problèmes courants de configuration. {% hint style="warning" %} 🚧 **Accès anticipé.** Build with AI est déployé progressivement et s'améliore à chaque version. Quelque chose n'est pas clair, manque ou ne fonctionne pas ? [Dites-le-nous](/experience-cloud/experience-cloud-fr/aide/how-do-i-contact-support.md): vos retours déterminent directement ce que nous améliorerons ensuite. {% endhint %} ## Limitations Ces outils sont ciblés et volontairement limités. Savoir où ils s'arrêtent vous évite d'attendre d'eux des choses pour lesquelles ils n'ont jamais été conçus. * **Uniquement les composants Avonni, pas le site lui-même.** Les compétences ajoutent et configurent des composants Avonni sur des pages de site existantes. Elles ne créent pas le site, ses pages, routes, thèmes ni sa navigation : créez d'abord cela dans Experience Builder, puis ramenez les éléments Avonni dans ces compétences. * **Rien n'est déployé.** Chaque compétence écrit ou modifie des fichiers en local et s'arrête là. Elle n'envoie jamais rien vers une organisation. Le déploiement de la modification et la publication du site relèvent de votre responsabilité, à l'aide de Salesforce CLI ou de votre processus de déploiement habituel. * **Le serveur MCP est une dépendance incontournable.** Les compétences refusent de s'exécuter sans lui plutôt que de deviner. Il n'existe pas de mode hors ligne : si le serveur est inaccessible, la compétence s'arrête et vous demande de le connecter. * **Le serveur MCP documente la dernière version, qui peut être en avance sur le paquet que vous avez installé.** Le service de documentation se met à jour automatiquement à chaque version du package Avonni. Si votre organisation utilise une version de package plus ancienne, l'assistant peut utiliser avec assurance un composant ou une propriété que vous n'avez pas encore. Gardez vos packages Avonni installés à jour pour rester synchronisé. * **Node.js et un Salesforce CLI authentifié constituent la base de fonctionnement, dans tous les clients.** Les compétences exécutent des scripts locaux qui nécessitent Node.js 18+, et Salesforce CLI les connecte à votre organisation pour les recherches dans la documentation, les requêtes sur les versions de composants, ainsi que la récupération et l'enregistrement du contenu du site. Sans cette base, l'assistant peut lire la documentation mais ne peut rien produire d'utilisable, y compris dans l'application de bureau Claude. * **L'architecte coordonne trois compétences d'artefact, pas les quatre.** `avonni-architect` orchestre les compétences Experience, Flow et Dynamic Component. `avonni-lwc-components` est un flux de travail de modification directe que vous invoquez seul. ## Dépannage | Problème | Cause | Correction | | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | La compétence ne s'active pas | Les compétences ne sont pas installées dans l'assistant ou le projet que vous avez ouvert. La `npx skills add avonni/skills` commande s'installe uniquement dans le projet actuel. | Relancez la commande d'installation depuis le projet ouvert, copiez les dossiers de compétences dans le répertoire des compétences de votre assistant (`.claude/skills/` pour Claude Code), ou ajoutez-les à nouveau depuis les paramètres Skills de votre assistant. | | La compétence ne s'active pas | L'invite est trop vague pour déclencher la bonne compétence. | Nommez explicitement ce que vous construisez (« composant Avonni », « page de site Experience »), ou invoquez la compétence par son nom. Dans Claude, tapez `/avonni-experience-components`. | | L'assistant devine les attributs au lieu de les rechercher | Le serveur MCP n'est pas connecté. | Vérifiez l'état MCP de votre assistant (dans Claude Code, exécutez `claude mcp list`) et vérifiez l'URL du serveur. Puis testez avec *"Liste les composants Experience Avonni disponibles."* | | La compétence s'exécute mais ne peut pas enregistrer ni rechercher des données d'organisation | Node.js est manquant, ou Salesforce CLI n'est pas installé ou n'est pas authentifié auprès de votre organisation. | Installez Node.js 18+, installez Salesforce CLI, puis exécutez `sf org login web` et réessayez. | | La connexion MCP échoue | URL incorrecte, transport incorrect, ou le serveur a été ajouté à un autre projet. La `claude mcp add` commande l'enregistre uniquement pour le projet actuel. | Confirmez que l'URL est `https://mcp.avonnicomponents.com` via le transport HTTP. Relancez la commande depuis le bon projet, ou ajoutez-la à une portée plus large (dans Claude Code, `claude mcp add --scope user …`). | | L'assistant ne trouve pas un composant dont je sais qu'il existe | Un `?toolsets=` filtre exclut le package du composant. Avec `?toolsets=experience`, les composants flow, dynamic et LWC sont invisibles. | Supprimez le filtre ou ajoutez le package manquant à la liste. | | Une demande multi-artefact n'a généré qu'une seule partie | La `avonni-architect` la compétence n'est pas installée, donc une compétence à artefact unique n'a traité que sa propre partie. | Assurez-vous que `avonni-architect` est installée en même temps que les autres compétences. | --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/creer-avec-lia/limitations-and-faq.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.