> ## 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. # Configuració de l'agent > Configureu la identitat, personalitat i regles del vostre agent IA Edit Agent Module ## 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ó. 1. **Seguretat (DPP):** Prohibiu demanar contrasenyes o dades de targetes. 2. **To i àmbit:** Eviteu que un bot de farmàcia aconselli sobre reparació de cotxes. 3. **Escalada:** Digueu-li quan ha de rendir-se i cridar un humà. ### 📝 Plantilla per copiar i enganxar (Seguretat bàsica) ```markdown theme={null} - 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) 1. **Nom:** El nom intern (p. ex. `horari_botiga`). Utilitzeu `snake_case`. 2. **Tipus:** Quin tipus de dada és? Les opcions inclouen `String`, `Number`, `Boolean`, `List`. 3. **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." 4. **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: 1. **Nom:** Identificador únic (p. ex. `intent-agent-step-1`, `create_ticket`). 2. **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ó! 🚀