> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistant en ClickHouse Cloud

> Conozca, habilite y use Assistant en la consola de ClickHouse Cloud

Assistant permite usar lenguaje natural para analizar datos en un servicio de ClickHouse Cloud. Puede generar consultas, visualizaciones y resúmenes utilizando el contexto de las pestañas activas, las consultas guardadas, los esquemas y los dashboards.

El Assistant también incluye un modo Docs AI para formular preguntas basadas en la documentación de ClickHouse. Use esta guía para habilitar el Assistant y trabajar con ambos modos en la ClickHouse Cloud Console.

**1. Requisitos previos**

1. Debe tener acceso a una organización de ClickHouse Cloud con las funciones de IA habilitadas (póngase en contacto con el administrador de su organización o con soporte si no está disponible).

**2. Abrir el panel de AI Chat**

1. Vaya a un servicio de ClickHouse Cloud.
2. En la barra lateral izquierda, haga clic en el icono de destello con la etiqueta “Assistant”.
3. (Acceso directo) Pulse <kbd>⌘</kbd> + <kbd>'</kbd> (macOS) o <kbd>Ctrl</kbd> + <kbd>'</kbd> (Linux/Windows) para abrirlo o cerrarlo.

![Abrir el panel lateral de AI Chat](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ad98d16b98abcc8875a9fef907045155)

**3. Aceptar el consentimiento de uso de datos (primer uso)**

1. La primera vez que lo use, verá un cuadro de diálogo de consentimiento que describe el tratamiento de los datos y los subencargados externos del LLM.
2. Revíselo y acéptelo para continuar. Si lo rechaza, el panel no se abrirá.

![Cuadro de diálogo de consentimiento](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=ff56a1b3e6b5407ff95c4e1e89df7b9a)

**4. Elegir un modo de chat**

Actualmente, AI Chat admite:

* **Agent**: razonamiento en varios pasos sobre el esquema + 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.

Use el selector de modo en la parte inferior izquierda del panel lateral para cambiar.

![Selección de modo](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=e695326686cbf96050905e3f1eb42a1e)

**5. Redactar y enviar un mensaje**

1. Escriba su pregunta (p. ej., “Crea una vista materializada para agregar eventos diarios por usuario”).
2. Pulse <kbd>Enter</kbd> para enviar (use <kbd>Shift</kbd> + <kbd>Enter</kbd> para insertar una nueva línea).
3. Mientras el modelo está procesando, puede hacer clic en “Stop” para interrumpirlo.

**6. Comprender los pasos de “thinking” de Agent**

En el modo Agent, puede ver pasos intermedios expandibles de “thinking” o planificación. Estos aportan transparencia sobre cómo el asistente formula su respuesta. Puede contraerlos o expandirlos según lo necesite.

![Pasos de thinking](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=23a1a324e86591f69328228de6c7c08d)

**7. Iniciar chats nuevos**

Haga clic en el botón “New Chat” para limpiar el contexto e iniciar una sesión nueva.

**8. Ver el historial de chats**

1. La sección inferior muestra sus chats recientes.
2. Seleccione un chat anterior para cargar sus mensajes.
3. Elimine una conversación con el icono de la papelera.

![Lista del historial de chats](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=9b3c8d9265e906889c3ddd18d6d29485)

**9. Trabajar con SQL generado**

Cuando el asistente devuelve SQL:

* Revíselo para comprobar que sea correcto.
* Haga clic en “Open in editor” para cargar la consulta en una nueva pestaña SQL.
* Modifíquelo y ejecútelo en la Console.

![Acciones de resultado](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=1ca9b4c9c987b0dc3fd2c7b0c6d205c6)

![Abrir la consulta generada en el editor](https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max\&auto=format\&n=RMrV3JZHbEy3aFh9\&q=85\&s=148eb60e6217aeea2c091ed40fc5e364)

**10. Detener o interrumpir una respuesta**

Si una respuesta tarda demasiado o se desvía:

1. Haga clic en el botón “Stop” (visible mientras se procesa).
2. El mensaje se marcará como interrumpido; puede ajustar su prompt y volver a enviarlo.

**11. Atajos de teclado**

| Acción | Atajo |
| - | - |
| Abrir AI Chat | `⌘ + '` / `Ctrl + '` |
| Enviar mensaje | `Enter` |
| Nueva línea | `Shift + Enter` |
