Per al desenvolupament d’aquest xatbot adaptat al nostre WordPress, hem decidit organitzar l’entorn de treball utilitzant GitHub com a eix central, per no haver de crear un repositori nou, he aprofitat el del Xatbot del Repte anterior, l’he duplicat i fet alguns canvis per adaptar-lo a aquest repte, com per exemple he canviat el nom de l’arxiu del mateix Xatbot a “XatBot_talent_2026.ipynb” i el del Widget a “Widget_talent.html”.
A més, he vinculat Google Colab amb el repositori de GitHub. Això em permet una sincronització directa i neta: qualsevol millora en la intel·ligència del bot es guarda automàticament a la ‘versió oficial’, evitant pèrdues d’informació i facilitant el treball col·laboratiu en temps real.
Primer de tot he duplicat el repositori del Xatbot de la LAN Party per aprofitar els arxius.
Una vegada dintre del repositori he fet clic a “Fork”, aquesta opció crea una còpia del repositori.
Una vegada duplicat el repositori he canviat el nom dels següents arxius:
- XatBot2026.ipynb —> XatBot_talent_2026.ipynb
- Widget.html —> Widget_talent.html
Com ho he fet?
Fent clic a l’arxiu, a la dreta es veu una icona amb forma de llapis, fent clic podrem editar tant el nom com el codi.
Aquest era el nom abans del canvi
Aqui una vegada canviat
I s’hauria de fer el mateix amb l’arxiu del Widget.
Al no tenir una evidència de la connexió de Google Colab amb Github he inserit aquesta captura on es pot veure que s’està guardant el nou nom “Commit changes”, això el que fa és que tots els canvis que es fan al GutHub es guarden al Colab i viceversa.
Actualització de README, CHANGELOG i CONTRIBUTING
Com previement he duplicat el directori del Repte anterior, els arxius ja estan creats, només he hagut d’edirat-los.
README
## 🤖 Projecte Xatbot - TalentFP (Adaptació del Repte 1.4)
### Aquest repositori conté l'evolució i adaptació del xatbot d'intel·ligència artificial desenvolupat originalment per a la LAN Party, ara transformat en un assistent virtual per al projecte TalentFP. L'objectiu és oferir suport interactiu als usuaris que visiten el nostre lloc web en WordPress.
##🛠️ Entorn de Treball i Traçabilitat
### Per a aquest repte, hem optimitzat el nostre flux de treball per garantir la qualitat del programari i la col·laboració eficient:
Google Colab: Desenvolupament del motor de la IA en Python.
GitHub (OAuth): Connexió directa amb Colab per mantenir la traçabilitat dels canvis i el control de versions
Gemini API: Utilització del model de llenguatge per a la lògica de l'assistent.
WordPress Integration: Implementació del xatbot mitjançant un widget personalitzat
## 📂 Estructura del Repositori (Nomenclatura Rúbrica)
### Seguint els requeriments de la rúbrica del Repte 1.4, els fitxers principals són:
XatBot_talent_2026.ipynb: Quadern de Google Colab amb la lògica de la IA.
Widget_talent.html: Codi de l'interfície per a la integració al WordPress.
README.md: Documentació general (aquest fitxer).
## 👥 Membres de l'Equip
[Pau Jiménez Presas]
## 🚀 Adaptació al nou context
### A diferència de la versió anterior (LAN Party), aquest xatbot ha estat reconfigurat per:
Context TalentFP: Resoldre dubtes sobre la fira de talent, les empreses participants i el funcionament dels reptes.
Seguretat: Gestió estricta de l'API Key mitjançant variables d'entorn (userdAta) per evitar filtracions.
Interactivitat: Disseny d'un widget més net per a una navegació fluida dins del WordPress.
## 🔗 Documentació Completa
### Podeu trobar tota la justificació del projecte, les captures de pantalla de la configuració de l'entorn i el diari de treball al nostre portafolis oficial:
👉 https://pjimenez.inscastellbisbal.net
CHANGELOG
# Changelog - Projecte Xatbot TalentFP
Totes les modificacions rellevants d'aquest projecte s'anotaran aquí.
## [1.0.0] - 2026-03-18
### Afegit
- Creació del repositori mitjançant un Fork del projecte anterior.
- Adaptació dels noms dels fitxers a la normativa del Repte 1.4.
- Connexió via OAuth amb Google Colab per a la traçabilitat.
- Configuració de seguretat per a l'API Key de Gemini.CONTRIBUTING
# Guia de Contribució
Per mantenir la qualitat del programari en aquest equip, seguim aquestes normes:
1. Tota modificació del codi s'ha de fer des de Google Colab i guardar-se a GitHub via OAuth.
2. Els missatges de "Commit" han de ser descriptius.
3. No es pot escriure l'API Key directament al codi; cal usar els Secrets de Colab.
Deixa un comentari