> ## 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.

# Usar el chat de ClickHouse Assistant en ClickHouse Cloud

> Guía para habilitar y usar la función AI Chat en la consola de ClickHouse Cloud

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> Esta guía explica cómo habilitar y usar la función AI Chat en la ClickHouse Cloud Console.

<Steps>
  <Step title="Requisitos previos" id="prerequisites">
    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).
  </Step>

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/1_open_chat.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=99adfce6ae6ec1ea4e895688ebcb96f2" alt="Abrir el panel lateral de AI Chat" size="md" width="1762" height="1364" data-path="images/use-cases/AI_ML/AIChat/1_open_chat.webp" />
  </Step>

  <Step title="Aceptar el consentimiento de uso de datos (primer uso)" id="consent">
    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á.

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/2_consent.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=54010396eff18df4fe545f4ad70f7b57" alt="Cuadro de diálogo de consentimiento" size="md" width="1342" height="922" data-path="images/use-cases/AI_ML/AIChat/2_consent.webp" />
  </Step>

  <Step title="Elegir un modo de chat" id="modes">
    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.

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/3_modes.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=39a7ccc19b995812b0ad6115ccd8fa46" alt="Selección de modo" size="sm" width="584" height="262" data-path="images/use-cases/AI_ML/AIChat/3_modes.webp" />
  </Step>

  <Step title="Redactar y enviar un mensaje" id="compose">
    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.
  </Step>

  <Step title="Comprender los pasos de “thinking” de Agent" id="thinking-steps">
    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.

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/4_thinking.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=0df1ca2235dcec9f8d0f49fa6271a892" alt="Pasos de thinking" size="md" width="1702" height="1180" data-path="images/use-cases/AI_ML/AIChat/4_thinking.webp" />
  </Step>

  <Step title="Iniciar chats nuevos" id="new-chats">
    Haga clic en el botón “New Chat” para limpiar el contexto e iniciar una sesión nueva.
  </Step>

  <Step title="Ver el historial de chats" id="history">
    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.

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/5_history.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=dea90fb7824b49a2fb5b6af0f71fa987" alt="Lista del historial de chats" size="md" width="1754" height="634" data-path="images/use-cases/AI_ML/AIChat/5_history.webp" />
  </Step>

  <Step title="Trabajar con SQL generado" id="sql-actions">
    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.

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/6_result_actions.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=409c86a0ec90d48221a6dfdffcb7945f" alt="Acciones de resultado" size="md" width="1746" height="1362" data-path="images/use-cases/AI_ML/AIChat/6_result_actions.webp" />

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/AIChat/7_open_in_editor.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=ff40fb5f4aea3697dda1db999622d341" alt="Abrir la consulta generada en el editor" size="md" width="1662" height="284" data-path="images/use-cases/AI_ML/AIChat/7_open_in_editor.webp" />
  </Step>

  <Step title="Detener o interrumpir una respuesta" id="interrupt">
    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.
  </Step>

  <Step title="Atajos de teclado" id="shortcuts">
    | Acción         | Atajo                |
    | -------------- | -------------------- |
    | Abrir AI Chat  | `⌘ + '` / `Ctrl + '` |
    | Enviar mensaje | `Enter`              |
    | Nueva línea    | `Shift + Enter`      |
  </Step>
</Steps>
