Pracę z agentem AI zacznij od ustalenia celu, instalacji BS4 i zakresu zmian. Dostęp przez MCP umożliwia odczyt konfiguracji i wykonanie udostępnionych komend; możliwości zależą od wersji programu. Aktualny katalog odkrywaj w połączonej instalacji.
Odkrywanie komend #
- Wywołaj narzędzie bs4_status, aby potwierdzić połączenie.
- Wywołaj bs4_list_command_groups, aby poznać obszary konfiguracji.
- Użyj bs4_list_commands lub bs4_search_commands, aby znaleźć funkcję odpowiadającą zadaniu.
- Przed wykonaniem pobierz kontrakt przez bs4_describe_command. Sprawdź argumenty, ograniczenia i odnośniki do instrukcji.
- Wybraną komendę wykonaj przez bs4_execute_command zgodnie z pobranym opisem.
Odczyt, podgląd i zapis #
Najpierw odczytaj obiekty, których dotyczy zadanie: klasę, kartotekę, stronę i interfejs. Nie wybieraj obiektu wyłącznie po podobnej nazwie. Przed zmianą wykonaj podgląd, jeżeli kontrakt go wymaga. Podgląd nie zastępuje wszystkich walidacji wykonywanych dopiero przy zapisie.
Dla zapisu stosuj dry_run, operation_id i kontekst _bs4 dokładnie według schematu konkretnej komendy. Nie wszystkie komendy mają identyczny zestaw argumentów. Przy ponowieniu tej samej operacji zachowaj identyfikator zgodnie z kontraktem; nie nadawaj nowego tylko po to, aby ominąć niepewny wynik.
Komunikaty operacji #
Czytaj cały wynik, w tym operation_feedback, jeśli jest zwracane. Rozróżnia ono fazę odczytu, podglądu i wykonania, przekazuje komunikaty BS4 oraz informację o błędach i pewności wyniku zapisu. Pomyślne wywołanie narzędzia nie oznacza, że można pominąć komunikaty walidacji.
Po błędzie, przerwaniu połączenia lub niepewnym wyniku najpierw odczytaj stan. Część zmian mogła już zostać zapisana. Dopiero po sprawdzeniu ustal, czy i jak ponowić operację.
Przykładowe polecenie dla agenta #
Sprawdź klasę klientów i jej istniejące formularze.
Zaproponuj pole „Preferowany termin kontaktu”.
Pokaż podgląd zmiany przed zapisem.
Po zapisie odczytaj konfigurację i sprawdź wynik.
Korzystaj z opisów komend dostępnych w tej instalacji.API a MCP #
REST API służy programom integracyjnym korzystającym z endpointów danych i działań. MCP udostępnia klientowi AI narzędzia z opisami i schematami. OpenAPI opisujące REST API nie jest katalogiem komend MCP. Tokeny obu rodzajów dostępu są odrębne.
