> 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-de/mit-ki-erstellen/limitations-and-faq.md). # Einschränkungen & FAQ {% hint style="warning" %} 🚧 **Frühzugang.** Build with AI wird schrittweise eingeführt und mit jedem Release verbessert. Etwas unklar, fehlt etwas oder ist etwas kaputt? [Sag es uns](/experience-cloud/experience-cloud-de/hilfe/how-do-i-contact-support.md): Dein Feedback beeinflusst direkt, was wir als Nächstes verbessern. {% endhint %} ## Einschränkungen Diese Tools sind fokussiert und bewusst eng begrenzt. Zu wissen, wo sie aufhören, bewahrt Sie davor, Dinge zu erwarten, für die sie nie gebaut wurden. * **Nur Avonni-Komponenten, nicht die Website selbst.** Die Skills fügen Avonni-Komponenten zu bestehenden Seiten der Site hinzu und konfigurieren sie. Sie erstellen weder die Site noch ihre Seiten, Routen, Themes oder Navigation: Erstellen Sie diese zuerst in Experience Builder und bringen Sie dann die Avonni-Bausteine zurück zu diesen Skills. * **Nichts wird bereitgestellt.** Jeder Skill schreibt oder bearbeitet Dateien lokal und hört dort auf. Er überträgt nie in eine Org. Die Bereitstellung der Änderung und das Veröffentlichen der Site liegen in Ihrer Verantwortung, mithilfe der Salesforce CLI oder Ihres üblichen Bereitstellungsprozesses. * **Der MCP-Server ist eine zwingende Voraussetzung.** Die Skills verweigern den Betrieb ohne ihn, statt zu raten. Es gibt keinen Offline-Modus: Wenn der Server nicht erreichbar ist, stoppt der Skill und fordert Sie auf, ihn zu verbinden. * **Der MCP-Server dokumentiert die neueste Version, die Ihrer installierten Paketversion voraus sein kann.** Der Dokumentationsdienst aktualisiert sich automatisch mit jeder Avonni-Paketveröffentlichung. Wenn Ihre Org eine ältere Paketversion verwendet, kann der Assistent möglicherweise selbstbewusst eine Komponente oder Eigenschaft nutzen, die Sie noch nicht haben. Halten Sie Ihre installierten Avonni-Pakete auf dem neuesten Stand, um synchron zu bleiben. * **Node.js und eine authentifizierte Salesforce CLI sind in jedem Client die Arbeitsgrundlage.** Die Skills führen lokale Skripte aus, die Node.js 18+ erfordern, und die Salesforce CLI verbindet sie mit Ihrer Org für Dokumentationsabfragen, Abfragen von Komponentenversionen sowie das Abrufen und Speichern von Site-Inhalten. Ohne diese Grundlage kann der Assistent Dokumentation lesen, aber nichts Brauchbares erzeugen, auch nicht in der Claude-Desktop-App. * **Der Architect koordiniert drei Artefakt-Skills, nicht alle vier.** `avonni-architect` koordiniert die Skills Experience, Flow und Dynamic Component. `avonni-lwc-components` ist ein Direktbearbeitungs-Workflow, den Sie eigenständig aufrufen. ## Fehlerbehebung | Problem | Ursache | Lösung | | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Der Skill wird nicht aktiviert | Die Skills sind nicht im Assistenten oder Projekt installiert, das Sie geöffnet haben. Der `npx skills add avonni/skills` Befehl installiert nur in das aktuelle Projekt. | Führen Sie den Installationsbefehl erneut aus dem geöffneten Projekt aus, kopieren Sie die Skill-Ordner in das Skills-Verzeichnis Ihres Assistenten (`.claude/skills/` für Claude Code), oder fügen Sie sie erneut über die Skills-Einstellungen Ihres Assistenten hinzu. | | Der Skill wird nicht aktiviert | Die Eingabeaufforderung ist zu vage, um den richtigen Skill auszulösen. | Benennen Sie ausdrücklich, was Sie erstellen ("Avonni-Komponente", "Experience-Site-Seite"), oder rufen Sie den Skill beim Namen auf. In Claude geben Sie `/avonni-experience-components`. | | Der Assistent rät Attribute, statt sie nachzuschlagen | Der MCP-Server ist nicht verbunden. | Prüfen Sie den MCP-Status Ihres Assistenten (in Claude Code führen Sie `claude mcp list`) und überprüfen Sie die Server-URL. Dann testen Sie mit *"Listen Sie die verfügbaren Avonni Experience-Komponenten auf."* | | Der Skill läuft, kann aber keine Org-Daten speichern oder nachschlagen | Node.js fehlt, oder die Salesforce CLI ist nicht installiert oder nicht bei Ihrer Org authentifiziert. | Installieren Sie Node.js 18+, installieren Sie die Salesforce CLI, und führen Sie dann `sf org login web` aus und versuchen Sie es erneut. | | Die MCP-Verbindung schlägt fehl | Falsche URL, falsches Transportprotokoll oder der Server wurde einem anderen Projekt hinzugefügt. Der `claude mcp add` Befehl registriert ihn nur für das aktuelle Projekt. | Bestätigen Sie, dass die URL `https://mcp.avonnicomponents.com` über das HTTP-Transportprotokoll lautet. Führen Sie den Befehl im richtigen Projekt erneut aus, oder fügen Sie ihn mit einem größeren Geltungsbereich hinzu (in Claude Code, `claude mcp add --scope user …`). | | Der Assistent kann eine Komponente, von der ich weiß, dass sie existiert, nicht finden | Ein `?toolsets=` Filter schließt das Paket der Komponente aus. Mit `?toolsets=experience`sind Flow-, Dynamic- und LWC-Komponenten unsichtbar. | Entfernen Sie den Filter oder fügen Sie das fehlende Paket der Liste hinzu. | | Eine Multi-Artefakt-Anfrage hat nur einen Teil erstellt | Die `avonni-architect` Der Skill ist nicht installiert, daher hat ein Einzelartefakt-Skill nur seinen eigenen Teil bearbeitet. | Stellen Sie sicher, `avonni-architect` ist zusammen mit den anderen Skills installiert. | --- # 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-de/mit-ki-erstellen/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.