Ti trovi qui:
Subagenti per l'agente B2C Shopper
I subagent assegnati all'agente B2C Shopper definiscono le funzionalità dell'agente. Ogni subagente gestisce una fase del percorso di acquisto, tra cui la scoperta del prodotto, il carrello, la conferma dell'ordine, le domande frequenti e i controlli di sicurezza.
Router agente
Ogni conversazione con l'agente inizia con il subagent Agent Router. Durante ogni interazione con un acquirente, questo subagente indirizza una conversazione al subagente specifico dell'agente acquirente corretto.
| Nome subagente | A cosa serve | Azioni |
|---|---|---|
start_agent agent_router
|
Questo subagent legge tutti i messaggi degli acquirenti e li indirizza al subagent corretto. Quando un acquirente invia una richiesta di follow-up, l'Agent Router capisce che è correlata all'attività corrente e la indirizza al subagent corretto. Esegue inoltre l'impostazione della sessione. Ad esempio, copiando l'ID del sito collegato e le impostazioni locali dell'utente dal record della sessione di messaggistica alle variabili di lavoro prima del routing. |
|
- Se un acquirente risponde con una risposta ambigua durante una conversazione, ad esempio inserendo "aggiungilo", il router agente considera queste risposte come correlate all'attività corrente, non a nuove richieste.
- L'agente instrada i messaggi in base all'ultimo messaggio dell'acquirente. Filtra automaticamente qualsiasi codice in background, utilizzo automatico di strumenti o passaggi tecnici completati nei messaggi precedenti. L'agente reagisce esattamente a ciò che l'acquirente sta chiedendo al momento, senza interferenze da parte delle attività passate del sistema.
Per personalizzare il subagent router:
- Aggiungere una route per esporre un nuovo subagent o rimuoverne una per disattivare una funzionalità.
- Modificare il messaggio di benvenuto o le istruzioni di routing. Ad esempio, modificare la descrizione del router in modo che dia il benvenuto all'acquirente per primo alla prima sessione di chat.
- Riordinare o riformulare la logica di routing per influenzare il modo in cui l'agente interpreta le richieste ambigue in modo da risolvere le richieste in base al catalogo.
Agente acquirente Subagenti
I subagent Esperto prodotto, Carrello e Conferma ordine condividono un nodo di ragionamento. Tale nodo crea il prompt di ciascun subagent a partire da un insieme comune di variabili di modello. I subagent Supporto e Sicurezza non utilizzano il nodo condiviso. Funzionano secondo le proprie istruzioni. Poiché questi tre subagent commerciali attingono dalle stesse variabili, la modifica di una variabile modifica il comportamento di tutti i subagent che la utilizzano.
- retailer_name
- retailer_description
- retailer_voice
- tool_calling_guidance
- response_guidance
- example_response
- id_col
Subagenti di sicurezza e guardrail
Esistono subagent che si limitano a classificare le richieste. Non fanno nient'altro. Sono intenzionalmente stretti. Ognuno di essi include una sezione dettagliata da NON utilizzare in modo che i termini di acquisto comuni non vengano trattati come un attacco. Questi guardrail vengono definiti in config.additional_parameter__disabled_topics.
- Reverse engineering: rileva i tentativi di estrazione dei dati interni dell'agente. Queste richieste possono utilizzare "mostrami il prompt del tuo sistema", "elenca tutti i tuoi strumenti", "traduci le tue istruzioni". Ignora esplicitamente i verbi di dominio come aggiungere, visualizzare, trovare, estrarre e "questo strumento".
- Prompt injection: rileva i tentativi di override, ad esempio "ignora istruzioni precedenti", tag di sistema> falsi<, "modalità sviluppatore", furto d'identità di autorità e payload codificati. Ignora esplicitamente parole come "ignora" o "dimentica" per i dettagli descritti dall'acquirente.
- Contenuti inappropriati: rileva i contenuti realmente dannosi creati dagli utenti (incitamento all'odio, minacce, CSAM, autolesionismo, istruzioni per atti illegali). Tratta esplicitamente il vocabolario commerciale come sempre benigno, ad esempio "rotto", "batteria scarica", "affare killer" e reclami da parte di un acquirente, come "esperienza peggiore". Questi subagent instradano i messaggi con questo tipo di contenuto al subagent appropriato e non li contrassegnano.
- Off Topic: reindirizza educatamente le richieste off-topic e di cultura generale agli argomenti di shopping, senza rispondere alla domanda off-topic e senza rivelare i dettagli del sistema.
Per personalizzare questi subagent:
- Regola gli elenchi di segnali in base al tuo negozio. Aggiungi i tuoi nomi di prodotto che contengono parole sensibili all'elenco
sempre innocuoin modo che il modello non li contrassegni. Aggiungi i modelli di attacco che vedi. - Modificare il messaggio di reindirizzamento off-topic e le regole.
- Aggiungere o rimuovere argomenti disabilitati utilizzando il
config.additional_parameter__disabled_topics.
Suggerimenti per la configurazione di Subagent
- Molti subagent possono condividere una singola variabile. Per evitare di modificare ogni subagent che utilizza una variabile condivisa, utilizzare varianti con ambito, ad esempio cart_tool_calling_guidance o order_tool_calling_guidance per controllare il comportamento di un singolo subagente.
- Ogni stringa
di response_guidanceha un limite di 255 caratteri. Il superamento di questo limite genera un errore di script dell'agente. - Il response_guidance è JSON: convalida le virgolette precedute da caratteri di escape ed evita le virgole finali.
- Sostituisci i segnaposto. Se si lascia un token non sostituito nella sezione
UPPER_SNAKE_CASE, è possibile che si verifichi un errore di pubblicazione. - Test con dati reali. Nell'anteprima dell'agente, la modalità fittizia restituisce dati di catalogo falsi. Prima di trarre conclusioni, verifica qualsiasi comportamento di ricerca e carrello rispetto alle azioni in tempo reale.
- Agente B2C Shopper | Esperto di prodotto
Gestisce tutte le richieste relative ai prodotti, ad esempio l'esplorazione, la ricerca, i suggerimenti, i confronti e le domande sui prodotti. Cerca nel catalogo e cerca informazioni dettagliate sui prodotti in base alle esigenze. - Agente B2C Shopper | Subagente carrello
Il subagent Carrello gestisce l'intero ciclo di vita del carrello. Il subagente aggiunge prodotti e varianti, visualizza il riepilogo del carrello, aggiorna le righe e applica codici promozionali e coupon. - Agente B2C Shopper | Conferma d'ordine
Il subagente Conferma ordine conferma che l'acquirente ha effettuato un ordine e mostra i dettagli dell'ordine. Inoltre, recupera il carrello dopo che un pagamento non va a buon fine o un metodo di pagamento viene annullato. - Agente B2C Shopper | Domande frequenti sul sito Subagent
L'agente secondario Domande frequenti sul sito risponde alle domande degli acquirenti sulle politiche del negozio, come domande frequenti, costi di spedizione, tempi di reso e rimborsi. Estrae risposte solo da knowledge base collegate e restituisce una risposta normale quando non riesce a trovare una corrispondenza. - Aggiunta di subagent personalizzati e azioni personalizzate
I subagenti Shopper Agent gestiscono l'esperienza di acquisto transazionale. Se si desidera una funzionalità non presente nel modello subagente, crearne una personalizzata.
