Akcje serwera AI¶
Akcje serwera AI rozszerzają platformę automatyzacji Odoo, umożliwiając sztucznej inteligencji podejmowanie decyzji podczas przepływu pracy.
Są przeznaczone do przypadków, gdy logiki nie można w pełni wyrazić za pomocą stałych warunków, ale nadal wymaga kontrolowanego wykonania za pośrednictwem standardowych akcji serwera.
Jak działają akcje serwera AI¶
Przepływy pracy oparte na AI w Odoo są zbudowane wokół wyraźnego rozdzielenia odpowiedzialności między akcją serwera AI, czyli Menedżerem, a narzędziem, czyli Wykonawcą.
Akcja serwera AI: menedżer¶
Akcja serwera AI działa jako decydent, czyli menedżer. Odczytuje rekord i jego kontekst. Interpretuje komunikat AI. I decyduje, które narzędzie wywołać oraz jakich argumentów użyć.
Akcja serwera nie wymusza reguł biznesowych, nie modyfikuje rekordów bezpośrednio ani nie gwarantuje poprawności operacji. Jej rola ogranicza się do podejmowania decyzji.
Narzędzie AI: wykonawca¶
Narzędzie to standardowa akcja serwera z włączoną opcją Użyj w AI na karcie Użycie. Narzędzia zawierają całą logikę wykonania i wykonują aktualizacje, przenoszenia lub zapisy rekordów. Narzędzia muszą jawnie wymuszać reguły biznesowe w kodzie Python.
Jeśli narzędzie jest wywoływane przez akcję serwera AI, wykona się bezwarunkowo, chyba że sam kod temu zapobiegnie.
Przepływ pracy akcji serwera AI¶
Przepływ pracy akcji serwera AI przebiega w następującej kolejności:
Rekord wyzwala akcję serwera AI.
Monit AI jest oceniany z użyciem rekordu jako kontekstu.
AI wybiera jedno z dostępnych narzędzi.
AI dostarcza argumenty oczekiwane przez narzędzie.
Wybrane narzędzie wykonuje swój kod Pythona.
Ważne
Akcje serwera AI działają bez niestandardowej logiki tylko wtedy, gdy bazowe zachowanie już istnieje w Odoo, na przykład przenoszenie dokumentu do folderu. W takich przypadkach AI wybiera parametry, a Odoo wykonuje akcję.
Przykład użycia krok po kroku¶
Przykład Automatyczne sortowanie dokumentów w skrzynce odbiorczej demonstruje pełny wzorzec akcji serwera AI. Przejdź do menu Akcje serwera poprzez .
Informacja
Ta akcja serwera jest zaprojektowana do przeglądania treści dokumentów i dodawania tagów. Sama akcja nie przenosi dokumentów ani nie dodaje tagów, tylko decyduje, które narzędzie powinno zostać użyte, na podstawie treści dokumentów.
Model dla akcji jest wymieniony jako Dokument, a Typ to AI.
Monit dla tej akcji dostarcza kontekst dotyczący dokumentu oraz zamiar akcji.
Pole Narzędzie zawiera kilka akcji, które mogą zostać podjęte na podstawie tego monitu, w tym przenoszenie dokumentu, dodawanie tagów lub tworzenie faktur lub rachunków.
Informacja
AI: Dodaj tagi, AI: Przenieś do folderu i AI: Zmień nazwę dokumentu to wszystkie akcje serwera typu Wykonaj kod, co oznacza, że uruchamiają kod Pythona.
Na przykład, jeśli akcja określi, na podstawie treści dokumentu, że najbardziej odpowiednim narzędziem jest AI: Przenieś do folderu, kod Pythona wykonuje następującą operację:
ai['result'] = record._ai_action_move_in_folder(folder_id)
Ten kod wykonuje się bezwarunkowo po wywołaniu i przeprowadza przeniesienie przy użyciu istniejącej metody.
Informacja
AI nie wnioskuje argumentów z kodu Pythona ani z sygnatury metody. Zamiast tego argumenty przekazywane do narzędzia są określane wyłącznie przez konfigurację narzędzia.
W przypadku narzędzia AI: Move to Folder kod Pythona oczekuje zmiennej o nazwie folder_id. AI wie, że musi dostarczyć folder_id, ponieważ jest to jawnie zadeklarowane jako argument w konfiguracji. Można to znaleźć w zakładce Użycie akcji serwera, w polu Schemat AI. Kolumna Nazwa w sekcji Schemat AI musi dokładnie odpowiadać nazwie zmiennej użytej w kodzie Pythona.
AI wykorzystuje opis argumentu, aby zrozumieć, co reprezentuje parametr, jakiego typu wartość jest oczekiwana i kiedy właściwe jest jej przekazanie.
Jeśli argument nie jest zdefiniowany w zakładce Użycie, AI nie może go dostarczyć, nawet jeśli kod Pythona się do niego odwołuje.
Tworzenie niestandardowych narzędzi AI¶
Ten sam wzorzec z powyższego przykładu Auto-sort documents in Inbox może być zaimplementowany przy użyciu standardowej logiki Odoo. Na przykład, aby utworzyć akcję, która może zaktualizować opis zadania, można utworzyć akcję Wykonaj kod z następującym kodem:
record.write({'description': content})
Aby działać poprawnie, content musi być zdefiniowane jako argument w zakładce Użycie narzędzia.
Zobacz także
Typowe problemy¶
Dlaczego pole Narzędzia jest puste?¶
Upewnij się, że przynajmniej jedna akcja serwera ma włączoną opcję Użyj w AI.
Upewnij się, że przynajmniej jedno narzędzie jest przypisane do tego samego modelu Model co akcja serwera.
Dlaczego narzędzie zostało uruchomione, ale nic się nie stało?¶
Kod Pythona zakończył się bez wprowadzania zmian.
Wymagane argumenty były brakujące lub puste.
Warunki biznesowe nie zostały zaimplementowane w logice narzędzia.
Dlaczego AI wybrało nieoczekiwane narzędzie?¶
W zapytaniu brakowało wystarczającego kontekstu.
Wiele narzędzi pasowało do tego samego zamiaru.
Nie wymuszono żadnych ograniczeń na poziomie narzędzia.