Prompt e strumenti
Uno strumento non viene usato, le variabili restano vuote, le modifiche non hanno effetto o lo strumento API segnala un errore.
L'agente usa da solo strumenti come calendario, ricerca web, trasferimento, knowledge base o il tuo CRM quando il prompt e la descrizione dello strumento lo suggeriscono. Cosa ha usato e quando lo vedi nello storico chiamate, in Main Logs.
Uno strumento non viene usato
| Possibile causa | Soluzione |
|---|---|
| Lo strumento non è attivo | Nella scheda Strumenti controlla che compaia in Strumenti. Uno strumento solo citato nel prompt per l'agente non esiste |
| L'agente non sa quando usarlo | Compila la descrizione dello strumento: Contesto per l'IA per il trasferimento, Quando deve essere attivata la ricerca? per la ricerca web, Descrizione (per l'IA) per lo strumento CRM. Scrivilo anche nel prompt |
| Mancano dati che servono allo strumento | Con lo strumento CRM l'agente chiede prima tutti i parametri obbligatori. Controlla che chi chiama li abbia forniti |
| Trasferimento nel test audio | Nel browser non c'è una linea telefonica; un trasferimento si può provare solo con una chiamata vera |
Come verificarlo: nel test pronuncia esattamente la frase che deve attivare lo strumento, per esempio «Vorrei un appuntamento martedì». In Main Logs deve poi comparire una voce per lo strumento.
Uno strumento viene usato al momento sbagliato
| Possibile causa | Soluzione |
|---|---|
| Due strumenti hanno descrizioni simili | Separali chiaramente, per esempio «Trasferisci solo le emergenze, registra tutte le altre richieste come richiamata.» |
| La descrizione è troppo generica | Indica situazioni concrete invece di «se necessario» |
Le variabili restano vuote
| Possibile causa | Soluzione |
|---|---|
| Il nome nel segnaposto è diverso | {{Customer_name}} e {{customer_name}} sono variabili diverse. Scrivi il nome esattamente come nel webhook, in context o nella colonna della campagna |
| Spazi o caratteri speciali nel segnaposto | {{ customer_name }} non viene mai sostituito. Scrivi {{customer_name}} |
| L'Incoming Webhook non ha fornito il valore | Controlla in Statistiche Webhook se ha avuto esito positivo e imposta un Valore di riserva |
| Nelle campagne manca la colonna nel CSV | Al caricamento la dashboard avvisa quali segnaposto non hanno una colonna |
Un segnaposto senza valore viene rimosso prima della conversazione. L'agente quindi non legge mai il nome della variabile, la frase risulta solo incompleta.
Una modifica non ha effetto
| Possibile causa | Soluzione |
|---|---|
| Non salvata | Salva la modifica. Il test audio salva automaticamente prima di partire |
| La conversazione era già in corso | Le modifiche valgono dalla chiamata successiva |
| Hai modificato un altro agente | Controlla in Numero di telefono quale agente è assegnato al numero |
| Un modello ha sovrascritto il prompt | Sovrascrivi prompt sostituisce il testo precedente. Riapplica poi le tue modifiche |
Lo strumento CRM segnala un errore
| Possibile causa | Soluzione |
|---|---|
| Il tuo sistema non risponde con uno stato 2xx | Controlla in Main Logs l'output dello strumento e nel log del tuo sistema la richiesta |
| Timeout | Il tuo sistema risponde più lentamente del timeout. Aumentalo in Impostazioni avanzate o velocizza il tuo sistema |
| JSON non valido nel body | Controlla l'Anteprima del corpo della richiesta nello strumento. I segnaposto dentro le stringhe vanno tra virgolette: "name": "{{name}}" |
| Header errato o mancante | Controlla chiave e grafia nella sezione Headers |
Chi chiama sente silenzio mentre uno strumento lavora
Imposta un Testo di attesa, per esempio «Un attimo, lo sto registrando.» L'agente lo pronuncia mentre lo strumento lavora. Con la ricerca web una ricerca richiede da due a cinque secondi circa.
Ulteriore aiuto
Inviaci l'ora della chiamata, il nome dello strumento e uno screenshot di Main Logs, vedi Segnalare un problema.
Questa pagina ti è stata utile?