Ti trovi qui:
Configurazione dell'agente per l'uso del contesto conversazionale
Per generare un elenco di domande che consenta agli acquirenti di ricevere più rapidamente consigli sui prodotti. L'Agente per Shopping guidato associa la domanda iniziale di un acquirente a una categoria di prodotti e genera domande pertinenti sulle preferenze di prodotto degli acquirenti.
-
Nella propria org Salesforce, nella parte superiore della pagina, fare clic su
e selezionare Imposta.
- Nella casella Ricerca veloce, immettere e selezionare Agenti Agentforce.
- Selezionare l'agente per lo shopping B2C e fare clic su Apri nel generatore.
- Nella scheda Argomenti, selezionare Assistente ricerca prodotti B2C Commerce.
- In Azioni di questo argomento fare clic su Nuovo e selezionare Aggiungi da raccolta risorse.
- Inserire e selezionare Ottieni domanda di contesto conversazionale B2C Commerce.
- Fare clic su Fine.
- Nel menu di navigazione a sinistra, fare clic sulla scheda Contesto, quindi su Nuova variabile.
-
Inserire i seguenti dettagli per la nuova variabile:
- Nome: convContextKey, il nome dell'API viene compilato automaticamente.
- Descrizione: Archivia i facet della categoria e rileva i cambi di contesto nelle conversazioni a più turni.
- Tipo di dati: Testo
- Selezionare Consenti l'impostazione del valore da parte dell'API e Consenti a LLM di utilizzare il valore.
- Salvare le modifiche.
- Nel menu di navigazione a sinistra, fare clic sulla scheda Argomenti, quindi nella scheda Azioni di questo argomento, fare clic su Ottieni domande sul contesto conversazionale di B2C Commerce.
-
Nella scheda Ingressi, assegnare una variabile per questi campi.
- ID sito →
MessagingSession SiteId__c - Token di autenticazione →
authToken - ID organizzazione →
MessagingSession OrganizationId__c - Impostazione locali utente →
MessagingSession UserLocale__c - Chiave di contesto della conversazione per la categoria corrente →
convContextKey
- ID sito →
-
Nella scheda Output, assegnare una variabile per questo campo.
Chiave di contesto della conversazione per la categoria corrente →
convContextKey - Tornare alla pagina Dettagli argomento, quindi fare clic sull'azione Cerca nell'archivio prodotti B2C.
-
Nella scheda Ingressi, assegnare una variabile per questo campo:
Chiave di contesto della conversazione per la categoria corrente →
convContextKey - Tornare alla pagina Argomenti, quindi fare clic sull'argomento B2C Commerce Product Search Assistant.
-
Nella scheda Configurazione argomento, scorrere verso il basso, fare clic su Aggiungi istruzioni e incollare queste istruzioni.
Nota Se hai già completato la configurazione iniziale per le domande di contesto conversazionale, sostituisci le istruzioni precedenti con queste istruzioni.CRITERIO DI CHIAMATA DEGLI STRUMENTI (PRIORITÀ ALTA): 1. Vincolo rigido sui rifiuti : quando l'utente rifiuta o rifiuta una conferma (ad esempio "no", "no", "non questo" o modifica le opzioni), NON è NECESSARIO chiamare B2CCommerceProductSearch in quel turno. In questo caso è NECESSARIO chiamare CommerceGuidedShoppingB2C__GetB2CConvContextQuestionAction per ricompilare o aggiornare convContext utilizzando l'ultimo messaggio dell'utente e impostare il valore contextSwitchType="exploratory". 2. Regola generale di ricerca prodotti: chiamare B2CCommerceProductSearch solo quando: a) convContext è completo (tutte le opzioni richieste sono scelte o confermate) E b) non ci si trova in una situazione di "utente appena rifiutato".3. Regola di fallback: se CommerceGuidedShoppingB2C__GetB2CConvContextQuestionAction non riesce o restituisce un errore, è possibile chiamare B2CCommerceProductSearch come fallback, a meno che non si stia gestendo un rifiuto dell'utente come nella regola 1. FLUSSO DI COMPILAZIONE DEL CONTESTO: richiamare sempre CommerceGuidedShoppingB2C__GetB2CConvContextQuestionAction utilizzando la query utente come input per compilare o affinare convContext, prima di chiamare B2CCommerceProductSearch. - Dopo aver ricevuto la risposta dell'utente, aggiorna convContext di conseguenza mantenendo il contesto esistente se la categoria rimane invariata. - Se la query dell'utente indica una categoria/prodotto diverso, è NECESSARIO richiamare nuovamente GetB2CConvContextQuestionAction per generare un nuovo convContext passando la query utente e un convContext vuoto. - Mantieni convContext in questo formato: convContext: "categoria/nome-prodotto, attribute1:value1, attribute2:value2, attributeN:valueN" ad esempio convContext: "abbigliamento da uomo, colore:blu, taglia:M" FLUSSO PASSO-PASSO: passo 1: Quando l'utente passa a un prodotto/categoria diverso (switch) o torna a uno precedente (repeat), DEVE chiamare prima GetB2CConvContextQuestionAction con la query del nuovo utente come input e impostare contextSwitchType su "switch" o "repeat" di conseguenza. Passo 2: Mostra le domande generate in testo normale (senza virgolette, senza formattazione aggiuntiva). Passo 3: Consentire all'utente di scegliere le opzioni e formare convContext nel formato specificato. Passo 4: Gestione della conferma: - Se chiedi all'utente di confermare le opzioni preselezionate (scenario di domande ripetute): * Se l'utente CONFERMA (sì/sì/sì/certo/va bene, ecc.): - Se convContext è completo, → chiama B2CCommerceProductSearch con convContext corrente. - Se sono necessari ulteriori dettagli → chiamare GetB2CConvContextQuestionAction per continuare a perfezionare convContext. * Se l'utente RIFIUTA o cambia le opzioni (no/no/non proprio/colore diverso/un'altra taglia ecc.): - Ripristina convContext su una stringa vuota e DEVE essere passato a GetB2CConvContextQuestionAction come input, insieme a contextSwitchType="exploratory". - Chiamare GetB2CConvContextQuestionAction senza convContext (vuoto) e contextSwitchType="exploratory" per generare un nuovo set di domande. - NON chiamare B2CCommerceProductSearch in questo turno. Passo 5: Se convContext è mancante o vuoto, ricompilarlo chiamando GetB2CConvContextQuestionAction con la query utente come input. Passo 6: Se GetB2CConvContextQuestionAction ha esito negativo o restituisce un errore: - Chiamare B2CCommerceProductSearch come fallback, a meno che non si tratti di una situazione di rifiuto dell'utente (vedere la regola 1). REGOLE IMPORTANTI PER contextSwitchType: 1. A ogni nuova chiamata GetB2CConvContextQuestionAction, passare il valore di contextSwitchType come "exploratory", "repeat" o "switch" come indicato di seguito: - Passare "exploratory" se si tratta della prima espressione di ricerca e non è ancora impostato convContext. - Passa "ripeti" quando viene chiesto di nuovo lo stesso tipo di prodotto (come se l'utente fosse tornato al prodotto cercato in precedenza nella sessione corrente). - Passare "switch" quando la query dell'utente viene spostata su un altro prodotto/categoria. 2. Quando la categoria o il prodotto cambia e si chiama GetB2CConvContextQuestionAction: - passare l'oggetto convContext corrente come convContext e - passare "repeat" o "switch" come contextSwitchType. Vuoto/"esplorativo" in caso di prima domanda. -
Fai clic su Aggiungi istruzioni e incolla queste istruzioni.
Quando il risultato di B2CCommerceProductSearch contiene un'azione di tipo "QUESTION_WITH_ANSWERS", utilizzare la matrice "options" per interpretare la risposta dell'utente. Ogni scelta contiene un "displayValue". Alla ricezione di una selezione o di una risposta da parte dell'utente, aggiornare convContext aggiungendo la nuova risposta nel formato illustrato di seguito. Non sostituire l'oggetto convContext esistente. Esempio: ConvContext esistente: "color:blue, size:M" QUESTION_WITH_ANSWERS (risposta dell'utente): Mostrami le giacche per la corsa. ConvContext aggiornato: "colore:blu, taglia:M, attività:esecuzione" - Salvare le modifiche.
- Visualizzare l'anteprima della conversazione con l'agente, quindi attivare l'agente aggiornato.
Questo articolo ha risolto il problema?
Facci sapere, così possiamo migliorare!
