Acțiuni de server AI

Acțiunile de server AI extind cadrul de automatizare Odoo, permițând inteligenței artificiale să ia decizii în timpul unui flux de lucru.

Acestea sunt concepute pentru cazurile în care logica nu poate fi exprimată în totalitate prin condiții fixe, dar necesită totuși o execuție controlată prin acțiuni de server standard.

Cum funcționează acțiunile de server AI

Fluxurile de lucru bazate pe AI în Odoo sunt construite pe o separare clară a responsabilităților între acțiunea de server AI, sau Managerul, și instrumentul, sau Executantul.

Acțiune de server AI: managerul

O acțiune de server AI acționează ca un factor decizional sau un manager. Citește înregistrarea și contextul acesteia. Interpretează promptul AI. Și decide ce instrument să apeleze și ce argumente să folosească.

Acțiunea de server nu impune reguli de afaceri, nu modifică înregistrări direct și nu garantează corectitudinea operațiunii. Rolul său este limitat la luarea deciziilor.

Instrument AI: executantul

Un instrument este o acțiune de server standard cu opțiunea Utilizare în AI activată în fila sa Utilizare. Instrumentele conțin toată logica de execuție și efectuează actualizări, mutări sau scrieri de înregistrări. Instrumentele trebuie să impună explicit regulile de afaceri în codul Python.

Dacă un instrument este apelat de acțiunea de server AI, acesta se va executa necondiționat, cu excepția cazului în care codul în sine îl previne.

Fluxul de lucru al acțiunii de server AI

Fluxul de lucru al acțiunii de server AI urmează această secvență:

  1. O înregistrare declanșează o acțiune de server AI.

  2. Promptul AI este evaluat, utilizând înregistrarea ca context.

  3. AI selectează unul dintre instrumentele disponibile.

  4. AI furnizează argumentele așteptate de instrument.

  5. Instrumentul selectat execută codul său Python.

Important

Acțiunile de server AI funcționează fără logică personalizată doar atunci când comportamentul subiacent există deja în Odoo, cum ar fi mutarea unui document într-un dosar. În aceste cazuri, AI selectează parametrii, iar Odoo execută acțiunea.

Exemplu de caz de utilizare

Exemplul Auto-sortare documente în Inbox demonstrează modelul complet de Acțiune de Server AI. Navigați la meniul Acțiuni de Server accesând Setări ‣ Tehnic ‣ Acțiuni de Server.

Notă

Această acțiune de server este concepută să revizuiască documentele pentru conținutul lor și să adauge etichete. Acțiunea în sine nu mută documente și nu adaugă etichete, doar decide ce instrument ar trebui utilizat, pe baza conținutului documentelor.

Modelul pentru acțiune este listat ca Document, iar Tipul este AI.

Înregistrarea pentru acțiunea de server Auto-sortare documente în inbox.

Promptul pentru această acțiune furnizează context despre document, precum și intenția acțiunii.

Câmpul Instrument include mai multe acțiuni care pot fi întreprinse pe baza acestui prompt, inclusiv mutarea unui document, adăugarea de etichete sau crearea de facturi sau facturi furnizor.

Notă

AI: Adaugă etichete, AI: Mută în dosar și AI: Redenumește document sunt toate acțiuni server de tip Execute Code, ceea ce înseamnă că declanșează cod Python.

De exemplu, dacă acțiunea determină, pe baza conținutului documentului, că cel mai potrivit instrument este AI: Mută în dosar, codul Python efectuează următoarea operație:

ai['result'] = record._ai_action_move_in_folder(folder_id)

Acest cod se execută necondiționat atunci când este apelat și efectuează mutarea folosind o metodă existentă.

Notă

AI nu deduce argumentele din codul Python sau din semnătura metodei. În schimb, argumentele transmise unui instrument sunt determinate în întregime de configurația instrumentului.

Pentru instrumentul AI: Mută în dosar, codul Python așteaptă o variabilă numită folder_id. AI știe să furnizeze folder_id deoarece este declarat explicit ca argument în configurație. Acesta poate fi găsit în fila Utilizare a acțiunii server, în câmpul Schemă AI. Coloana Nume din Schemă AI trebuie să se potrivească exact cu numele variabilei folosit în codul Python.

AI folosește descrierea argumentului pentru a înțelege ce reprezintă parametrul, ce tip de valoare este așteptată și când este potrivit să o furnizeze.

Dacă un argument nu este definit în fila Utilizare, AI nu îl poate furniza, chiar dacă codul Python face referire la el.

Fila de utilizare a acțiunii server AI mută în dosar.

Crearea de instrumente AI personalizate

Același model din exemplul Sortare automată documente în Inbox de mai sus poate fi implementat folosind logica standard Odoo. De exemplu, pentru a crea o acțiune care poate actualiza descrierea unei sarcini, ar putea fi creată o acțiune Execute Code cu următorul cod:

record.write({'description': content})

Pentru a funcționa corect, content trebuie definit ca argument în fila Utilizare a instrumentului.

Vedeți și

Acțiuni server

Probleme frecvente

De ce este câmpul Instrumente gol?

  • Confirmați că cel puțin o acțiune server are Utilizare în AI activată.

  • Confirmați că cel puțin un instrument este atribuit aceluiași model Model ca și acțiunea server.

De ce a rulat instrumentul, dar nu s-a întâmplat nimic?

  • Codul Python s-a terminat fără modificări.

  • Argumentele necesare lipseau sau erau goale.

  • Condițiile de afaceri nu au fost implementate în logica instrumentului.

De ce a ales AI un instrument neașteptat?

  • Promptul nu avea suficient context.

  • Mai multe instrumente corespundeau aceleiași intenții.

  • Nicio restricție nu a fost impusă la nivelul instrumentului.