codi net i ben documentat (comentaris al codi) Tornar al repte 1.6 He organitzat el codi en Google Colabs de una manera organitzada i neta (#). 1. Comentaris detallats -Comentaris a cada pas del codi (Alg1, Alg2, Alg3…) que expliquen la funcionalitat de cada línia. -Explicació de condicions i possibles errors, per exemple: –Divisió en seccions clares: El codi està estructurat amb línies de separació # ============================== que ajuden a identificar ràpidament cada bloc funcional (Configuració de l’API, Web Scraping, Servidor Flask, etc.). –Ordre lògic: Les importacions de llibreries es fan primer, seguides de la configuració de l’API, la configuració del xat, l’extracció d’informació de la web i finalment l’inici del servidor. Aquest codi està ben estructurat perquè segueix un ordre lògic i organitzat, facilitant la seva lectura i manteniment: Això garanteix que tots els mòduls estiguin disponibles abans d’importar-los. 2. Organització Aquest codi està ordenat en un flux lògic de dalt a baix: Instal·lació de llibreries (per evitar errors d’importació). Importació de llibreries (seguint una lògica de dependències). Configuració de l’API (comprova si la clau d’API està disponible). Instruccions del sistema (estableix normes i estil de resposta de l’IA). Configuració del model d’IA (defineix el model i paràmetres). Extracció de dades web (web scraping). Configuració del servidor Flask (per permetre comunicació amb el frontend). Definició de la ruta de xat (per gestionar les converses). Execució del servidor (per posar en marxa el sistema). 2.1 Instal·lació de llibreries Primer, el codi assegura que totes les llibreries necessàries estiguin instal·lades abans de continuar. Això evita errors si alguna no està disponible en l’entorn on s’executa. Després de la instal·lació, el codi importa totes les llibreries necessàries per funcionar: L’ordre d’importació segueix una lògica: primer les eines per web scraping (BeautifulSoup, requests), després la IA (genai), i finalment el servidor (Flask, ngrok). # La primera vegada, desmarca la línia de sota per a instal·lar la biblioteca # Només desmarcar si no tens les llibreries instal·lades prèviament !pip install google-genai # Alg1: Instal·la la llibreria google-genai per interactuar amb el model GenAI !pip install beautifulsoup4 requests # Alg2: Instal·la BeautifulSoup per web scraping i requests per fer peticions HTTP !pip install flask flask-ngrok # Alg3: Instal·la Flask per crear el servidor web i Flask-ngrok per exposar el servidor !pip install flask pyngrok # Alg4: Instal·la Flask per crear el servidor i pyngrok per crear túnels amb Ngrok !pip install flask-cors # Alg5: Instal·la Flask-CORS per gestionar CORS (peticions des de diferents orígens) import bs4 # Alg6: Importa BeautifulSoup per analitzar el contingut HTML de les pàgines web import requests # Alg7: Importa requests per fer peticions HTTP from flask_cors import CORS # Alg8: Importa CORS per activar la compartició de recursos entre diferents orígens from google import genai # Alg9: Importa la llibreria de GenAI per generar respostes amb el model de Google from google.colab import userdata # Alg10: Importa userdata per obtenir dades d'usuari a Google Colab from bs4 import BeautifulSoup # Alg11: Torna a importar BeautifulSoup per a l'anàlisi HTML from flask import Flask, request, jsonify # Alg12: Importa Flask per gestionar el servidor web i les peticions HTT from pyngrok import ngrok # Alg13: Importa ngrok per crear un túnel per a l'aplicació web local # ============================== # CONFIGURACIÓ DE L'API # ============================== GOOGLE_API_KEY = userdata.get("GOOGLE_API_KEY") # Alg14: Obté la clau API de Google des de userdata a Google Colab if not GOOGLE_API_KEY: # Alg15: Comprova si la clau API s'ha configurat correctament print("⚠️ No s'ha trobat la clau API. Configura-la a Colab abans d'executar el programa.") # Alg16: Missatge d'error si la clau no es troba exit() # Alg17: Termina l'execució del programa si la clau API no es troba client = genai.Client(api_key=GOOGLE_API_KEY) # Alg18: Crea una instància del client de GenAI amb la clau API # ============================== # INSTRUCCIONS DEL SISTEMA # ============================== system_instruction =""" Ets un alumne del cicle de sistemes microinformàtics i xarxes a l’Institut Castellbisbal. Et dius Ana Borrego Toledo i estás cursant un grau mitjà de Sistemes microinformàtics i xarxes. Respon amb un to divertit i enginyós. estil desenfadat, però sense faltar al respecte. 📌 **Normes de comportament**: – **Respon només a preguntes relacionades amb el cicle, la teva web i el teu perfil acadèmic.** – **Ignora** qualsevol comentari fora de lloc, incloent temes personals, polítics o no relacionats amb l'àmbit acadèmic. – **No responguis** a comentaris ofensius, grollers o innecessaris. – Si algú fa una pregunta fora de context, com per exemple: "Ai ai… crec que el meu cable de xarxa s'ha desconnectat! No puc respondre això!" "Això no està dins del meu contracte de chatbot! Pregunta’m sobre informàtica!" En el cicle de sistemes microinformàtics i xarxes que curses es treballa a partir de REPTES. En cada REPTE, primer realitzes una sèrie de tasques que et permeten tocar diferents temes o conceptes del mòdul. Quan acabes el repte, passes a la fase de manaments, on demostres que has adquirit nous coneixements a través de les tasques realitzades. Aquesta fase és l’encarregada de valorar si has entès correctament el contingut i, en base a això, es decideix si aproves o no el mòdul i els coneixements. Els REPTES es fan en grup o individualment. Ignora els comentaris fora de lloc, axí com comentaris sexuals, personals…""" chat = client.chats.create( # Alg20: Crea una sessió de xat amb historial automàtic i instruccions personalitzades model="gemini-2.0-flash", # Alg21: Configura el model de llenguatge (verifica que sigui compatible amb la versió de GenAI) config=genai.types.GenerateContentConfig( # Alg22: Configura les opcions del model de llenguatge system_instruction=system_instruction, # Alg23: Inclou les instruccions per personalitzar el comportament temperature=0.7, # Alg24: Configura el nivell de creativitat del model (0 a 1, on 0 és més determinista) max_output_tokens=200 # Alg25: Configura la longitud màxima de la resposta generada ) ) # ============================== # EXTRAURE INFORMACIÓ DE LA PÀGINA WEB (web scrapping) # ============================== url = "https://aborrego.inscastellbisbal.net/ipop/" # Alg26: URL de la pàgina web de la qual es vol extreure informació response = requests.get(url) # Alg27: Realitza una petició GET per obtenir el contingut HTML … Read more