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

# Inicio rápido

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

[Funcionalidad beta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

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

## Requisitos previos

* 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](https://clickhouse.com/docs/es/agents/sharing-and-access.md).

## Crea el agente

**1. 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.

![Navegación del servicio de Cloud con ClickHouse agents (Beta) seleccionado, mostrando el launchpad con el botón Launch ClickHouse agents](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/launch-ch-agents.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=7b76b7220ae2e5848fefb70d25e6401c)

**2. 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.

![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](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/agent-builder.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b18a3db920e9ec695938613037a72578)

**3. 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](https://clickhouse.com/docs/es/agents/builder/code-interpreter.md), [Web Search](https://clickhouse.com/docs/es/agents/builder/web-search.md), File Context, Artifacts, [MCP Servers](https://clickhouse.com/docs/es/agents/builder/mcp-servers.md) y [Skills](https://clickhouse.com/docs/es/agents/builder/skills.md). Activa las que necesite el agente.

![Sección Capabilities del panel de Agent Builder que muestra los interruptores de Run Code, Web Search, File Context, Artifacts, MCP Servers y Skills](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/capabilities.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b82e23e834b7b1a8321f80ffc526c936)

**Tools** detrás del botón **Add Tools** en la parte inferior del panel — integraciones de terceros como [image generation](https://clickhouse.com/docs/es/agents/builder/image-generation.md), [vision](https://clickhouse.com/docs/es/agents/builder/vision.md), API de búsqueda y servicios externos.

![Parte inferior del panel de Agent Builder con el botón Add Tools resaltado](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-button.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=42c611769822a510b7b372437b0ddd70)

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

![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](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-modal.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=31187ed13e978de4ad88020c060ab2d5)

[Subagents](https://clickhouse.com/docs/es/agents/builder/subagents.md) 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.

**4. 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.

![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](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/chat-query.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=09fc2481502e3af9c35a59641528c8aa)

## Próximos pasos

* [Comparte el agente](https://clickhouse.com/docs/es/agents/sharing-and-access.md) con los miembros de tu equipo.
* Publícalo en el [marketplace](https://clickhouse.com/docs/es/agents/marketplace.md) una vez que el agente sea estable.
