Biblioteca
Eco-Digital
Assistent virtual intel·ligent per a l’entorn sostenible de Can Font. Projecte de grup de SMX.
📌 Rol de la IA com a Copilot
L’equip ha reflexionat críticament sobre el paper de la IA com a copilot per a programar, documentar i comentar el codi. La IA no substitueix el pensament crític: l’equip ha integrat cada suggeriment de forma raonada, entenent cada línia generada i adaptant-la al projecte real.
📂 Documentació com a Eina Professional
La documentació del repositori (CHANGELOG, README, CONTRIBUTING) s’ha concebut com una eina de comunicació professional essencial per a l’escalabilitat, la traçabilitat i el manteniment del projecte a llarg termini — no com un tràmit acadèmic obligatori.
🌿 Compromís Ambiental i Sostenibilitat Digital
El projecte s’emmarca en un entorn 100% digital seguint el criteri de residu zero. L’ús de la IA s’ha guiat per principis d’eficiència: reduir errors, millorar la qualitat del codi i documentar de forma precisa sense malbaratar recursos.
El codi següent ha estat generat, revisat i refinat iterativament amb l’ajuda de la IA. Cada línia és compresa i justificada per l’equip.
# ═══════════════════════════════════════════════════════════════ # [ÚS DE LA IA] CONFIGURACIÓ DE SEGURETAT I GESTIÓ DE SECRETS # L'equip ha implementat bones pràctiques per evitar exposar API Keys # ═══════════════════════════════════════════════════════════════ import os from google import genai from google.genai import types from google.colab import userdata try: api_key = userdata.get("GOOGLE_API_KEY") client = genai.Client(api_key=api_key) except Exception as e: print(f"Error en la configuració de seguretat: {e}") # ═══════════════════════════════════════════════════════════════ # [ÚS DE LA IA] PREVENCIÓ D'AL·LUCINACIONS — CONTEXT CRÍTIC # System Instructions tancades amb dades reals de la instal·lació # ═══════════════════════════════════════════════════════════════ system_instruction = """ Ets l'Assistent Virtual Oficial de la Biblioteca Eco-Digital. Dades CRÍTIQUES: 1. Ubicació: Edifici Can Font, Planta 1 2. Horari: Dl-Dv 09:00–20:00h · Ds 10:00–14:00h 3. Normativa: Espai 100% digital. Prohibit imprimir en paper. 4. Xarxa: Wi-Fi lliure amb DHCP automàtic. """ config = types.GenerateContentConfig( system_instruction=system_instruction, temperature=0.7, max_output_tokens=700 ) chat = client.chats.create(model="gemini-2.5-flash", config=config) print("=== SESSÓ INICIADA: BIBLIOTECA ECO-DIGITAL ===") # Bucle interactiu amb filtres nets recomanats pel copilot while True: user_input = input("Iman: ").strip() if user_input.lower() == "sortir": break if not user_input: continue try: response = chat.send_message(user_input) print(f"Assistent: {response.text}\n") except Exception as e: print(f"Error: {e}\n")
Escriu ‘sortir’ per finalitzar la consulta.
Com puc assistir-te avui en el teu viatge cap al coneixement, d’una manera sostenible i eficient?
🗓 Dilluns a Divendres: 09:00h – 20:00h
📅 Dissabtes: 10:00h – 14:00h
Estem ubicats a l’Edifici Can Font, Planta 1. Recordeu que disposem de Wi-Fi lliure amb DHCP automàtic!
🤖 Característiques Tècniques del Diàleg
- Context persistent: El model manté el fil de la conversa gràcies a
client.chats.create() - Dades tancades: Les respostes sobre horaris i normativa provenen exclusivament de les System Instructions
- Filtre d’entrada:
.strip()evita errors per caràcters buits accidentals - Gestió d’errors: Bloc try/except preveu fallades de xarxa o de quota de l’API
google-genai.feat: fix: docs: