Interaktívny chatbot podpory: Pokročilý príklad s Google GenAI
Krok za krokom vývoj korporátneho technického podporného chatbotu so stavom, streamovaním tokenov a robustným spracovaním výnimiek pre Portelcore.
1. Architektúra konverzačného chatbotu so stavom
Sección titulada «1. Arquitectura de un Chatbot Conversacional con Estado»Vytvorenie interaktívneho rozhrania technickej podpory (napr. portel_support_bot) vyžaduje bezchybnú správu histórie konverzácie. Na rozdiel od žiadostí o jeden zákrut, produkčný chatbot musí pamätať predchádzajúci kontext zaslaný zákazníkom.
Nový zjednotený SDK Python google-genai ponúka abstraktné rozhranie client.chats, ktoré automatizuje pretrvávanie stavu na strane servera a optimalizuje konverzačný tok.
sequenceDiagram autonumber actor Usuario as Cliente Portelcore participant App as Aplicación Python participant Gemini as API de Gemini (2.5 Flash)
Usuario->>App: Escribe "Hola, mi red local tiene problemas" App->>Gemini: chat.send_message_stream("Hola...") Gemini-->>App: Envía tokens en tiempo real (Streaming) App-->>Usuario: Muestra texto de forma progresiva Note over App,Gemini: El SDK actualiza el historial internamente Usuario->>App: Escribe "¿Qué IP estática debo usar?" App->>Gemini: chat.send_message_stream("¿Qué IP...?") Note over Gemini: Recuerda el contexto anterior del usuario Gemini-->>App: Envía respuesta asistida en tiempo real App-->>Usuario: Muestra solución técnica (IP 172.22.40.231)2. Kompletná implementácia: portel_support_bot.py
Sección titulada «2. Implementación Completa: portel_support_bot.py»Nasledujúci skript poskytuje interaktívne rozhranie konzoly, ktoré umožňuje komunikovať s generatívnym motorom Gemini v režime Streaming (nepretržité odosielanie a vykresľovanie textových fragmentov) a zahŕňa komplexnú kontrolu výnimiek a prísne podnikové smernice.
import osimport sysimport timefrom google import genaifrom google.genai import typesfrom google.api_core import exceptions as core_exceptions
def verificar_entorno(): """Valida la presencia de la clave de autenticación oficial.""" if not os.environ.get("GOOGLE_API_KEY") and not os.environ.get("GEMINI_API_KEY"): print("[CRITICAL] La variable de entorno GOOGLE_API_KEY no está configurada.") print("Ejecute: export GOOGLE_API_KEY='su_clave_de_laboratorio'") sys.exit(1)
def ejecutar_chatbot(): # 1. Verificar credenciales antes de iniciar verificar_entorno()
# 2. Inicialización del cliente unificado de Google GenAI client = genai.Client()
# 3. Directriz del sistema (Instrucción de Comportamiento e Identidad) instrucciones_soporte = """ Actúas como 'PortelBot', el Asistente Técnico Automatizado de Portelcore (portelcore.com). Tu objetivo principal es asistir a los ingenieros en operaciones de red, backups e infraestructura.
REGLAS DE COMPORTAMIENTO: 1. Responde de manera profesional, técnica e impecable en idioma castellano. 2. Si te preguntan sobre IPs de prueba del laboratorio, haz referencia estricta al segmento seguro 172.22.40.231. 3. Nunca reveles credenciales del tenant, llaves de API ni secretos de base de datos. 4. Usa bloques de código estructurados en Markdown para mostrar comandos de Linux o scripts cuando sea relevante. """
# 4. Configuración avanzada de la sesión de chat configuracion = types.GenerateContentConfig( system_instruction=instrucciones_soporte, temperature=0.4, # Nivel moderado para asegurar precisión técnica max_output_tokens=1000, # Limitar el tamaño para prevenir costes excesivos safety_settings=[ types.SafetySetting( category=types.HarmCategory.HARM_CATEGORY_DANGEROUS_CONTENT, threshold=types.HarmBlockThreshold.BLOCK_MEDIUM_AND_ABOVE ) ] )
print("\n=======================================================") print(" INICIANDO CONSOLA DE SOPORTE PORTELCORE ") print(" Escribe 'salir' o 'exit' para finalizar la sesión. ") print("=======================================================\n")
try: # 5. Crear la sesión de chat con estado chat = client.chats.create( model="gemini-2.5-flash", # Modelo recomendado por velocidad y costes config=configuracion )
while True: # Capturar la entrada del usuario try: mensaje_usuario = input("\n[Usuario] >> ").strip() except (KeyboardInterrupt, EOFError): print("\n\nSesión interrumpida por el usuario. Cerrando de forma segura.") break
if not mensaje_usuario: continue
if mensaje_usuario.lower() in ["salir", "exit", "quit"]: print("\nFinalizando asistencia de PortelBot. ¡Que tenga un excelente día!") break
print("[PortelBot] >> ", end="", flush=True)
try: # 6. Enviar mensaje del usuario en modo Streaming response_stream = chat.send_message_stream(mensaje_usuario)
# Iterar sobre los fragmentos a medida que llegan del servidor for chunk in response_stream: if chunk.text: print(chunk.text, end="", flush=True) print() # Salto de línea final
except core_exceptions.ResourceExhausted as err_quota: print(f"\n[ERROR] Se ha excedido la cuota de peticiones por minuto. Espere unos segundos. Detalle: {err_quota.message}") except core_exceptions.GoogleAPICallError as err_api: print(f"\n[ERROR] Error en el servicio de Gemini API: {err_api.message}") except Exception as e: print(f"\n[ERROR INESPERADO] {str(e)}")
except Exception as e: print(f"[CRITICAL] Error al instanciar la sesión de chat: {e}")
if __name__ == "__main__": ejecutar_chatbot()3. Príručka spustenia a testovania v laboratóriu
Sección titulada «3. Guía de Ejecución y Pruebas en Laboratorio»Ak chcete nasadiť a validovať interaktívny chatbot vo vašom vývojovom prostredí v Portelcore, postupujte podľa tejto operačnej sekvencie:
Krok 1: Konfigurácia vývojového prostredia
Sección titulada «Paso 1: Configurar el Entorno de Desarrollo»Uistite sa, že ste v adresári projektu a aktivujte izolované prostredie Pythonu. Nainštalujte zjednotený SDK, ak ste tak ešte neurobili.
# Crear entorno virtual de pruebaspython -m venv portel-chat-envsource portel-chat-env/bin/activate # En Linux/macOS# .\portel-chat-env\Scripts\activate # En Windows
# Instalar biblioteca Google GenAIpip install --upgrade google-genaiKrok 2: Spustenie chatbotu
Sección titulada «Paso 2: Ejecutar el Chatbot»Bezpečne nakonfigurujte váš kľúč Gemini API (zakúpený v Google AI Studio) ako premennú prostredia a spustite asistenta.
# Configuración temporal de la variable de entornoexport GOOGLE_API_KEY="AIzaSyA..."
# Lanzar consola interactivapython portel_support_bot.pyKrok 3: Interakcia a audit pamäte chatu
Sección titulada «Paso 3: Interactuar y Auditar la Memoria del Chat»Otestujte zachovanie kontextu kladením po sebe nasledujúcich otázok:
- Otázka 1: „Ahoj, potrebujem nakonfigurovať statickú IP adresu na serveri n8n.“
- Otázka 2 (kontextová): „Aký segment siete mi zodpovedá podľa pravidiel Portelcore?“
- Validácia: Asistent musí správne odpovedať odkazom na statickú IP adresu
172.22.40.231(stanovenú v systéme v kroku 2), čím preukáže, že si zapamätá predchádzajúcu konverzáciu bez potreby opätovného definovania kontextu n8n.
4. Kontrolný zoznam validácie chatbotu
Sección titulada «4. Checklist de Validación del Chatbot»Overte robustnosť konverzačného asistenta proti štandardom nájomcu:
- Skript využíva výlučne triedu
genai.Client()z knižnicegoogle-genainamiesto zastaraného SDK. ✓ - Chatbot odosiela a spracúva dáta v reálnom čase pomocou
send_message_streampre plynulý zážitok. ✓ - Systémové inštrukcie zabezpečujú zosúladenie osobnosti a obmedzujú únik dôverných údajov alebo tajomstiev domény
portelcore.com. ✓ - Blok
try...exceptelegantne ovláda a zapuzdruje kritické výnimky, ako sú limity kvóty (ResourceExhausted). ✓

