Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

Co asystent może zrobić z Aggrega

Gdy asystent jest połączony z serwerem MCP Aggrega, pracuje z tym samym plikiem binarnym aggrega, który uruchamia się w terminalu: czyta schematy i dokumentację, tworzy szkice plików i je sprawdza, buduje encję Release, a jeśli mu się na to pozwoli — publikuje. Ta strona opisuje w grupach, co to obejmuje. Pełną listą jest odpowiedź samego serwera i to jej należy ufać: wystarczy wywołać describe-capabilities bez argumentów lub poprosić o to asystenta, a pojawi się lista wszystkich narzędzi oferowanych przez serwer, każde z jednowierszowym opisem przeznaczenia, obsługiwanymi rodzajami encji i informacją, czy zapisuje. Zgodność określa, co wydanie może zmienić w narzędziach.

Czytanie schematów i dokumentacji

Serwer udostępnia materiały referencyjne, które asystent czyta przed napisaniem YAML: JSON Schema encji (schema://<kind>), dowolną stronę dokumentacji referencyjnej języka (langref://<path>), przewodnik tworzenia (authoring://<topic>), napisany YAML encji katalogu (catalog://<kind>/<name>) oraz pomoc dowolnego polecenia (cli://<command>). Schematy są wbudowane w plik binarny, a strony pochodzą z kopii dokumentacji, którą serwer przechowuje w pamięci podręcznej komputera. Sekcja Co robi wymienia każdą rodzinę.

Przyjęcie roli lub realizacja przepływu pracy

Prompty tworzenia przypisują asystentowi rolę programisty, architekta lub autora operacyjnego albo skupiają go na jednym rodzaju encji, tak aby jego sugestie pozostawały w zakresie tego, co pisze dana rola. Prompty przepływów pracy wyznaczają kolejność wywołań dla celu, który wymaga ich kilku: skomponowania nowej encji Aggregate i jej encji Release, przeniesienia do Aggrega istniejącego chartu, modułu infrastruktury lub pliku Compose albo ustalenia, dlaczego kompilacja się nie powiodła. Klient wyświetla je jako prompty serwera.

Sprawdzanie zawartości obszaru roboczego

list-entities i list-releases informują, co zawiera obszar roboczy i w jakiej ilości, a następnie przekazują rekordy po jednej stronie naraz; describe pokazuje jedną encję lub wszystko, do czego sięga encja Release; config-show raportuje obowiązującą konfigurację i pochodzenie każdego ustawienia. Serwer raportuje też pamięci podręczne, skonfigurowane rejestry i rozwiązywane przez siebie wtyczki. Zob. Sprawdzanie zawartości obszaru roboczego.

Tworzenie szkiców i sprawdzanie plików

scaffold tworzy szkic dokumentu startowego dla rodzaju encji, zawierający pola wymagane przez ten rodzaj, lub zapisuje jeden z uruchamialnych przykładów z dokumentacji w nowym katalogu. get-schema zwraca JSON Schema rodzaju, validate sprawdza szkic i wskazuje każdy pozostały w nim symbol zastępczy, lint sprawdza konwencje publikowania w katalogu, a explain-error rozwija diagnostykę w poprawkę, której ona wymaga. Kolejne narzędzia odpowiadają na pytania pojawiające się podczas edycji: które Features można dołączyć do komponentu i z czym może się on łączyć, gdzie w pliku należy umieścić nowy wpis, a także zastosowanie do dokumentu jednej ograniczonej edycji, z zachowaniem bez zmian każdego bajtu, którego nie dotyczy. Zob. Pytanie o to, co można dołączyć i co może łączyć się z czym oraz Stosowanie jednej ograniczonej edycji do dokumentu.

Rozwiązywanie i budowanie encji Release

pull rozwiązuje zależności encji Release do pamięci podręcznej i zapisuje jej plik blokady, a build renderuje encję Release do jej artefaktów, domyślnie w pamięci, a gdy asystent poprosi o ich zapisanie — do dist/ w katalogu głównym obszaru roboczego. Odrzucona kompilacja zwraca diagnostykę wskazującą, co należy poprawić. Zob. Rozwiązywanie zależności encji Release oraz Budowanie na podstawie treści już przypiętej przez encję Release.

Przenoszenie projektu z innego narzędzia

import odczytuje opis wygenerowany przez inne narzędzie i zapisuje w obszarze roboczym szkice plików Aggrega do przejrzenia. Formaty, które odczytuje, opisują Przekształcanie obcego opisu w szkice encji oraz aggrega import.

Publikowanie, podpisywanie i wycofywanie

Cztery narzędzia umieszczają encję lub artefakt w rejestrze, podpisują to, co zostało tam opublikowane, lub wycofują to za pomocą podpisanego znacznika. Wprowadzane przez nie zmiany docierają do każdego, kto rozwiązuje zależności z tego rejestru, i żadnej z nich nie da się odebrać komuś, kto już ją ma, dlatego właśnie nad tymi narzędziami warto się zastanowić, zanim się na nie zezwoli. Zob. Publikowanie, podpisywanie i wycofywanie.

Uruchamianie dowolnego polecenia

Dla klienta, który uruchomił serwer na komputerze użytkownika przez standardowe wejście i wyjście, serwer oferuje również narzędzie dla każdego polecenia, które można wpisać, nazwane od tego polecenia: cli-build uruchamia aggrega build, cli-validate uruchamia aggrega validate i tak dalej. Serwer osiągany przez HTTPS nie oferuje żadnego z nich.

Co może zrobić bez pytania

Asystent połączony przez standardowe wejście i wyjście może bez pytania wywołać każde narzędzie oferowane przez serwer, chyba że klient jest skonfigurowany tak, aby tego zabronić. To w kliencie zezwala się na narzędzia i blokuje je według nazwy. Co asystent może zrobić bez wcześniejszego pytania wymienia operacje wykraczające poza obszar roboczy, a Zawężanie tego, co ogłasza serwer skraca listę narzędzi, gdy klient nie przyjmie jej w całości.