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

# Быстрый старт

> Создайте и запустите своего первого агента ClickHouse для сервиса ClickHouse Cloud

[Возможность в статусе бета](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

Создайте собственного агента в консоли Cloud и выполните запрос к своему сервису на естественном языке.

## Предварительные требования

* Сервис ClickHouse Cloud, в котором можно выполнять запросы.
* Опция **Create agent** в Конструкторе агентов. Если её нет, попросите администратора организации выдать право на создание агентов через Admin Settings, как описано в разделе [совместное использование и доступ](https://clickhouse.com/docs/ru/agents/sharing-and-access.md).

## Создайте агента

**1. Запустите ClickHouse Agents**

В вашем сервисе Cloud нажмите **ClickHouse agents** на левой боковой панели, чтобы открыть стартовую страницу агентов. Затем нажмите **Launch ClickHouse agents**, чтобы открыть Конструктор агентов.

![Навигация сервиса Cloud с выбранным пунктом ClickHouse agents (бета), где показана стартовая страница с кнопкой 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. Создайте агента**

В Конструкторе агентов нажмите **Create New Agent** в верхней части левой панели. Заполните основные поля:

* **Name** - короткий идентификатор агента.
* **Description** - описание назначения агента, которое будет видно вашим коллегам.
* **Category** - категория агента. Можно оставить `General`, если в вашей организации не используются пользовательские категории.
* **Instructions** - системный промпт, который описывает роль агента, вопросы, на которые он должен отвечать, и бизнес-правила, которым он должен следовать.
* **Model** - выберите модель из выпадающего списка.

![Панель Конструктора агентов с выпадающим списком Create New Agent, полями формы (Name, Description, Category, Instructions, Model) и разделом 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. Подключите возможности и инструменты**

Возможности и инструменты агента настраиваются в двух местах.

**Capabilities** на основной панели — встроенные возможности, такие как [Run Code](https://clickhouse.com/docs/ru/agents/builder/code-interpreter.md), [Веб-поиск](https://clickhouse.com/docs/ru/agents/builder/web-search.md), File Context, Artifacts, [MCP-серверы](https://clickhouse.com/docs/ru/agents/builder/mcp-servers.md) и [навыки](https://clickhouse.com/docs/ru/agents/builder/skills.md). Включите те, которые нужны агенту.

![Раздел Capabilities в панели Конструктора агентов с переключателями Run Code, Веб-поиск, File Context, Artifacts, MCP-серверы и навыки](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/capabilities.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b82e23e834b7b1a8321f80ffc526c936)

**Tools** доступны по кнопке **Add Tools** в нижней части панели — это сторонние интеграции, такие как [генерация изображений](https://clickhouse.com/docs/ru/agents/builder/image-generation.md), [Vision](https://clickhouse.com/docs/ru/agents/builder/vision.md), API поиска и внешние сервисы.

![Нижняя часть панели Конструктора агентов с выделенной кнопкой Add Tools](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-button.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=42c611769822a510b7b372437b0ddd70)

Нажмите **Add Tools**, чтобы открыть каталог:

![Модальное окно Agent Tools с сеткой сторонних интеграций, включая Google, OpenAI Image Tools, Wolfram, DALL-E-3, Tavily Search, Calculator и 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)

[Субагенты](https://clickhouse.com/docs/ru/agents/builder/subagents.md) настраиваются в разделе **Advanced settings** — подробности см. на странице субагентов.

Вы можете в любой момент изменить подключенные возможности и инструменты.

**4. Выполните запрос**

Сохраните агента, откройте новый диалог и выберите своего агента в списке выбора агентов. Введите вопрос — например, *"Какие 10 моих таблиц имеют наибольшее число строк на этой неделе?"* — и агент составит план, при необходимости вызовет инструменты и вернет ответ.

![Диалог в чате с вопросом 'Какие 10 моих таблиц имеют наибольшее число строк на этой неделе?' и ответом агента — таблицей Markdown с рейтингом 10 лучших таблиц по сервисам по числу строк, а ниже — Key Observations](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/chat-query.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=09fc2481502e3af9c35a59641528c8aa)

## Следующие шаги

* [Откройте общий доступ к агенту](https://clickhouse.com/docs/ru/agents/sharing-and-access.md) для коллег.
* Опубликуйте его в [маркетплейсе](https://clickhouse.com/docs/ru/agents/marketplace.md), когда агент станет стабильным.
