Was Ihr Assistent mit Aggrega tun kann
Sobald Ihr Assistent mit dem Aggrega-MCP-Server verbunden ist, arbeitet er mit derselben Binärdatei aggrega, die Sie in einem Terminal ausführen würden: Er liest die Schemas und die Dokumentation, entwirft und prüft Ihre Dateien, baut ein Release und veröffentlicht, wenn Sie es ihm erlauben. Diese Seite sagt, was das umfasst, nach Gruppen geordnet. Die vollständige Liste ist die Antwort des Servers selbst, und ihr ist zu vertrauen: Rufen Sie describe-capabilities ohne Argumente auf oder bitten Sie Ihren Assistenten darum, und der Server führt jedes Werkzeug auf, das er Ihnen anbietet, jedes mit einem einzeiligen Zweck, den Entitätsarten, für die es dient, und der Angabe, ob es schreibt. Kompatibilität beschreibt, was eine neue Version an den Werkzeugen ändern darf.
Die Schemas und die Dokumentation lesen
Der Server liefert Referenzmaterial, das ein Assistent liest, bevor er YAML schreibt: das JSON Schema einer Entität (schema://<kind>), jede Seite der Sprachreferenz (langref://<path>), den Leitfaden zum Verfassen (authoring://<topic>), das verfasste YAML einer Katalogentität (catalog://<kind>/<name>) und die Hilfe jedes Befehls (cli://<command>). Die Schemas sind in die Binärdatei eingebaut, und die Seiten stammen aus einer Kopie der Dokumentation, die der Server im Cache Ihres Rechners hält. Was er tut listet jede Familie auf.
Eine Rolle übernehmen oder einem Workflow folgen
Prompts zum Verfassen stellen den Assistenten als Entwickler, Architekt oder Betriebsautor auf oder richten ihn auf eine einzige Entitätsart aus, sodass seine Vorschläge innerhalb dessen bleiben, was diese Rolle schreibt. Workflow-Prompts legen die Reihenfolge der Aufrufe für ein Ziel fest, das mehrere erfordert: ein neues Aggregate und sein Release zusammenstellen, ein vorhandenes Chart, Infrastrukturmodul oder eine Compose-Datei in Aggrega übernehmen oder herausfinden, warum ein Build fehlschlägt. Ihr Client führt sie als die Prompts des Servers auf.
Herausfinden, was ein Workspace enthält
list-entities und list-releases sagen, was Ihr Workspace enthält und wie viel davon, und übergeben die Datensätze dann seitenweise; describe zeigt eine Entität oder alles, was ein Release erreicht; config-show meldet die geltende Konfiguration und woher jede Einstellung stammt. Der Server meldet außerdem die Caches, die konfigurierten Registries und die Plugins, die er auflöst. Siehe Herausfinden, was ein Workspace enthält.
Ihre Dateien entwerfen und prüfen
scaffold entwirft ein Ausgangsdokument für eine Entitätsart mit den Feldern, die die Art verlangt, oder schreibt eines der ausführbaren Beispiele der Dokumentation in ein neues Verzeichnis. get-schema gibt das JSON Schema einer Art zurück, validate prüft einen Entwurf und nennt jeden Platzhalter, der noch darin steht, lint prüft die Konventionen für die Veröffentlichung im Katalog, und explain-error erweitert eine Diagnose um die Korrektur, die sie verlangt. Weitere Werkzeuge beantworten die Fragen, die beim Bearbeiten aufkommen: welche Features an eine Komponente angehängt werden dürfen und womit sie sich verbinden darf, wohin ein neuer Eintrag in einer Datei gehört, und eine einzelne begrenzte Änderung, die auf ein Dokument angewendet wird, wobei jedes Byte, das sie nicht berührt, unverändert bleibt. Siehe Fragen, was angehängt werden darf und was sich womit verbinden darf und Eine einzelne begrenzte Änderung auf ein Dokument anwenden.
Ein Release auflösen und bauen
pull löst die Abhängigkeiten eines Release in den Cache auf und schreibt seine Lockfile, und build rendert das Release in seine Artefakte, standardmäßig im Speicher oder nach dist/ an der Wurzel des Workspace, wenn der Assistent es anweist, sie zu schreiben. Ein abgelehnter Build gibt die Diagnosen zurück, die sagen, was zu korrigieren ist. Siehe Auflösen, wovon ein Release abhängt und Gegen die Inhalte bauen, die ein Release bereits festlegt.
Ein Projekt aus einem anderen Werkzeug übernehmen
import liest eine Beschreibung, die ein anderes Werkzeug erzeugt hat, und schreibt Entwürfe von Aggrega-Dateien in den Workspace, damit Sie sie prüfen. Siehe Eine fremde Beschreibung in Entitätsentwürfe umwandeln und aggrega import für die Formate, die es liest.
Veröffentlichen, signieren und zurückziehen
Vier Werkzeuge legen eine Entität oder ein Artefakt in einer Registry ab, signieren, was dort veröffentlicht ist, oder ziehen es mit einer signierten Markierung zurück. Was sie ändern, erreicht jeden, der aus dieser Registry auflöst, und nichts davon lässt sich von jemandem zurücknehmen, der es bereits hat; daher sind dies die Werkzeuge, über die Sie nachdenken sollten, bevor Sie sie erlauben. Siehe Veröffentlichen, signieren und zurückziehen.
Jeden Befehl ausführen
Für einen Client, der den Server auf Ihrem eigenen Rechner über Standardeingabe und Standardausgabe gestartet hat, bietet der Server außerdem für jeden Befehl, den Sie eingeben könnten, ein danach benanntes Werkzeug an: cli-build führt aggrega build aus, cli-validate führt aggrega validate aus, und so weiter. Ein über HTTPS erreichter Server bietet keines davon an.
Was er ohne Rückfrage tun darf
Ein über Standardeingabe und Standardausgabe verbundener Assistent kann jedes Werkzeug, das der Server anbietet, ohne Rückfrage bei Ihnen aufrufen, sofern Ihr Client nicht so eingestellt ist, dass er es verweigert. In Ihrem Client erlauben und verweigern Sie Werkzeuge nach Namen. Was ein Assistent tun kann, ohne Sie vorher zu fragen nennt die Vorgänge, die über Ihren Workspace hinausreichen, und Eingrenzen, was der Server ankündigt kürzt die Werkzeugliste, wo Ihr Client nicht alles davon annimmt.