Ir al contenido

인터랙티브 지원 챗봇: Google GenAI를 사용한 고급 예제

Portelcore용 상태가 있는 기업 기술 지원 챗봇의 단계별 개발: 토큰 스트리밍 및 예외 처리

0조회

기술 지원 대화형 인터페이스(예: portel_support_bot)를 생성하는 것은 대화 이력 관리가 완벽해야 합니다. 단일 전환 요청과 달리, 생산용 챗봇은 고객이 이전에 전송한 맥락을 기억해야 합니다.

새로운 Python 통합 SDK 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)

다음 스크립트는 콘솔에서 Gemini 엔진과 대화할 수 있는 대화형 인터페이스를 제공합니다. 스트리밍 모드(텍스트 조각의 지속적인 전송 및 렌더링)에서 작동하며 엄격한 기업 지침과 예외 통합 제어를 포함합니다.

import os
import sys
import time
from google import genai
from google.genai import types
from 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()

Portelcore에서 개발 환경에 대화형 챗봇을 배포하고 검증하려면 다음 운영 절차를 따르세요:

프로젝트 디렉토리에 있는지 확인하고 Python 격리 환경을 활성화하세요. SDK를 아직 설치하지 않았다면 설치합니다.

Ventana de terminal
# Crear entorno virtual de pruebas
python -m venv portel-chat-env
source portel-chat-env/bin/activate # En Linux/macOS
# .\portel-chat-env\Scripts\activate # En Windows
# Instalar biblioteca Google GenAI
pip install --upgrade google-genai

Google AI Studio에서 얻은 Gemini API 키를 안전하게 환경 변수로 설정하고 어시스턴트를 실행하세요.

Ventana de terminal
# Configuración temporal de la variable de entorno
export GOOGLE_API_KEY="AIzaSyA..."
# Lanzar consola interactiva
python portel_support_bot.py

단계 3: 대화 메모리 상호작용 및 감사

Sección titulada «Paso 3: Interactuar y Auditar la Memoria del Chat»

연속된 질문을 통해 컨텍스트 유지 여부를 테스트하세요:

  1. 질문 1: “서버에 정적 IP를 설정해야 합니다.”
  2. 질문 2 (맥락): “Portelcore의 규칙에 따라 내 네트워크 세그먼트는 무엇입니까?”
  3. 검증: 어시스턴트는 시스템 지침의 2단계에서 설정된 정적 IP 172.22.40.231을 참조하여 올바르게 응답해야 하며, n8n의 맥락을 다시 정의하지 않고 이전 대화를 기억하고 있음을 보여야 합니다.

챗봇의 대화형 성능을 테넌트 표준에 맞게 검증하십시오:

  • 스크립트는 google-genai 라이브러리의 genai.Client() 클래스만 사용하여 오래된 SDK 대체. ✓
  • 챗봇은 send_message_stream을 통해 실시간 데이터 전송 및 처리를 수행하여 매끄러운 경험 제공. ✓
  • 시스템 지시사항은 대화형 어시스턴트의 성격을 일치시키고 portelcore.com 도메인의 자격 증명 또는 시크릿 유출을 제한합니다. ✓
  • try...except 블록은 쿼터 한도(ResourceExhausted)와 같은 중대한 예외를 우아하게 제어하고 캡슐화합니다. ✓