> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido

> Crea y ejecuta tu primer agente de ClickHouse con un servicio de ClickHouse Cloud

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Funcionalidad beta. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Más información.
                    </a>
                </u>
            </span>
        </div>;
};

Cree un agente personalizado en la consola de Cloud y ejecute una consulta en lenguaje natural contra su servicio.

<div id="prerequisites">
  ## Requisitos previos
</div>

* Un servicio de ClickHouse Cloud que puedas consultar.
* La opción **Crear agente** en Agent Builder. Si no aparece, pide a un administrador de la organización que conceda la creación de agentes en Configuración de administrador, como se detalla en [compartir y acceso](/es/products/cloud/features/ai-ml/agents/sharing-and-access).

<div id="build-the-agent">
  ## Crea el agente
</div>

<Steps>
  <Step>
    ### Inicia ClickHouse Agents

    Desde tu servicio de Cloud, haz clic en **ClickHouse agents** en la barra lateral izquierda para abrir el launchpad de agentes. Haz clic en **Launch ClickHouse agents** para abrir Agent Builder.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/launch-ch-agents.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=4aafb55c109b4976177a4da1e096ea97" alt="Navegación del servicio de Cloud con ClickHouse agents (Beta) seleccionado, mostrando el launchpad con el botón Launch ClickHouse agents" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/launch-ch-agents.png" />
  </Step>

  <Step>
    ### Crea el agente

    En Agent Builder, haz clic en **Create New Agent** en la parte superior del panel izquierdo. Completa los campos principales:

    * **Name** - un identificador breve para tu agente.
    * **Description** - una descripción de la finalidad del agente, visible para tus compañeros de equipo.
    * **Category** - una categoría para tu agente. Puedes dejarla como `General`, a menos que tu organización tenga categorías personalizadas.
    * **Instructions** - el system prompt, que describe el rol del agente, las preguntas que debe responder y cualquier regla de negocio que deba seguir.
    * **Model** - elige un modelo en el menú desplegable.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/agent-builder.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=bd0bd9325ca990d98b1867bb86df3a8d" alt="Panel de Agent Builder que muestra el menú desplegable Create New Agent, los campos del formulario (Name, Description, Category, Instructions, Model) y la sección Capabilities" size="lg" width="3834" height="1932" data-path="images/cloud/agent-builder/agent-builder.png" />
  </Step>

  <Step>
    ### Añade capacidades y herramientas

    Las capacidades y herramientas del agente se gestionan en dos lugares.

    **Capabilities** en el panel principal — funciones nativas como [Run Code](/es/products/cloud/features/ai-ml/agents/builder/code-interpreter), [Web Search](/es/products/cloud/features/ai-ml/agents/builder/web-search), File Context, Artifacts, [MCP Servers](/es/products/cloud/features/ai-ml/agents/builder/mcp-servers) y [Skills](/es/products/cloud/features/ai-ml/agents/builder/skills). Activa las que necesite el agente.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/capabilities.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=bdcf33c54c7ac3b17aa09bda7a6c2bb0" alt="Sección Capabilities del panel de Agent Builder que muestra los interruptores de Run Code, Web Search, File Context, Artifacts, MCP Servers y Skills" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/capabilities.png" />

    **Tools** detrás del botón **Add Tools** en la parte inferior del panel — integraciones de terceros como [image generation](/es/products/cloud/features/ai-ml/agents/builder/image-generation), [vision](/es/products/cloud/features/ai-ml/agents/builder/vision), API de búsqueda y servicios externos.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/tools-button.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=1b8116d99353bbb9f85a4dc7a469f9be" alt="Parte inferior del panel de Agent Builder con el botón Add Tools resaltado" size="sm" width="596" height="836" data-path="images/cloud/agent-builder/tools-button.png" />

    Haz clic en **Add Tools** para explorar el catálogo:

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/tools-modal.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=35fda89dc5b868a5578995d4c306b18b" alt="Modal de Agent Tools que muestra una cuadrícula de integraciones de terceros, incluidas Google, OpenAI Image Tools, Wolfram, DALL-E-3, Tavily Search, Calculator y Stable Diffusion" size="lg" width="2560" height="1280" data-path="images/cloud/agent-builder/tools-modal.png" />

    Los [Subagents](/es/products/cloud/features/ai-ml/agents/builder/subagents) se configuran en **Advanced settings** — consulta la página de subagents para obtener más información.

    Puedes cambiar las capacidades y herramientas asociadas en cualquier momento.
  </Step>

  <Step>
    ### Ejecuta una consulta

    Guarda el agente, abre una nueva conversación y selecciona tu agente en el selector de agentes. Escribe una pregunta — por ejemplo, *"¿Cuáles son mis 10 tablas con más filas esta semana?"* — y el agente planificará, llamará a las herramientas según sea necesario y devolverá una respuesta.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/chat-query.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=81eaecd4c45aa678ce804c39633ba1e8" alt="Intercambio de chat que muestra la pregunta '¿Cuáles son mis 10 tablas con más filas esta semana?' y la respuesta del agente: una tabla Markdown con la clasificación de las 10 tablas con más filas entre servicios, con Key Observations debajo" size="lg" width="2722" height="1882" data-path="images/cloud/agent-builder/chat-query.png" />
  </Step>
</Steps>

<div id="next-steps">
  ## Siguientes pasos
</div>

* [Comparte el agente](/es/products/cloud/features/ai-ml/agents/sharing-and-access) con tu equipo.
* Publícalo en el [marketplace](/es/products/cloud/features/ai-ml/agents/marketplace) una vez que el agente sea estable.