Esta guía explica cómo habilitar y usar la función AI Chat en la ClickHouse Cloud Console.
1
Requisitos previos
- Debes tener acceso a una organización de ClickHouse Cloud con las funciones de IA habilitadas (contacta con el administrador de tu organización o con el soporte si no están disponibles).
2
Abre el panel de AI Chat
- Ve a un servicio de ClickHouse Cloud.
- En la barra lateral izquierda, haz clic en el icono de destellos con la etiqueta “ClickHouse Assistant”.
- (Atajo) Pulsa ⌘ + ’ (macOS) o Ctrl + ’ (Linux/Windows) para mostrar u ocultar el panel.
3
Acepta el consentimiento de uso de datos (primer uso)
- La primera vez que lo uses, aparecerá un cuadro de diálogo de consentimiento que describe el tratamiento de los datos y los subencargados de tratamiento de LLM de terceros.
- Revísalo y acéptalo para continuar. Si lo rechazas, el panel no se abrirá.
4
Elige un modo de chat
Actualmente, AI Chat admite:- Agent: Razonamiento de varios pasos sobre el esquema y los metadatos (el servicio debe estar activo).
- Docs AI (Ask): Preguntas y respuestas centradas en la documentación oficial de ClickHouse y en referencias de buenas prácticas.
5
Redacta y envía un mensaje
- Escribe tu pregunta (p. ej., “Crea una vista materializada para agregar eventos diarios por usuario”).
- Pulsa Enter para enviar (usa Shift + Enter para insertar una nueva línea).
- Mientras el modelo está procesando, puedes hacer clic en “Stop” para interrumpirlo.
6
Comprender los pasos de Thinking de “Agent”
En el modo Agent, puede que veas pasos intermedios expandibles de “Thinking” o planificación. Estos aportan transparencia sobre cómo el asistente elabora su respuesta. Colápsalos o expándelos según lo necesites.7
Iniciar chats nuevos
Haz clic en el botón “New Chat” para borrar el contexto y comenzar una nueva sesión.8
Ver el historial del chat
- La sección inferior muestra tus chats recientes.
- Selecciona un chat anterior para cargar sus mensajes.
- Elimina una conversación con el icono de la papelera.
9
Trabajar con SQL generado
Cuando el asistente devuelve SQL:- Revísalo para comprobar que sea correcto.
- Haz clic en “Open in editor” para cargar la consulta en una nueva pestaña de SQL.
- Modifícala y ejecútala en la Console.
10
Detener o interrumpir una respuesta
Si una respuesta tarda demasiado o empieza a desviarse:- Haz clic en el botón “Stop” (visible mientras se procesa).
- El mensaje se marca como interrumpido; puedes perfeccionar tu prompt y volver a enviarlo.
11