Интерактивный чат-бот поддержки: продвинутый пример с Google GenAI
Пошаговое развитие корпоративного технического чат-бота с состоянием, потоковой передачей токенов и надежной обработкой исключений для Portelcore.
1. Архитектура разговорного чат-бота с состоянием
Sección titulada «1. Arquitectura de un Chatbot Conversacional con Estado»Создание интерактивного интерфейса технической поддержки (например, portel_support_bot) требует безупречного управления историей разговора. В отличие от одноразовых запросов, чат-бот production должен помнить предыдущий контекст, отправленный клиентом.
Новый унифицированный SDK Python google-genai предлагает абстрактный интерфейс client.chats, который автоматизирует сохранение статуса на стороне сервера и оптимизирует поток разговора.
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. Полная реализация: portel_support_bot.py
Sección titulada «2. Implementación Completa: portel_support_bot.py»Следующий скрипт предоставляет интерактивный консольный интерфейс для общения с генеративным двигом Gemini в режиме потоковой передачи (постоянная передача и рендеринг фрагментов текста) и включает полный контроль исключений и строгие корпоративные рекомендации.
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. Руководство по выполнению и тестированию в лаборатории
Sección titulada «3. Guía de Ejecución y Pruebas en Laboratorio»Чтобы развернуть и проверить интерактивный чат-бот в вашей среде разработки на Portelcore, следуйте этой операционной последовательности:
Шаг 1: Настройка среды разработки
Sección titulada «Paso 1: Configurar el Entorno de Desarrollo»Убедитесь, что вы находитесь в каталоге проекта и активируйте изолированную среду Python. Установите унифицированный SDK, если вы еще не сделали этого.
# 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-genaiШаг 2: Запуск чат-бота
Sección titulada «Paso 2: Ejecutar el Chatbot»Настройте безопасно ваш ключ API Gemini (приобретенный в Google AI Studio) в качестве переменной среды и запустите помощника.
# Configuración temporal de la variable de entornoexport GOOGLE_API_KEY="AIzaSyA..."
# Lanzar consola interactivapython portel_support_bot.pyШаг 3: Взаимодействие и аудит памяти чата
Sección titulada «Paso 3: Interactuar y Auditar la Memoria del Chat»Проверьте удержание контекста, задавая последовательные вопросы:
- Вопрос 1: «Привет, мне нужно настроить статический IP-адрес на сервере n8n.»
- Вопрос 2 (Контекстуальный): «Какой сегмент сети соответствует мне согласно нормам Portelcore?»
- Валидация: Помощник должен правильно ответить вам, ссылаясь на статический IP-адрес
172.22.40.231(установленный в системных инструкциях на шаге 2), демонстрируя, что он помнит предыдущий разговор без необходимости переопределять контекст n8n.
4. Контрольный список проверки чат-бота
Sección titulada «4. Checklist de Validación del Chatbot»Проверьте надежность разговорного помощника против стандартов арендатора:
- Скрипт использует исключительно класс
genai.Client()из библиотекиgoogle-genaiвместо устаревшего SDK. ✓ - Чат-бот отправляет и обрабатывает данные в реальном времени с помощью
send_message_streamдля плавного опыта. ✓ - Системные инструкции гарантируют соответствие личности и ограничивают утечку учетных данных или секретов домена
portelcore.com. ✓ - Блоки
try...exceptконтролируют и инкапсулируют критические исключения, такие как ограничения квоты (ResourceExhausted). ✓

