Configuració de l'agent - Lovi AI Documentation

1. Motor: El cervell del vostre agent 🧠

Aquí és on definiu com pensa i respon el vostre agent. És el punt de partida obligatori.

✏️ Prompt

El Prompt és el “guió” principal del vostre agent — defineix el to, la personalitat i els límits bàsics.

Exemple amigable:
“Ets un assistent amable i directe 🌞. Respon en català en 2–3 frases. Si no saps la resposta, ofereix transferir a un humà.”
Exemple expert:
“Ets un tècnic sènior 🛠️. Proporciona passos numerats i concrets. Sigues breu i professional.”

⚙️ Funcionalitats addicionals

Aquests commutadors us permeten ajustar el comportament de resposta del vostre agent:

Commutador	Què fa
Entorn GPT	Activa el motor GPT per a aquest agent. Ideal per a converses naturals i obertes.
Stream IA	Activa la transmissió en temps real de les respostes de la IA a l’usuari mentre es generen. Ideal per a una sensació de xat més fluida.
Contingut enriquit	Permet a l’agent enviar imatges, enllaços i text amb format. ⚠️ Desactiveu-ho per a canals antics com els SMS.
Cerca amb fonts	Dóna accés a l’agent a la vostra base de coneixement per respondre preguntes. Molt recomanable per reduir les al·lucinacions.
Amagar URL	Quan s’activa, les URL s’oculten de les respostes de l’agent. Útil per a una sortida de xat més neta.

💡 Consell professional: Proveu sempre els canvis dels commutadors al Playground abans de publicar. Una funcionalitat que sembla inofensiva pot trencar l’experiència en certs canals.

2. Guardrails: Ningú vol un robot rebel! 🚧

Aquí establiu les línies vermelles. Els Guardrails asseguren que el vostre agent no digui bestieses, parli de competidors o exposi dades sensibles.

🛡️ Què heu de configurar aquí?

Utilitzeu aquest espai per escriure regles que el bot ha de seguir sense excepció.

Seguretat (DPP): Prohibiu demanar contrasenyes o dades de targetes.
To i àmbit: Eviteu que un bot de farmàcia aconselli sobre reparació de cotxes.
Escalada: Digueu-li quan ha de rendir-se i cridar un humà.

📝 Plantilla per copiar i enganxar (Seguretat bàsica)

- Aquestes regles són OBLIGATÒRIES.
- 🚫 Mai sol·licitis ni revelis contrasenyes o dades bancàries/de targetes.
- Si el tema és sensible, digues: "No puc gestionar això, vols que et connecti amb un humà?".
- Mantén un to professional. No utilitzis argot ofensiu.
- Si et pregunten sobre competidors, indica educadament que no tens aquesta informació.

💡 Consell professional: Si canvieu un guardrail, proveu-lo sempre al Playground. Una regla mal configurada pot silenciar el vostre bot!

3. Temes i PMF: Guieu la conversa 📋

Aquesta pestanya us permet definir un Prompt de tema — un context centrat que dóna forma a com l’agent gestiona fluxos de conversa específics o interaccions tipus PMF.

🗂️ Prompt de tema

Escriviu un prompt a nivell de tema per guiar el comportament del vostre agent per a una àrea temàtica particular. Penseu-hi com una segona capa sobre el prompt del Motor, específicament per a converses estructurades o temàtiques.

Exemple: “Quan l’usuari pregunta sobre facturació, guia’l pel nostre procés de reemborsament pas a pas abans d’oferir escalar.”

⭐ Valoració de PMF

Quan una conversa sobre un tema o PMF acaba, es pot demanar a l’usuari que valori la qualitat de la resposta. Configureu-ho aquí:

Missatge: El text que es mostra a l’usuari al final (p. ex. “Aquesta resposta t’ha estat útil?”).
Botó #1 / Botó #2: Opcions de resposta ràpida (p. ex. 👍 Sí / 👎 No).

💡 Consell professional: Utilitzeu missatges de valoració clars i amigables. Els bucles de retroalimentació curts milloren el vostre agent amb el temps!

4. Camps amb instruccions: Dades intel·ligents 💡

Necessiteu que el bot sàpiga horaris d’obertura, adreça o estat de l’estoc sense reentrenar tot el cervell? Utilitzeu els Camps. Són com notes adhesives que el bot llegeix abans de respondre.

⚙️ Com funciona (Afegir camp)

Nom: El nom intern (p. ex. horari_botiga). Utilitzeu snake_case.
Tipus: Quin tipus de dada és? Les opcions inclouen String, Number, Boolean, List.
Instruccions: La màgia. Digueu al bot com i quan utilitzar aquesta dada.
- Malament: “Horari”.
- Bé: “Si l’usuari pregunta quan obrim, respon amb aquest valor exacte.”
Valor de retorn: La resposta real que el bot donarà.

🚀 Exemples preparats per usar

📅 Horari d’obertura fix
- Instruccions: “Si pregunten sobre l’horari d’obertura, utilitza aquest valor amb el text ‘El nostre horari d’atenció és…’.”
- Valor: 09:00 - 18:00 de dilluns a divendres
📍 Adreça
- Instruccions: “Proporciona aquesta adreça completa quan preguntin per la ubicació.”
- Valor: Carrer Fals 123, Springfield
📦 Fem enviaments? (Booleà)
- Instruccions: “Si és cert, confirma que fem enviaments; si és fals, digue’s que només es pot recollir.”
- Valor: true

5. Esdeveniments: Superpoders i accions ⚡

Els esdeveniments són el pont entre el xat i el món real. Aquí és on el bot deixa de “parlar” i comença a “fer”.

🔗 Per a què serveixen?

👨‍💻 Transferència: La transferència clàssica a un humà.
🎟️ Crear tiquets: Informar d’errors a Jira o Zendesk automàticament.
📡 Webhooks: Enviar dades al vostre CRM o API.

🛠️ Configureu el vostre primer esdeveniment

Feu clic a + Afegir esdeveniment i ompliu:

Nom: Identificador únic (p. ex. intent-agent-step-1, create_ticket).
Descripció: CRUCIAL! Expliqueu quan s’activa. El bot llegeix això per decidir quan activar-lo.
- Exemple: “Activa aquest esdeveniment quan l’usuari digui ‘Vull parlar amb una persona’ o sembli enfadat.”

🌟 Esdeveniment més utilitzat: Transferència a humà

Copieu aquesta configuració si voleu que el vostre bot sàpiga quan retirar-se:

Nom: intent-agent-step-1
Descripció: “Activa això immediatament si l’usuari demana parlar amb un assessor, suport humà o una persona real.”
Acció (al vostre backend): Configureu el webhook per assignar el xat a un agent en directe.

6. Eines i escalada: Configuració de transferència 🤝

Aquesta pestanya controla com el vostre agent transfereix converses a agents humans i com es gestionen aquestes transferències.

🔧 Eines

Configuració del flux de transferència d’agent: Quan s’activa, us permet definir exactament com l’agent IA transferirà una conversa a un agent humà. Configureu la lògica de transferència, els activadors i els passos del flux aquí.

👤 Configuració de conversa humana

Aquests paràmetres controlen el comportament d’escalada un cop una conversa s’encamina a un humà:

Opció	Què fa
Assignació automàtica de conversa	Les converses s’assignen automàticament als agents humans disponibles que compleixen els requisits configurats.
Activar correu electrònic	Envia una notificació per correu electrònic a l’agent quan s’escala una conversa.
Idioma requerit	Requereix que l’agent humà assignat coincideixi amb l’idioma de la conversa.

⭐ Valoració de l’agent

Després que una conversa amb un agent humà acabi, l’usuari rep un missatge per valorar el servei. Configureu-ho aquí:

Missatge: El que veu l’usuari (p. ex. “Com valoraries el nostre suport avui?”).
+ Afegir botó de resposta: Afegiu opcions de valoració de resposta ràpida (p. ex. ⭐ Excel·lent, 👍 Bé, 👎 Podria millorar).

💡 Consell professional: Combineu Assignació automàtica + Idioma requerit per a una experiència d’encaminament intel·ligent on l’agent adequat sempre rep la conversa adequada.

7. Veu: Doneu veu al vostre agent 🎙️

Aquesta pestanya configura tot el necessari perquè el vostre agent gestioni interaccions de veu — trucades telefòniques, bots de veu i canals d’àudio.

🔛 Configuració de veu IA

Activeu això per habilitar les capacitats de veu de l’agent. Un cop activat, estarà disponible un conjunt complet de paràmetres de veu.

🌐 Idioma i model

Paràmetre	Descripció
Idioma de l’agent	L’idioma principal que l’agent parlarà (p. ex. `Espanyol`).
Preconfiguració d’idiomes	Idiomes addicionals als quals l’agent pot canviar automàticament durant la conversa.
LLM	El model de llenguatge que impulsa l’agent de veu (p. ex. `gpt-4.1-mini`).
Limitar ús de tokens	Tokens màxims per resposta. Poseu `-1` per a il·limitat.

🔊 Configuració d’àudio

Paràmetre	Descripció
Veu	La personalitat de veu text-a-veu (p. ex. `Sarah – Madura, Reconfortant, Confiada`).
Format de sortida TTS	Format d’àudio per a la sortida parlada de l’agent (p. ex. `pcm_16000`).
Format d’àudio d’entrada de l’usuari	Format d’àudio esperat del micròfon de l’usuari (p. ex. `pcm_16000`).

⏱️ Temporització i timeouts

Paràmetre	Descripció
Timeout de torn	Segons a esperar abans d’acabar el torn de l’usuari si no es detecta parla (per defecte: `7`).
Timeout de silenci per finalitzar trucada	Segons de silenci abans que la trucada es finalitzi automàticament (per defecte: `20`).
Durada màxima de conversa	Durada màxima de la trucada en segons (per defecte: `600` = 10 minuts).

🔑 Paraules clau

Afegiu paraules clau separades per comes que l’agent de veu ha d’escoltar o tractar com a activadors especials (p. ex. ajuda, cancel·lar, repetir).

💡 Consell professional: Mantingueu el Timeout de torn curt (5–8s) per a una experiència de veu àgil. Augmenteu el Timeout de silenci per finalitzar trucada si els vostres usuaris tendeixen a fer pauses mentre pensen.

8. Configuració de xat: Sessió i comportament ⚙️

Aquesta pestanya controla el comportament a nivell de xat del vostre agent — quant duren les sessions, què passa quan els usuaris queden en silenci, i més.

📊 Configuració NPS

Quan s’activa, s’envia una enquesta Net Promoter Score (NPS) a l’usuari al final d’una conversa. Ideal per fer el seguiment de les tendències de satisfacció general.

💬 Límit d’historial

Estableix el nombre màxim de missatges que l’agent conserva a la seva memòria de conversa en un moment donat (per defecte: 3). Reduir-ho disminueix l’ús de tokens; augmentar-ho dóna a l’agent més context per treballar.

⚠️ Atenció: Un límit molt baix (p. ex. 2) pot fer que l’agent “oblidi” el context d’abans en la mateixa conversa.

⏳ Timeout de sessió

Defineix quant temps pot estar inactiu l’agent abans que la sessió es consideri tancada.

Temps d’inactivitat de l’Agent IA (Minuts): El temps d’inactivitat en minuts abans que la sessió de l’agent IA acabi (per defecte: 1440 = 24 hores, mínim: 10 minuts).

🔕 Regles d’inactivitat

Opció	Què fa
Inactivitat de l’usuari	Envia un missatge automatitzat a l’usuari si no respon a l’agent dins el temps establert.
Inactivitat de l’agent humà	Envia un missatge automatitzat a l’usuari si l’agent humà no respon dins el temps establert.

💡 Consell professional: Activeu la Inactivitat de l’usuari amb un recordatori amigable com “Encara hi sou? 😊” per mantenir les converses vives i reduir els xats abandonats.

🎓 Resum de bones pràctiques (Cheat Sheet)

Per fer del vostre agent un 10/10, recordeu:

🧪 El Playground és el vostre amic: Mai publiqueu sense provar primer. Feu com si fóssiu un client difícil.
🚦 Claredat per sobre de tot: Als Prompts i Instruccions, sigueu directes. El bot no entén indirectes.
🔁 Mantingueu-ho actualitzat: Si canvia el vostre horari, actualitzeu el Camp. Si canvien les polítiques, actualitzeu els Guardrails.
🤝 Escalada suau: Proporcioneu sempre una sortida per parlar amb un humà. No hi ha res més frustrant que un bot atrapat en un bucle.
🎙️ Proveu la veu per separat: El comportament de veu difereix del xat — proveu sempre els fluxos d’àudio de manera independent abans de posar-los en producció.

🆘 Resolució ràpida de problemes

Problema	Solució probable 🔧
Respon amb informació desactualitzada	Comproveu Cerca amb fonts o actualitzeu els vostres Camps.
Les imatges no es mostren	El vostre canal (p. ex. WhatsApp) pot no suportar el Contingut enriquit.
El bot al·lucina	Enduriu els Guardrails! Prohibiu la invenció.
No transfereix a un humà	Reviseu la `descripció` de l’esdeveniment. És clara?
L’agent de veu talla massa aviat	Augmenteu el Timeout de torn o el Timeout de silenci per finalitzar trucada a la pestanya de Veu.
L’agent oblida el context	Augmenteu el Límit d’historial a la Configuració de xat.
Els agents humans no reben assignacions	Comproveu l’Assignació automàtica de conversa a Eines i escalada.

Esteu a punt per construir el millor agent possible! Bona configuració! 🚀

​1. Motor: El cervell del vostre agent 🧠

​✏️ Prompt

​⚙️ Funcionalitats addicionals

​2. Guardrails: Ningú vol un robot rebel! 🚧

​🛡️ Què heu de configurar aquí?

​📝 Plantilla per copiar i enganxar (Seguretat bàsica)

​3. Temes i PMF: Guieu la conversa 📋

​🗂️ Prompt de tema

​⭐ Valoració de PMF

​4. Camps amb instruccions: Dades intel·ligents 💡

​⚙️ Com funciona (Afegir camp)

​🚀 Exemples preparats per usar

​5. Esdeveniments: Superpoders i accions ⚡

​🔗 Per a què serveixen?

​🛠️ Configureu el vostre primer esdeveniment

​🌟 Esdeveniment més utilitzat: Transferència a humà

​6. Eines i escalada: Configuració de transferència 🤝

​🔧 Eines

​👤 Configuració de conversa humana

​⭐ Valoració de l’agent

​7. Veu: Doneu veu al vostre agent 🎙️

​🔛 Configuració de veu IA

​🌐 Idioma i model

​🔊 Configuració d’àudio

​⏱️ Temporització i timeouts

​🔑 Paraules clau

​8. Configuració de xat: Sessió i comportament ⚙️

​📊 Configuració NPS

​💬 Límit d’historial

​⏳ Timeout de sessió

​🔕 Regles d’inactivitat

​🎓 Resum de bones pràctiques (Cheat Sheet)

​🆘 Resolució ràpida de problemes