Agenti AI

Un agente AI è un assistente intelligente in Laundry ERP che può comprendere il linguaggio naturale, eseguire task e assistere gli utenti interagendo con gli strumenti del sistema. Gli agenti sono un componente fondamentale della struttura AI e ciascuno ha uno scopo definito, un prompt e un insieme di topic e strumenti che ne guidano il comportamento.

Gli agenti sono composti da due componenti principali: Topic e Sorgenti.

• Topic: Istruzioni e ruoli che informano l'agente sui task da completare. Gli Strumenti sono assegnati ai topic e rappresentano le funzioni effettive che l'agente può utilizzare.
• Sorgenti: Forniscono all'agente le informazioni necessarie per completare i task.

Prompt AI in Laundry ERP

Prima di lavorare con gli agenti AI, è importante comprendere alcuni concetti base sui prompt AI.

Un prompt AI è un insieme di istruzioni scritte o contesto fornito a un modello AI che indica come rispondere a una richiesta o quale ruolo assumere. I prompt possono definire:

• Il tono, lo stile e la persona del modello AI
• L'ambito di ciò che il modello può fare
• Il tipo di output atteso dalla richiesta

In Laundry ERP, ogni agente AI ha un System Prompt assegnato, che definisce il ruolo generale, lo scopo e il comportamento dell'agente. Funziona come la missione principale dell'agente e guida tutte le interazioni.

Ogni Topic include anche una propria componente simile al prompt, chiamata Istruzioni. Le istruzioni sono linee guida specifiche per topic che raffinano il comportamento dell'agente all'interno di un certo contesto o workflow e come interagisce con il framework di Laundry ERP.

Le istruzioni spesso includono:

• Uno scopo, o ciò che il topic copre
• Regole o vincoli che l'agente deve seguire quando viene assegnato questo topic
• Workflow step-by-step per completare un'azione specifica
• Dettagli tecnici necessari per completare le azioni

Struttura degli Agenti

Topic

I Topic sono una collezione di istruzioni e strumenti che definiscono come un agente si comporta all'interno di un contesto specifico. Essenzialmente, i topic definiscono cosa può fare un agente nel database, guidando le conversazioni e indicando cosa può fare, come può farlo e quando dovrebbe farlo.

All'interno di ogni topic è incluso un prompt dettagliato che fornisce all'agente istruzioni approfondite su come eseguire i task associati a quel topic, definire i limiti del suo comportamento e determinare come interpretare l'intento dell'utente. Questi prompt garantiscono che l'agente segua un pattern di ragionamento coerente e utilizzi gli strumenti appropriati per generare risposte accurate e contestuali.

I seguenti topic sono preconfigurati nell'app AI:

• Natural Language Search: Supporta l'interpretazione di una query utente per aprire la vista appropriata di Laundry ERP con gli strumenti necessari per eseguire la ricerca.
• Information retrieval: Collezione di strumenti per recuperare informazioni sui modelli.
• Create Leads: Collezione di strumenti per supportare la creazione automatica di lead. Questo topic è disponibile solo se l'app CRM è installata.

All'interno di ogni topic è presente un insieme di Istruzioni, che fungono da prompt e forniscono indicazioni sulla struttura dell'interazione, e uno o più Strumenti AI, che indicano le funzioni che l'agente può eseguire.

Strumenti

Gli Strumenti sono le funzioni che l'agente può eseguire in Laundry ERP. Includono azioni come creare un lead o aprire una vista. Gli strumenti estendono lo scopo dell'agente oltre le conversazioni, abilitando azioni reali. Gli strumenti disponibili in un database variano in base alle applicazioni installate. È possibile assegnare più Strumenti AI a un singolo topic.

Sorgenti

Le Sorgenti sono i dati a cui l'agente può fare riferimento quando genera risposte o completa task. Le sorgenti vengono indicizzate in modo che l'agente possa recuperare informazioni rilevanti quando un utente pone una domanda.

Le sorgenti possono essere nei seguenti formati:

• PDF
• Weblink
• Documenti (caricati nell'applicazione Documenti)
• Articoli dell'app Knowledge

Creare un Nuovo Agente

Per creare un nuovo agente AI, navigare in App AI → Nuovo. Inserire un Nome Agente, quindi aggiungere una breve descrizione, se desiderato.

Selezionare un Modello LLM dal menu a tendina.

Successivamente, selezionare uno Stile di Risposta. Questo gestisce il tono generale che l'agente utilizza quando risponde a una richiesta. Scegliere tra le seguenti opzioni:

• Analitico: Più matematico, questa opzione tende a dare la stessa risposta alla stessa domanda. È consigliata per situazioni in cui l'accuratezza è più importante della diplomazia.
• Bilanciato: Un mix di Analitico e Creativo. È un'ottima opzione per situazioni con clienti esterni che beneficerebbero sia di accuratezza che di diplomazia.
• Creativo: Affronta le domande in modo più umano, cambia le risposte ogni volta per reagire alla conversazione. Funziona meglio quando le soluzioni spesso variano in base alla situazione.

Spuntare la casella Limita alle Sorgenti per limitare l'agente a rispondere solo in base alle risorse fornite.

Successivamente, selezionare uno o più Topic per l'agente. Come spiegato sopra, i Topic includono sia istruzioni che strumenti che guidano l'agente nell'aiutare gli utenti a completare un task.

Inserire un System Prompt con istruzioni dettagliate per l'agente sul suo ruolo e responsabilità.

Se sono necessarie Sorgenti per l'agente, scorrere fino alla scheda Sorgenti, quindi cliccare Aggiungi una sorgente.

Selezionare un formato:

• PDF: Selezionare il file appropriato dalla finestra explorer e cliccare Apri
• Weblink: Incollare l'URL. È possibile aggiungere più link contemporaneamente, incollare un link per riga. Cliccare Salva.
• Documenti (caricati nell'applicazione Documenti): Spuntare la casella accanto a uno o più documenti, quindi cliccare Seleziona.
• Articoli Knowledge: Spuntare la casella accanto a uno o più articoli, quindi cliccare Seleziona.

Una volta aggiunta una sorgente, il campo Stato si aggiorna per riflettere lo stato corrente. La sorgente è pronta quando lo stato cambia da In elaborazione a Indicizzato. Attivare il toggle Attivo per attivare la sorgente.

Cliccare il pulsante Test per aprire una finestra di conversazione e testare il nuovo agente.

Esempi Pratici per Lavanderie

Agente Assistenza Clienti Lavanderia

Caso d'uso: Rispondere a domande frequenti su servizi, tempi di lavorazione, listini.

Configurazione:

• System Prompt: "Sei l'assistente virtuale di Nome Lavanderia. Aiuti i clienti a ottenere informazioni su servizi di lavanderia industriale, noleggio biancheria, tempi di lavorazione e listini. Mantieni un tono professionale ma amichevole."
• Stile di Risposta: Bilanciato
• Topic: Information retrieval, Create Leads
• Sorgenti:
  • PDF del listino servizi
  • Articoli Knowledge su tempi lavorazione standard
  • FAQ su servizi speciali (sanificazione, riparazione divise)

Agente Qualificazione Lead Commerciale

Caso d'uso: Qualificare richieste commerciali e creare lead nel CRM.

Configurazione:

• System Prompt: "Sei un assistente commerciale per Nome Lavanderia. Qualifichi richieste di preventivo per servizi B2B (hotel, ristoranti, aziende). Raccogli informazioni su tipo servizio richiesto, volumi, frequenza e dati contatto. Crei lead nel CRM quando la richiesta è qualificata."
• Stile di Risposta: Bilanciato
• Topic: Create Leads, Information retrieval
• Limita alle Sorgenti: No (deve poter interagire liberamente per qualificare)

Agente Documentazione Tecnica Interna

Caso d'uso: Supporto tecnico per operatori su macchinari e procedure.

Configurazione:

• System Prompt: "Sei l'assistente tecnico interno per operatori di Nome Lavanderia. Fornisci informazioni su procedure operative, manutenzione macchinari, protocolli sicurezza e risoluzione problemi comuni."
• Stile di Risposta: Analitico
• Topic: Information retrieval
• Sorgenti:
  • Manuali tecnici macchinari (PDF)
  • Procedure operative standard (articoli Knowledge)
  • Schede sicurezza prodotti chimici
• Limita alle Sorgenti: Sì (solo informazioni validate)