Agenti AI¶
Un agente AI è un assistente intelligente in Odoo in grado di comprendere il linguaggio naturale, eseguire attività e assistere gli utenti interagendo con gli strumenti Odoo. Gli agenti sono un componente fondamentale della struttura AI in Odoo. Ogni agente ha uno scopo definito, un prompt e un insieme di argomenti e strumenti che guidano il suo comportamento.
Gli agenti sono costituiti da due componenti principali: Argomenti e Fonti.
Gli Argomenti sono le istruzioni e i ruoli che informano l’agente sui compiti che deve completare. Gli Strumenti sono assegnati agli argomenti e sono le funzioni effettive che l’agente può utilizzare per eseguire le attività.
Le Fonti forniscono all’agente le informazioni necessarie per completare le proprie attività.
Importante
Sebbene molte funzionalità AI possano essere utilizzate in Odoo senza l’applicazione AI, la creazione e la personalizzazione degli agenti richiede che l’applicazione AI sia installata.
Prompt AI in Odoo¶
Prima di lavorare con gli agenti AI, è importante comprendere alcuni concetti di base relativi ai prompt AI.
Un prompt AI è un insieme di istruzioni scritte o di contesto fornito a un modello AI che gli indica come rispondere a una richiesta o quale ruolo assumere. I prompt possono definire:
il tono, lo stile e la personalità del modello AI
l’ambito di ciò che il modello può fare
il tipo di output previsto dalla richiesta
In Odoo, a ciascun agente AI viene assegnato un Prompt di sistema, che definisce il ruolo complessivo, lo scopo e il comportamento dell’agente. Funge da dichiarazione di missione fondamentale dell’agente e guida tutte le interazioni.
Ogni Argomento include anche un proprio componente simile a un prompt, chiamato Istruzioni. Le istruzioni sono linee guida specifiche per argomento che perfezionano il comportamento dell’agente all’interno di un determinato contesto o flusso di lavoro e il modo in cui interagisce all’interno del framework Odoo.
Le istruzioni spesso includono:
Uno scopo, o ciò che copre l’argomento
Regole o vincoli che l’agente deve seguire quando gli viene assegnato questo argomento
Flussi di lavoro passo dopo passo su come completare un’azione specifica
Dettagli tecnici necessari per completare qualsiasi azione
Struttura dell’agente¶
Argomenti¶
Gli argomenti sono una raccolta di istruzioni e strumenti che definiscono come un agente si comporta all’interno di un contesto specifico. In sostanza, gli argomenti definiscono cosa può fare un agente all’interno del database. Gli argomenti guidano le conversazioni, indicando all’agente cosa può fare, come può farlo e quando dovrebbe farlo.
Importante
Se un agente non ha alcun argomento assegnato, può solo fornire informazioni, non completare attività o apportare modifiche al database.
All’interno di ogni argomento è incluso un prompt dettagliato, che fornisce all’agente istruzioni più approfondite su come eseguire le attività associate a quell’argomento, definire i limiti del suo comportamento e determinare come dovrebbe interpretare l’intento dell’utente. Questi prompt assicurano che l’agente segua un modello di ragionamento coerente e utilizzi gli strumenti appropriati per generare risposte accurate e contestualizzate.
I seguenti argomenti sono preconfigurati nell’applicazione AI:
Ricerca in linguaggio naturale: supporta l’interpretazione di una query dell’utente per aprire la vista Odoo appropriata con una serie di strumenti necessari per eseguire la ricerca.
Recupero informazioni: una raccolta di strumenti per recuperare informazioni sui modelli.
Crea lead: una raccolta di strumenti per supportare la creazione automatizzata di lead. Questo argomento è disponibile solo se è installata l’applicazione CRM.
All’interno di ogni argomento è presente una serie di Istruzioni, che fungono da prompt e forniscono indicazioni per la struttura dell’interazione, e uno o più Strumenti AI, che indicano le funzioni che l’agente può eseguire.
Utensili¶
Gli strumenti sono le funzioni che l’agente può eseguire in Odoo. Questi includono azioni come la creazione di un lead o l’apertura di una vista. Gli strumenti estendono lo scopo dell’agente oltre le conversazioni, consentono azioni reali. Gli strumenti disponibili in un database variano in base alle applicazioni installate. È possibile assegnare più Strumenti AI a un singolo argomento.
Fonti¶
Le fonti sono i dati a cui l’agente può fare riferimento durante la generazione di risposte o il completamento di attività. Le fonti sono indicizzate in modo che l’agente possa recuperare informazioni rilevanti quando un utente pone una domanda.
Example
Un agente progettato per rispondere a domande di assistenza clienti ha articoli Knowledge inclusi come fonti, che includono domande frequenti.
Le fonti possono essere nei seguenti formati:
Link web
Documenti (caricati nell’applicazione Documenti)
Articoli dell’applicazione Knowledge
Importante
Se l’opzione Limita alle fonti è abilitata su un agente, l’agente può utilizzare solo informazioni dalle fonti caricate e attive.
Crea un nuovo agente¶
Per creare un nuovo agente AI, andare su . Inserire un Nome agente, quindi aggiungere una breve descrizione, se desiderato.
Suggerimento
Prima di creare un nuovo agente, si consiglia di avere in mente un caso d’uso chiaro. Questo aiuta quando si scrive il Prompt di sistema e si assegnano gli Argomenti e gli Strumenti AI.
Selezionare un Modello LLM dal menu a discesa.
Importante
Odoo supporta più versioni sia di ChatGPT che di Gemini.
Successivamente, selezionare uno Stile di risposta. Questo gestisce il tono generale che l’agente utilizza quando risponde a una richiesta. Scegliere una delle seguenti opzioni:
Analitico: più matematico, questa opzione tende a fornire la stessa risposta alla stessa domanda. Questa opzione è consigliata per situazioni in cui l’accuratezza è più importante della diplomazia.
Bilanciato: un mix tra Analitico e Creativo. Questa è un’ottima opzione per situazioni con clienti esterni che potrebbero beneficiare sia di accuratezza che di diplomazia.
Creativo: affronta le domande in modo più umano, cambia le risposte ogni volta per reagire alla conversazione. Questa opzione funziona meglio quando le soluzioni variano spesso in base alla situazione.
Spuntare la casella Limita alle fonti per limitare l’agente a rispondere solo in base alle risorse fornite.
Successivamente, selezionare uno o più Argomenti per l’agente. Come spiegato sopra, gli Argomenti includono sia istruzioni che strumenti che guidano l’agente nell’aiutare gli utenti a completare un’attività.
Inserire un Prompt di sistema con istruzioni dettagliate per l’agente riguardo al suo ruolo e alle sue responsabilità.
Suggerimento
La specificità e la lunghezza del Prompt di sistema possono variare, a seconda del caso d’uso per l’agente. Utilizzare gli agenti preconfigurati come esempio delle possibili informazioni.
Se sono necessarie Fonti per l’agente, scorrere fino alla scheda Fonti, quindi fare clic su Aggiungi una fonte.
Selezionare un formato:
PDF: selezionare il file appropriato dalla finestra di esplorazione e fare clic su Apri
Weblink: incollare l’URL. È possibile aggiungere più link contemporaneamente, incollare un link per riga. Fare clic su Salva.
Documenti (caricati nell’applicazione Documenti): spuntare la casella accanto a uno o più documenti, quindi fare clic su Seleziona.
Articoli dell’app Knowledge: spuntare la casella accanto a uno o più articoli, quindi fare clic su Seleziona.
Una volta aggiunta una fonte, il campo Stato si aggiorna per riflettere il suo stato attuale. La fonte è pronta quando lo stato cambia da In elaborazione a Indicizzato. Spostare l’interruttore Attivo per attivare la fonte.
Importante
Se una fonte non viene caricata, potrebbe essere il risultato di un conflitto con il modello LLM selezionato.
Fare clic sul pulsante Test per aprire una finestra di conversazione e testare il nuovo agente.