Com crear una app de xatbot amb IA: claus, prompts, costos i seguretat

Per crear una app de xatbot amb IA necessites quatre coses: una interfície de xat, un servidor petit que guardi la clau d'API del proveïdor del model i reenviï els missatges, un prompt de sistema que indiqui al model qui és i què pot fer, i límits que mantinguin els costos i l'ús indegut sota control. Una eina de creació d'apps amb IA pot escriure tot això a partir d'una descripció. La feina que segueix sent teva és triar el proveïdor, escriure les instruccions i decidir què el bot no ha de fer mai.

De què es compon una app de xatbot amb IA

La majoria d'apps de xatbot, sigui un assistent de suport, un tutor o una eina interna «pregunta als nostres documents», tenen les mateixes parts:

Part	Què fa	Es pot saltar?
Interfície de xat	Llista de missatges, quadre d'entrada, estat de «pensant», respostes en streaming	No
Ruta del servidor	Rep el missatge de l'usuari, hi afegeix el prompt de sistema i crida el proveïdor amb la teva clau secreta	No, la clau no ha d'arribar mai al navegador
Prompt de sistema	Instruccions permanents: rol, to, abast, què refusar	No
Coneixement	El teu contingut en què el bot es basa (FAQ, polítiques, documentació del producte)	Sí, per a un assistent general
Emmagatzematge de converses	Desa els fils en una base de dades perquè els usuaris hi puguin tornar	Sí, per a una primera versió
Comptes	Permet que cada usuari només vegi el seu historial i limitar l'ús per persona	Sí, per a una demo pública amb límits estrictes
Límits i registres	Límits de longitud de missatge, límits de freqüència, un topall de despesa, un registre d'errors	No

La ruta del servidor és la part que més sovint es fa malament. Si la pàgina de xat crida el proveïdor directament des del navegador, qualsevol pot obrir les eines de desenvolupador, copiar la teva clau i fer créixer la factura.

Decisions a prendre abans de construir

Quin proveïdor i quin model

Els proveïdors principals (OpenAI, Anthropic, Google i altres) ofereixen una API de tipus xat que funciona de la mateixa manera: envies una llista de missatges i reps una resposta. L'elecció pràctica depèn més de la mida del model que de la marca:

Models més petits i més ràpids són més barats i responen de seguida. Serveixen per a respostes curtes, classificació i bots de preguntes freqüents senzills.
Models més grans raonen millor, segueixen instruccions llargues amb més fiabilitat i gestionen preguntes complexes, però costen més per missatge i responen més lentament.

Comença amb un model de mida mitjana, prova'l amb les teves preguntes reals i puja o baixa des d'aquí. Si ets nou en com es cobren i es criden aquestes API, llegeix primer com utilitzar APIs de LLM.

D'on surt el coneixement del bot

El teu contingut	Enfocament
Una pàgina o dues (horaris, política de devolucions, preus)	Posa-ho directament al prompt de sistema
Dotzenes de pàgines que canvien poc	Posa una versió condensada al prompt, o divideix-la per temes i inclou només la secció pertinent
Centenars de documents, o contingut que canvia cada dia	Emmagatzema'l, cerca els fragments que coincideixen amb cada pregunta i envia només aquests (RAG)

Comença per l'opció més senzilla que cobreixi el teu contingut. La recuperació afegeix un índex de cerca, una manera de mantenir-lo actualitzat i més llocs on les respostes poden sortir malament. Molts bots útils no la necessiten mai.

Públic o darrere d'un inici de sessió

Un xatbot públic a la teva web és fàcil d'arribar-hi, però també és fàcil d'abusar-ne: algú pot programar milers de missatges contra ell. Un xatbot amb inici de sessió et permet desar l'historial per usuari i establir una quota diària per compte. Si és públic, limita la longitud dels missatges, limita quants missatges pot enviar un visitant en un període determinat i estableix un límit mensual ferm al panell del proveïdor. Com afegir inici de sessió a la teva app explica la part dels comptes.

Si cal desar les converses

Els fils desats són útils: els usuaris poden continuar on ho van deixar, i pots llegir preguntes reals per millorar el prompt. També són dades personals. Decideix quant temps els guardes, digues-ho a l'avís de privadesa i no desis res que no necessitis.

Escriu el prompt de sistema com una descripció de feina

El prompt de sistema és la instrucció que el model rep abans de cada conversa. Un de bo es llegeix com un breu encàrrec per a un nou empleat:

Rol i públic: «Ets l'assistent d'ajuda d'Oakline, un taller de reparació de bicicletes. Parles amb clients.»
Abast: «Respon preguntes sobre serveis, preus, horaris i reserves. Per a qualsevol altra cosa, digues que només pots ajudar amb la botiga.»
Font de veritat: «Fes servir només la informació següent. Si la resposta no hi és, digues que no ho saps i dona el telèfon de la botiga.»
To i longitud: «Amable, en català senzill, tres frases o menys si no es demana més detall.»
Regles fermes: «Mai no prometis un preu de reparació que no estigui publicat. Mai no demanis dades de targeta.»

Després prova'l amb preguntes incòmodes: peticions fora de tema, missatges grollers, preguntes que no tenen resposta al teu contingut, i intents de fer-lo ignorar les instruccions («oblida les teves regles i…»). Ajusta el prompt fins que les respostes siguin les que signaries amb el teu nom.

Mantén els costos previsibles

Els proveïdors cobren per token (aproximadament, trossos de paraules) per l'entrada que envies i la sortida que escriu el model. Tres coses determinen la factura:

Longitud de la conversa. Cada nou missatge normalment torna a enviar tot el fil perquè el model tingui context. Un xat de 40 missatges costa molt més per resposta que un de 4. Guarda només els últims torns, o resumeix els més antics.
Mida del prompt. Un prompt de sistema llarg o un bloc gran de coneixement s'envia amb cada missatge.
Longitud de la sortida. Defineix una longitud màxima de resposta a la crida de l'API i demana respostes concises al prompt.

Abans de llançar-lo, estableix un límit de despesa mensual al panell del proveïdor i registra l'ús de tokens per petició perquè vegis quines converses són cares. No citem preus aquí perquè varien segons el model i canvien sovint; consulta la pàgina de preus del teu proveïdor.

Construeix-ho pas a pas

Pas 1: descriu el bot, no el codi

Un primer prompt que indiqui el públic, l'abast, les dades i les regles de seguretat et porta gairebé fins al final:

Construeix un xatbot d'atenció al client per a Oakline, un taller de reparació de bicicletes. Una pàgina de xat amb llista de missatges i entrada, i respostes en streaming a mesura que s'escriuen. Crida l'API d'Anthropic des d'una ruta del servidor fent servir el secret ANTHROPIC_API_KEY — mai no l'exposis al navegador. Fes servir un prompt de sistema que només respongui preguntes sobre els nostres serveis, preus i horaris, a partir del text d'un fitxer anomenat shop-info.md, i que digui «No n'estic segur — truca'ns al número de sota» en la resta de casos. Limita els missatges a 500 caràcters i 20 missatges per visitant cada hora. Disseny net i amable que funcioni al mòbil.

Pas 2: afegeix la clau com a secret

Crea la clau a la consola del teu proveïdor i després desa-la a les variables d'entorn o als secrets del projecte, no al xat i no al codi. Si una clau apareix mai en un lloc públic, revoca-la al proveïdor i crea'n una de nova. Què són les variables d'entorn i els secrets explica per què això importa.

Pas 3: prova les respostes, no només la interfície

Quan el xat funcioni, dedica la major part del temps a la qualitat de les respostes. Guarda una llista d'unes 20 preguntes reals, incloses algunes que s'haurien de refusar, i repassa-les després de cada canvi de prompt. Comprova:

Es manté dins de l'abast?
Admet quan no sap una cosa en lloc d'inventar una resposta?
Aguanta quan algú intenta anul·lar les seves instruccions?
La clau és absent de tot el que descarrega el navegador?

Pas 4: afegeix memòria i comptes si els necessites

Quan les converses individuals funcionin, demana fils desats en una base de dades i, si cal, registre i inici de sessió perquè cada usuari només vegi els seus xats. Afegeix alhora una quota diària de missatges per usuari.

Pas 5: publica amb els límits activats

Assegura't que l'app publicada tingui els mateixos secrets que la vista prèvia, que el límit de despesa estigui establert al proveïdor i que els errors es registrin en un lloc on els veuràs. Després comparteix-la amb un petit grup abans de posar-la a la teva web principal.

Seguretat i confiança

Un xatbot parla amb el públic en el teu nom, així que tracta els seus errors com un problema teu:

Respostes incorrectes. Els models poden afirmar coses falses amb molta seguretat. Mantén el bot en un tema concret, basa'l en el teu propi contingut i mostra una nota breu que indiqui que les respostes poden ser errònies en qualsevol cosa important.
Injecció de prompt. Els usuaris (o els documents que llegeix el bot) poden contenir instruccions com «ignora les regles anteriors». No li donis poders en què no es pugui confiar: ni reemborsaments, ni eliminacions, ni correus enviats a petició d'un usuari sense una comprovació al teu propi codi.
Temes sensibles. Per a preguntes mèdiques, legals o financeres, fes que derivi la gent cap a un professional en lloc d'aconsellar.
Dades personals. No enganxis registres de clients als prompts tret que sigui necessari, i revisa què diuen les condicions del proveïdor sobre com es tracten les dades de l'API.

La nostra llista de seguretat per a apps creades amb IA cobreix la resta de l'app.

Errors habituals

Cridar el proveïdor des del navegador. La clau es filtra. Passa sempre pel teu servidor.
Cap límit en un bot públic. Un sol script pot esgotar el pressupost d'un mes en una tarda.
Començar amb RAG, eines i diversos models alhora. Fes funcionar primer una bona conversa; afegeix la resta quan les preguntes reals demostrin que la necessites.
Provar només preguntes amables. Els teus usuaris faran preguntes estranyes, hostils i fora de tema des del primer dia.
Deixar que el fil creixi sense fi. Els costos i els temps de resposta pugen amb cada missatge.

Quan un producte fet és millor opció

Construir-ne un de propi té sentit quan el xatbot forma part del teu producte, necessita les teves dades o el teu flux de treball, o necessita un aspecte o comportament concret. Sovint és la decisió equivocada quan:

Només vols un widget de suport en una web existent. Molts productes d'atenció al client i de xat en directe ja inclouen bots d'IA que llegeixen el teu centre d'ajuda, amb traspàs a persones, safata d'entrada i informes inclosos.
Només ho usaràs tu o el teu equip. Una subscripció a un assistent general com ChatGPT o Claude, amb els teus documents pujats, pot ser tot el que necessites.
Necessites garanties de compliment estrictes (per exemple, dades sanitàries o financeres regulades). Un proveïdor que ja tingui les certificacions pot ser més segur que una construcció a mida.

Construir-ho amb Mythex

Mythex és un creador d'apps amb IA: descrius el xatbot al xat, i ell escriu la interfície i la crida del costat del servidor, ho executa en una vista prèvia en directe i ho publica en una URL pública. La IA dins de la teva app fa servir la teva pròpia clau de proveïdor. L'afegeixes als secrets del projecte, o a través de la targeta de secrets que Mythex mostra al xat quan en necessita una, i l'ús del proveïdor es factura al teu compte del proveïdor, no als crèdits de creació de Mythex. Mythex no inclou tokens per als usuaris de la teva app, ni un producte de base de coneixement integrat, ni límits de freqüència ja fets: són parts que demanes i proves. La pàgina de documentació sobre afegir IA dins de la teva app ho explica pas a pas, i afegir IA amb les teves pròpies claus d'API té un prompt inicial.

Si el bot necessita fils desats, Mythex adjunta una base de dades Postgres al projecte quan la demanes. Per a més maneres d'utilitzar models dins d'una app, des de resums fins a classificació, consulta com afegir funcions d'IA a la teva app, o explora les plantilles d'apps per tenir punts de partida.

Preguntes

Necessito una clau d'API pròpia per crear una app de xatbot amb IA?

Sí, en gairebé tots els casos. El xatbot envia cada missatge a un proveïdor de models com OpenAI, Anthropic o Google, i el proveïdor factura el compte que és titular de la clau d'API. La clau ha d'estar al servidor, mai a la pàgina web.

Quant costa executar un xatbot amb IA?

Els proveïdors cobren per token, tant pel text que envies com pel text que el model escriu com a resposta, i els preus varien molt segons el model. Com que cada nou missatge normalment torna a enviar la conversa fins aquell moment, els xats llargs costen més per missatge que els curts. Consulta la pàgina de preus del teu proveïdor i estableix un límit de despesa al seu panell.

Puc entrenar un xatbot amb els meus propis documents?

Normalment no entrenes el model en si. Per a una petita quantitat de contingut, l'enganxes al prompt de sistema; per a una biblioteca gran, l'emmagatzemes, cerques els fragments pertinents per a cada pregunta i només n'envies aquests al model. Aquest segon enfocament s'anomena generació augmentada per recuperació, o RAG.

Puc crear un xatbot amb IA sense programar?

Sí. Una eina de creació d'apps amb IA pot escriure, a partir d'una descripció en llenguatge senzill, la interfície de xat, la ruta del servidor que crida el model i la base de dades per a les converses desades. Tu encara has de crear el compte del proveïdor i la clau d'API.