Puoi utilizzare le applicazioni di esempio dell'agente integrate nella console per capire come viene creata un'applicazione dell'agente completata e per scoprire le best practice per la progettazione.
Importa un'applicazione agente di esempio nel tuo progetto
Per importare:
- Apri la console CX Agent Studio.
- Seleziona il progetto.
- Fai clic sul pulsante del menu a discesa accanto al pulsante Nuovo agente.
- Fai clic su Prova un agente di esempio.
Dopo un breve ritardo, l'applicazione agente di esempio verrà caricata nella console.
Agente di vendita al dettaglio Cymbal
Questa applicazione di esempio per agenti è un assistente per un'azienda fittizia chiamata Cymbal Home & Garden. Questo assistente può aiutare i clienti a selezionare i prodotti, identificare le piante e gestire il carrello degli acquisti.
Prova a fare una conversazione inserendo l'input nel simulatore dell'agente di anteprima. Puoi caricare immagini di piante, chiedere all'agente di identificarle e aggiungerle al carrello degli acquisti.
Vengono mostrate le seguenti funzionalità:
| Funzionalità | Descrizione |
|---|---|
| Architettura multi-agente | L'agente principale (cymbal_retail_agent) gestisce la maggior parte della conversazione. I subagenti gestiscono l'upselling e le domande fuori ambito. |
| Istruzioni | Per ogni agente vengono definite istruzioni strutturate specifiche per l'agente e globali. Queste istruzioni descrivono esplicitamente cosa deve fare l'agente e come deve farlo. Queste istruzioni mostrano anche come vengono referenziati altri agenti, strumenti e variabili. |
| Strumenti | Sono inclusi strumenti Python, uno strumento di Ricerca Google e uno strumento OpenAPI. Lo strumento OpenAPI fornisce un esempio per la definizione di un'API con tre endpoint. Lo strumento di sistema end_session viene utilizzato per completare una chiamata (vedi la sezione "Gestione sessione" dell'agente principale). Molti di questi strumenti hanno implementazioni stub, ma alcuni sono stati completati. Ad esempio, guarda lo strumento greeting Python, che viene utilizzato per controllare i saluti. Questo codice mostra come uno strumento può chiamare un altro strumento. |
| Variabili | Una variabile dello schema personalizzato viene utilizzata per memorizzare il profilo del cliente. Puoi aggiornare questo profilo in base alle tue esigenze. Una variabile booleana viene utilizzata per indicare se un responsabile ha approvato uno sconto. Una variabile booleana viene utilizzata per monitorare se le immagini sono state caricate. |
| Guardrail | Le impostazioni di protezione sono state personalizzate. Prompt Guard è attivato con un risultato personalizzato, è definita una blocklist con un risultato personalizzato, è definito un risultato di sicurezza ed è configurata una regola con istruzioni. |
| Callback | Sono stati definiti callback per before_model_callback, after_model_callback e after_tool_callback. |
| Valutazioni | Quando carichi per la prima volta l'applicazione dell'agente, vengono definite molte valutazioni basate su scenari e golden e inizia l'esecuzione. Puoi controllare i risultati di queste valutazioni al termine dei test. |