Kiedy panel i agent się nie zgadzają

Przebuduj model pod panelem CRUD, gdy panel i agent przestają się zgadzać, czym jest rekord, kto może go zmienić i która zmiana jest dozwolona. Czat albo ogólny endpoint do zapisu działa, póki reguły siedzą w ekranach, a agent tylko czyta. Ludzie i agenci potrzebują tych samych encji, relacji i uprawnień. Dojdziesz do tego jednym procesem na raz. Stare ekrany zostaw, aż będą tylko pokazywać ten model.
Sygnały, że doklejanie doszło do ściany
Przyglądaj się codziennej pracy. Kolejny prompt na tych samych tabelach będzie się rozjeżdżał, gdy pojawi się któryś z tych sygnałów.
- Ekran i asystent mówią co innego. Przycisk zostaje nieaktywny, bo faktura jest nadal otwarta. Asystent, który dostał ogólny zapis, zamyka zlecenie. Reguła żyła we frontendzie, więc agent jej nie widział.
- Jeden rzeczownik, kilka tabel. Ekran CRM mówi „klient”, rozliczenia „konto”, a biuro serwisu „firma”. Asystent zgaduje, jak je połączyć. Arkusz obok panelu używa czwartej nazwy, a asystent albo go pomija, albo miesza z resztą.
- Nowa relacja jest niewidoczna, dopóki ktoś nie przepisze promptu. Wizyta należy do zgłoszenia, a zgłoszenie do maszyny. Panel pokaże to dopiero po nowym ekranie. Agent użyje tego dopiero po nowym prompcie. System nie zapamiętuje tej relacji.
- Uprawnienia wiszą na ekranach. „Kto może otworzyć tę stronę” nie mówi, kto może czytać ten rekord. Asystent działa na jednym koncie serwisowym i widzi wiersze, których nie widzi osoba przy panelu. OWASP nazywa to excessive agency (LLM06:2025): za dużo funkcji, za dużo uprawnień albo za dużo samodzielności. W ich przykładach rozszerzenie, które ma tylko czytać, dostaje prawo do update, insert i delete. Zadanie dla jednego użytkownika idzie kontem o wysokich uprawnieniach i widzi pliki wszystkich. OWASP zaleca też, żeby sprawdzenie siedziało w systemie, który trzyma dane, a nie żeby model sam decydował, co wolno zrobić.
- Status to dowolny tekst. Dozwolone przejścia żyją w interfejsie. Import, nocne zadanie i asystent zapisują stany, których panel nigdy nie oferuje, i później nikt nie odróżni prawdziwego „zrobione” od wartości, która się wślizgnęła.
- Ślad audytu to ostatnia osoba, która zapisała wiersz. Nie powiesz, która akcja się wykonała, na której encji i z czyjego upoważnienia. Gdy zapisuje i agent, i człowiek, o to audyt pyta najpierw.
Gdy kilka z tych sygnałów występuje razem, doklejanie wyczerpuje panel.
Co zawiera model semantyczny
Model semantyczny to wspólny opis pracy, trzymany tam, skąd czytają go i panel, i agent.
Encje. Rzeczowniki, którymi mówi zespół, każdy ze stałą nazwą i identyfikatorem: zgłoszenie, maszyna, wizyta, faktura. Common Data Model Microsoftu publikuje schematy encji, atrybutów, metadanych semantycznych i relacji, żeby aplikacje mogły dzielić dane razem z ich znaczeniem. To samo Konto ma wtedy jeden kształt wszędzie, a kolejna aplikacja może z niego skorzystać, bez składania go od nowa pod inną nazwą. W Twojej platformie trzymaj jedną nazwę na rzeczownik i używaj jej na każdym ekranie i w każdym narzędziu.
Relacje. Jawne powiązania. Wizyta należy do jednego zgłoszenia. Zgłoszenie należy do jednej maszyny. Złączenie jest faktem w modelu, więc prompt nie musi go zgadywać. Aplikacje oparte na modelu w Power Apps są zbudowane w ten sposób: relacje łączą tabele, ludzie przechodzą między powiązanymi rekordami, a takiej aplikacji nie ma bez modelu danych. Tę kolejność warto utrzymać na Twoim stosie: najpierw model, potem ekrany.
Akcje i cykl życia. Stany, w których rekord może być, i nazwane operacje, które go przenoszą: zaplanuj wizytę, zamknij zgłoszenie, oznacz fakturę jako opłaconą. Agent może wołać właśnie te operacje. Notatka Anthropic o narzędziach dla agentów (11 września 2025) opisuje częsty błąd: narzędzia, które tylko owijają istniejącą funkcję oprogramowania albo endpoint API, niezależnie od tego, czy agentowi to służy. Narzędzie schedule_event znajduje termin i rezerwuje go w jednym wywołaniu. Osobne narzędzia do listy i do tworzenia zostawiają agentowi złożenie tych kroków. Tak samo zawodzi ogólne narzędzie „zaktualizuj ten wiersz”.
Uprawnienia do encji i do akcji. To samo sprawdzenie dla człowieka i dla agenta. NIST SP 800-162 definiuje kontrolę dostępu opartą na atrybutach (ABAC) jako decyzję o operacji na podstawie atrybutów podmiotu, obiektu, żądanej operacji i, w niektórych przypadkach, warunków otoczenia. Rola, która tylko otwiera ekran, nie zapisuje niczego z tego.
W modelu jest jeszcze jeden fakt: która wersja jest bieżąca. Szkic, anulowany wiersz i żywy rekord to różne odpowiedzi. Panel i agent powinny traktować jako prawdę tylko wersję bieżącą.
Jak dojść do tego etapami
- Wybierz jeden proces, którego dotykają i panel, i agent. Zapisz rzeczowniki słowami ludzi, którzy tę pracę robią. Resztę panelu zostaw w spokoju. Jeśli proces dopiero wybierasz, oceń go tak, jak w poradniku jak wybrać pierwszy proces dla agenta AI.
- Na jednej stronie zapisz encje, atrybuty, które mają znaczenie, i relacje. Pomiń rundę, w której dokładasz kolumny do każdej tabeli. Biuro serwisowe, tak jak w poradniku jaki stos wybrać do platformy serwisowej, zaczyna od cyklu życia zgłoszenia: maszyna, problem, wizyta i stany, w których zgłoszenie może się skończyć. Ekrany czekają, aż ta strona powstanie.
- Każdą dozwoloną zmianę zapisz jako nazwaną akcję na serwerze. Ekran wywołuje akcję. Reguła siedzi przy modelu, więc agent woła tę samą akcję. Gdy asystent rezerwuje wizytę, używa akcji dyspozytora. Druga wizyta przy otwartym zgłoszeniu jest odrzucana i dyspozytorowi, i asystentowi.
- Ustal, kto może czytać każdą encję i kto może wykonać każdą akcję, a agenta uruchamiaj jako tego użytkownika. Wspólny token administratora znowu dokleja agenta z boku, bo ludzie i agent widzą wtedy inne wiersze. Narzędzia do odczytu zwracają encje, które ten użytkownik może widzieć. Każdy zapis to nazwana akcja, sprawdzana ponownie na serwerze. Takie sprawdzenie każdego żądania po stronie systemu opisuje OWASP przy rozszerzeniach.
- Daj agentowi tylko te narzędzia i sprawdź prawdziwe przypadki. Login do bazy albo ogólna trasa CRUD nie zamyka tej luki. Weź kilka pytań, na które człowiek już odpowiada z panelu. Tam, gdzie agent i człowiek się różnią, zmień model albo akcję. Prompt poprawiaj dopiero, gdy fakty się zgadzają.
- Nowe ekrany skieruj na model, a duplikaty usuń po pełnym cyklu. Stare ekrany zostaw, dopóki nie będą pokazywać samego modelu. Gdy ludzie i agent przejdą proces na tych samych encjach przez pełny cykl, usuń dodatkowe nazwy i arkusz obok panelu. Dopiero wtedy weź następny proces.
Najczęstsze błędy
- Zmiana nazw tabel i nazwanie tego modelem. Reguły nadal żyją w ekranach, więc agent i panel nadal się różnią.
- Dłuższy prompt na tym samym ogólnym zapisie. Asystent nadal zgaduje złączenia i zapisuje stany, które ekran by zablokował.
- Jedno konto serwisowe dla każdego asystenta. Ludzie i agenci widzą inne wiersze, a audyt nie powie, dla kogo była akcja.
- Rozrysowanie całej bazy, zanim jeden proces wejdzie w użycie. Strona rzeczowników nie spotyka prawdziwego przypadku, a panel dokłada kolejne ekrany obok.
- Drugi magazyn danych dla agenta. Rozjeżdża się z panelem i masz dwa opisy tej samej pracy.
Następny krok
Weź jeden proces. Na jednej stronie zapisz rzeczowniki, relacje, stany i nazwane akcje. Na tę stronę kierujesz i panel, i agenta.
Jeśli chcesz przejść przez jeden z Twoich paneli i zobaczyć, gdzie ten opis powinien siedzieć, możemy przyjrzeć się temu razem.