> 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 {% 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 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://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 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.