Azioni server AI¶
Le azioni server AI estendono il framework di automazione di Odoo consentendo all’intelligenza artificiale di prendere decisioni durante un flusso di lavoro.
Sono progettate per i casi in cui la logica non può essere espressa interamente tramite condizioni fisse, ma richiede comunque un’esecuzione controllata attraverso azioni server standard.
Come funzionano le azioni server AI¶
I flussi di lavoro basati sull’AI in Odoo sono costruiti attorno a una chiara separazione delle responsabilità tra l’azione server AI, o il Manager, e lo strumento, o il Worker.
Azione server AI: il manager¶
Un’azione server AI agisce come un decisore, o un manager. Legge il record e il suo contesto. Interpreta il prompt AI. E decide quale strumento chiamare e quali argomenti utilizzare.
L’azione server non impone regole aziendali, non modifica i record direttamente e non garantisce la correttezza dell’operazione. Il suo ruolo è limitato al processo decisionale.
Strumento AI: il lavoratore¶
Uno strumento è un’azione server standard con l’opzione Usa in AI abilitata nella sua scheda Utilizzo. Gli strumenti contengono tutta la logica di esecuzione ed eseguono aggiornamenti, spostamenti o scritture di record. Gli strumenti devono imporre esplicitamente le regole aziendali nel codice Python.
Se uno strumento viene chiamato dall’azione server AI, verrà eseguito incondizionatamente, a meno che il codice stesso non lo impedisca.
Flusso di lavoro dell’azione server AI¶
Il flusso di lavoro dell’azione server AI segue questa sequenza:
Un record attiva un’azione server AI.
Il prompt AI viene valutato, utilizzando il record come contesto.
L”AI seleziona uno degli strumenti disponibili.
L”AI fornisce gli argomenti previsti dallo strumento.
Lo strumento selezionato esegue il suo codice Python.
Importante
Le azioni server AI funzionano senza logica personalizzata solo quando il comportamento sottostante esiste già in Odoo, come lo spostamento di un documento in una cartella. In questi casi, l”AI seleziona i parametri e Odoo esegue l’azione.
Procedura dettagliata del caso d’uso¶
L’esempio Ordina automaticamente i documenti in Posta in arrivo dimostra il pattern completo dell’azione server AI. Accedi al menu Azioni server andando su .
Nota
Questa azione server è progettata per esaminare i documenti in base al loro contenuto e aggiungere tag. L’azione stessa non sposta i documenti né aggiunge tag, decide solo quale strumento utilizzare in base al contenuto dei documenti.
Il Modello per l’azione è indicato come Documento e il Tipo è AI.
Il prompt per questa azione fornisce il contesto sul documento, nonché l’intento dell’azione.
Il campo Strumento include diverse azioni che possono essere intraprese in base a questo prompt, tra cui spostare un documento, aggiungere tag o creare fatture o bollette.
Nota
AI: Add Tags, AI: Move to Folder e AI: Rename Document sono tutte azioni server Execute Code, il che significa che attivano codice Python.
Ad esempio, se l’azione determina, in base al contenuto del documento, che lo strumento più appropriato è AI: Move to Folder, il codice Python esegue la seguente operazione:
ai['result'] = record._ai_action_move_in_folder(folder_id)
Questo codice viene eseguito incondizionatamente quando chiamato ed esegue lo spostamento utilizzando un metodo esistente.
Nota
AI non deduce gli argomenti dal codice Python o dalla firma del metodo. Invece, gli argomenti passati a uno strumento sono determinati interamente dalla configurazione dello strumento.
Per lo strumento AI: Move to Folder, il codice Python si aspetta una variabile chiamata folder_id. AI sa di dover fornire folder_id perché è esplicitamente dichiarato come argomento nella configurazione. Questo si trova nella scheda Utilizzo dell’azione server, nel campo Schema AI. La colonna Nome sotto Schema AI deve corrispondere esattamente al nome della variabile utilizzato nel codice Python.
AI utilizza la descrizione dell’argomento per comprendere cosa rappresenta il parametro, che tipo di valore è previsto e quando è appropriato fornirlo.
Se un argomento non è definito nella scheda Utilizzo, l’AI non può fornirlo, anche se il codice Python vi fa riferimento.
Creazione di strumenti AI personalizzati¶
Lo stesso schema nell’esempio Auto-sort documents in Inbox riportato sopra può essere implementato utilizzando la logica standard di Odoo. Ad esempio, per creare un’azione che possa aggiornare la descrizione di un’attività, si potrebbe creare un’azione Execute Code con il seguente codice:
record.write({'description': content})
Per funzionare correttamente, content deve essere definito come argomento nella scheda Utilizzo dello strumento.
Vedi anche
Problemi comuni¶
Perché il campo Strumenti è vuoto?¶
Confermare che almeno un’azione server abbia Usa in AI abilitato.
Confermare che almeno uno strumento sia assegnato allo stesso modello Modello dell’azione server.
Perché lo strumento è stato eseguito ma non è successo nulla?¶
Il codice Python è terminato senza modifiche.
Argomenti obbligatori erano mancanti o vuoti.
Le condizioni operative non sono state implementate nella logica dello strumento.
Perché l’AI ha scelto uno strumento inaspettato?¶
Il prompt non conteneva un contesto sufficiente.
Più strumenti corrispondevano allo stesso intento.
Non sono stati applicati vincoli a livello di strumento.