KI-Coding-Agenten sind mittlerweile ein normaler Bestandteil der Entwicklung von Xperience by Kentico-Projekten. Gibt man einem Agenten ein Ticket mit der Anweisung "ein Widget hinzufügen, das verwandte Artikel auflistet", verbindet er bereitwillig eine View-Komponente, greift auf IContentRetriever zurück und schreibt eine Razor-View. Meistens funktioniert das. Gelegentlich stößt der Agent jedoch auf eine unbekannte API und beginnt, die Assemblies der Plattform zu dekompilieren, nur um eine Typ- oder Methodensignatur zu finden.
Für Entwickler wird eine solche Suche normalerweise durch IntelliSense erledigt. Ein Agent benötigt eine ebenso direkte Möglichkeit, verfügbare Typen, Parameter und Überladungen zu entdecken. Die offizielle API-Referenz von Kentico bietet sie.
Warum XbyK ein schwieriges Ziel für einen Coding-Agenten ist
Xperience by Kentico ist Closed Source. Anders als bei einer Open-Source-Bibliothek, deren Implementierung ein Agent einfach lesen kann, wird XbyK als kompilierte NuGet-Pakete ausgeliefert. Der tatsächliche Vertrag eines Typs – seine Konstruktoren, Überladungen, Nullbarkeit und die Frage, welche Member tatsächlich für Konsumenten und welche nur für die interne Infrastruktur vorgesehen sind – existiert ausschließlich in den Metadaten und in der Dokumentation, die Kentico dazu veröffentlicht. Das ist bei kommerziellen Plattformen nicht ungewöhnlich, verändert aber die Erfolgsaussichten eines Agenten, der es gewohnt ist, Quellcode als primäre Wahrheitsquelle zu verwenden.
Xperience by Kentico deckt außerdem ein breites Spektrum an Funktionen ab: Inhaltstypen, Webseiten-Elemente, wiederverwendbare Schemas, Page-Builder-Widgets sowie Management- und Content-Query-APIs sind auf verschiedene Namespaces verteilt. Während sich die Plattform weiterentwickelt, können die Trainingsdaten eines Modells genau an den für funktionierenden Code wichtigsten Stellen veraltet sein: bei verfügbaren Schnittstellen, Methodennamen und Überladungen.
Der Documentation-MCP hilft, beantwortet aber eine andere Frage
Kentico liefert bereits einen Documentation-MCP-Server als Teil der umfassenderen KentiCopilot -Initiative aus. Er stellt Tools bereit, mit denen aktuelle Dokumentation als Markdown durchsucht und abgerufen werden kann. Für einen Agenten, der ein Konzept verstehen muss, ist dies normalerweise der richtige erste Schritt: wie Berechtigungen für Inhaltselemente funktionieren, wofür ein wiederverwendbares Feldschema gedacht ist oder welches Muster für die Erstellung eines Page-Builder-Abschnitts empfohlen wird.
Die Lücke zeigt sich, sobald der Agent von „welcher Ansatz ist der richtige?“ zu „was genau muss ich aufrufen.“ wechselt. Konzeptionelle Dokumentation beschreibt Muster und Best Practices in Prosa und enthält einige beispielhafte Codeausschnitte. Sie war jedoch nie dafür gedacht, jede Konstruktorüberladung, jeden optionalen Parameter oder den exakten Rückgabetyp einer bestimmten Methode aufzulisten. Ein Agent, der IContentQueryResultMapper.Map korrekt aufrufen möchte, benötigt die tatsächliche Signatur – nicht einen Absatz über Content-Query-Ergebnisse im Allgemeinen. Genau diese Art von Frage kann konzeptionelle Dokumentation, so gut sie auch geschrieben sein mag, nicht beantworten.
Wenn eine Suche zu unnötiger Dekompilierung wird
Angesichts dieser Lücke kann ein Agent die relevante DLL im NuGet-Paketcache finden und ihren dekompilierten Code untersuchen. Eine Dekompilierung kann nützlich sein, wenn das Implementierungsverhalten untersucht oder ein Problem in der exakten Paketversion diagnostiziert wird, die ein Projekt verwendet.
Für eine einfache Suche nach einem Typ oder einer Methode sind Implementierungsdetails jedoch normalerweise unnötig. Der Agent benötigt dieselben Informationen, die ein Entwickler über IntelliSense erhält: die Deklaration, verfügbare Überladungen, Parametertypen und den Rückgabewert. Die API-Referenz stellt diese Informationen direkt zusammen mit Beschreibungen und Hinweisen zur Verwendung bereit.
Eine bessere Quelle der Wahrheit: api-reference.kentico.com
Kentico veröffentlicht api-reference.kentico.com, eine generierte API-Referenz, gegliedert nach Namespace und Typ. Namespace-Seiten listen die darin enthaltenen Typen auf. Typseiten zeigen Deklarationen, Vererbung, implementierte Schnittstellen sowie die zutreffenden Konstruktoren, Methoden und Eigenschaften; Parameter werden mit Namen und Typen ausdrücklich angegeben.
Vorhersehbare URLs ermöglichen es einem Agenten, eine Namespace-Auflistung abzurufen oder direkt zu einem bestimmten Typ zu navigieren:
https://api-reference.kentico.com/api/{Namespace}.html https://api-reference.kentico.com/api/{Namespace}.{TypeName}.html
Die Referenz enthält außerdem Hinweise, die dabei helfen, den vorgesehenen Verwendungszweck und Einschränkungen zu erkennen. Eine öffentliche Deklaration bedeutet allein nicht, dass eine API für benutzerdefinierten Code unterstützt wird: Die dokumentierte Klasse DefaultDataSettings ist beispielsweise ausdrücklich als nur für den internen Gebrauch gekennzeichnet. Das Lesen dieser Hinweise gehört zur Suche.
Es gibt eine wichtige Einschränkung: Die API-Referenz zeigt keine Versionsinformationen an. Ein Agent kann anhand einer einzelnen Seite nicht feststellen, ob seine Signaturen mit den in einem bestimmten Projekt installierten NuGet-Paketen übereinstimmen. Die Referenz ist eine direkte Quelle für die API-Ermittlung, aber der daraus entstehende Code muss weiterhin anhand der installierten Pakete des Projekts überprüft und durch einen Build verifiziert werden.
Der nächste Schritt bestand darin, diesen Suchprozess als wiederverwendbaren Skill für Agenten verfügbar zu machen.
Die Beobachtung in eine Agenten-Fähigkeit umwandeln
Agent Skills bündeln aufgabenspezifische Anweisungen in einer SKILL.md-Datei mit optionalen Skripten und unterstützenden Ressourcen. Mehrere agentenbasierte Tools, darunter GitHub Copilot, Claude Code und Codex, unterstützen sie. Diese Fähigkeit liefert Anweisungen für die Nutzung von Funktionen, über die der Agent bereits verfügt, etwa zum Abrufen einer Webseite.
Die xbyk-api-lookup-Fähigkeit ist für Aufgaben konzipiert, die einen XbyK-Typ, eine Methodensignatur, Schnittstelle oder einen Namespace erfordern. Sie führt den Agenten direkt zur offiziellen API-Referenz. Konzeptionelle Anleitungen und Konfigurationsanleitungen gehören nicht zu ihrem Umfang.
Die Anweisungen verwenden die beiden oben genannten URL-Muster , um Typen in einem Namespace zu finden oder einen bestimmten Typ zu untersuchen. Sie legen fest, was zu extrahieren ist: Deklaration und Namespace, Basisklasse und implementierte Schnittstellen, öffentliche Konstruktoren, Methodensignaturen und Rückgabetypen, Eigenschaften sowie relevante Hinweise oder Ausnahmen.
Die Fähigkeit umfasst außerdem das Nachschlagen von Dienstschnittstellen und das Finden von Erweiterungsmethoden über Namespace-Auflistungen. Ihre Checkliste fordert den Agenten auf, vor dem Schreiben von Code die Existenz des Typs, Parametername und -typen, Nullable-Annotationen und erforderliche Parameter zu überprüfen.
Wenn die Umgebung Hintergrundagenten unterstützt, fordert die Fähigkeit einen von ihnen auf, die Seite abzurufen und die angegebenen API-Details an den Hauptagenten zurückzugeben. Dadurch bleibt das Hauptgespräch auf das Ergebnis der Abfrage fokussiert.
Die Fähigkeit paketieren und teilen
Damit die Fähigkeit einfach projektübergreifend geteilt werden kann, wird sie als xperience-by-kentico-Plugin im öffentlichen Bluesoft Agent Skills Marketplace auf GitHub paketiert.
Der Marketplace stellt Installationsanweisungen für GitHub Copilot CLI, VS Code, Claude Code und Codex bereit. Die Einrichtung unterscheidet sich je nach Tool. Befolgen Sie die Anweisungen für Ihren Agenten. Nach der Installation und Aktivierung steht die Fähigkeit für relevante API-Suchaufgaben zur Verfügung.
Die Fähigkeit ergänzt die vorhandenen KentiCopilot-Tools. Der Documentation-MCP-Server unterstützt konzeptionelle Fragen, während die Content-Modeling- und Content-Management-MCP-Server das Entwerfen von Inhaltsmodellen und die Arbeit mit den Objekten eines Projekts unterstützen. Die API-Suchfähigkeit bietet einen fokussierten Weg zur dokumentierten Struktur eines Typs oder einer Methode.
Was sich in der Praxis ändert
Mit installierter Fähigkeit läuft dieselbe Anfrage „ein Widget hinzufügen, das verwandte Artikel auflistet“ anders ab. Der Agent ruft die relevante Typseite ab, überprüft die Methodensignaturen und Verwendungshinweise und schreibt Code anhand der dokumentierten API.
Angenommen, das Widget benötigt Artikelseiten aus einem bestimmten Bereich der Website. Zu wissen, dass IContentRetriever Inhalte abruft, ist nur der Ausgangspunkt: Der Agent benötigt außerdem die richtige Erweiterungsmethode und die von ihrer Überladung akzeptierte Parameterklasse. Die Referenz von RetrievePagesExtensions zeigt, dass RetrievePages<Article> ein RetrievePagesParameters-Objekt akzeptiert. Die Referenzseite dieses Typs zeigt seine verfügbaren Optionen, darunter ChannelName, PathMatch und LinkedItemsMaxLevel.
Die Abfrage verknüpft die Erweiterungsmethode mit ihrer spezifischen Parameterklasse und anschließend mit den zu ihrer Konfiguration benötigten Typen und Membern. Sie verhindert, dass der Agent ein ähnlich benanntes RetrieveContentParameters-Objekt übergibt oder einer PathMatch-Eigenschaft einen String zuweist. Diese Details sind direkt in der Referenz verfügbar, ohne sie aus dekompiliertem Implementierungscode rekonstruieren zu müssen.
Der Unterschied zeigt sich in weniger Kompilierungsfehlern beim ersten Versuch und einem geringeren Risiko, dass der Agent ein nicht unterstütztes Member aufruft. Das Überprüfen der Hinweise in der Referenz und das Erstellen anhand der im Projekt installierten Pakete bleiben Teil der Validierung des Ergebnisses.
Fazit
Die Verbesserung entsteht durch einen klaren Suchablauf für den Agenten: den Typ finden, seine Signaturen und Hinweise lesen und den Code im Projekt validieren. Für die alltäglichen Fragen, die Entwickler über IntelliSense beantworten, bietet die Kentico-API-Referenz Agenten einen direkten Anlaufpunkt. Die Fähigkeit macht diese Ressource zu einem festen Bestandteil ihres Workflows.
Bluesoft ist ein Entwicklungsunternehmen, das auf maßgeschneiderte Weblösungen, E-Commerce-Plattformen und digitale Anwendungen spezialisiert ist. Seit mehr als 17 Jahren sind wir Kentico Gold Partner und gehören zu den erfahrensten Implementierungsteams der Region.
Wir realisieren außerdem Projekte mit Kontent.ai und Umbraco und unterstützen mittelständische Unternehmen sowie Konzerne wie Škoda Auto, Sazka und E.ON. Unsere Lösungen erhalten regelmäßig Kentico-Auszeichnungen als „Site of the Year“ und bestätigen damit die Qualität und langfristige Zuverlässigkeit unserer Arbeit.
Als Teil der BiQ Group vereinen wir mehr als 590 Spezialisten und haben erfolgreich mehr als 2.100 Projekte umgesetzt.
👉 Kontaktieren Sie uns über unser Kontaktformular – unser Team wird sich bei Ihnen melden.
