Documentation Index
Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt
Use this file to discover all available pages before exploring further.
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.
- 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.
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. |
