Ir al contenido

インタラクティブサポートチャットボット:Google GenAIを使った高度な例

Portelcore向けの企業向けサポートチャットボットのステップバイステップ開発:状態管理、トークンストリーミング、エラー処理の厳格な管理

0閲覧数

1. 状態保持型チャットボットのアーキテクチャ

Sección titulada «1. Arquitectura de un Chatbot Conversacional con Estado»

インタラクティブな技術サポートインターフェース(例:portel_support_bot)を作成するには、会話履歴の万全な管理が必要です。シングルターンのリクエストとは異なり、プロダクション環境のチャットボットは、クライアントが送信した以前のコンテキストを記憶しておく必要があります。

新しいPython統合SDKgoogle-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生成エンジンと< strong >ストリーミング</ strong >モード(テキストチャンクの継続的な送信とレンダリング)で対話できるインタラクティブコンソールインターフェースを提供し、包括的な例外処理および厳格な企業ガイドラインを含んでいます。

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の開発環境で対話型チャットボットを展開および検証するには、次の運用手順に従ってください。

ステップ1:開発環境のセットアップ

Sección titulada «Paso 1: Configurar el Entorno de Desarrollo»

プロジェクトディレクトリに移動し、隔離された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

ステップ2:チャットボットの実行

Sección titulada «Paso 2: Ejecutar el Chatbot»

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: 「私はn8nサーバーに静的IPを構成する必要があります。」
  2. 質問2(コンテキストあり): 「Portelcoreのルールによると、私はどのネットワークセグメントに該当しますか?」
  3. 検証:アシスタントは、静的IPアドレス172.22.40.231を参照して(ステップ2のシステム指示で設定されたもの)正しく応答し、n8nのコンテキストを再定義することなく、以前の会話を記憶していることを示す必要があります。

4. チャットボット検証チェックリスト

Sección titulada «4. Checklist de Validación del Chatbot»

テナントの基準に合致するように会話アシスタントの堅牢性を検証してください:

  • スクリプトは、旧SDKに代わってgoogle-genaiライブラリのgenai.Client()クラスのみを使用します。 ✓
  • チャットボットはsend_message_streamを使用してデータをリアルタイムで送受信・処理し、スムーズな体験を提供します。 ✓
  • システム指示は人格の整合性を保証し、portelcore.comドメインの認証情報やシークレットの漏洩を制限します。 ✓
  • try...exceptブロックは、クォータ制限(ResourceExhausted)のような重要な例外を洗練された方法で制御しカプセル化します。 ✓