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

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>;
};

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>Бета</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Возможность в статусе бета. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Подробнее.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

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

<div id="prerequisites">
  ## Предварительные требования
</div>

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

<div id="build-the-agent">
  ## Создайте агента
</div>

<Steps>
  <Step title="Запустите ClickHouse Agents" id="launch-agents">
    В вашем сервисе Cloud нажмите **ClickHouse agents** на левой боковой панели, чтобы открыть стартовую страницу агентов. Затем нажмите **Launch ClickHouse agents**, чтобы открыть Конструктор агентов.

    <Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/launch-ch-agents.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=9b9c85a6e599f3c8e09648ab69d7aba5" alt="Навигация сервиса Cloud с выбранным пунктом ClickHouse agents (бета), где показана стартовая страница с кнопкой Launch ClickHouse agents" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/launch-ch-agents.webp" />
  </Step>

  <Step title="Создайте агента" id="create-the-agent">
    В Конструкторе агентов нажмите **Create New Agent** в верхней части левой панели. Заполните основные поля:

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

    <Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/agent-builder.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=25965d81bfc34402ffcc63bcd10ab82b" alt="Панель Конструктора агентов с выпадающим списком Create New Agent, полями формы (Name, Description, Category, Instructions, Model) и разделом Capabilities" size="lg" width="3834" height="1932" data-path="images/cloud/agent-builder/agent-builder.webp" />
  </Step>

  <Step title="Подключите возможности и инструменты" id="attach-tools">
    Возможности и инструменты агента настраиваются в двух местах.

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

    <Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/capabilities.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=295b4657156542294fa374fc96c6dac2" alt="Раздел Capabilities в панели Конструктора агентов с переключателями Run Code, Веб-поиск, File Context, Artifacts, MCP-серверы и навыки" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/capabilities.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/tools-button.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=2796d5f96e5943751ed4d04098bd791a" alt="Нижняя часть панели Конструктора агентов с выделенной кнопкой Add Tools" size="sm" width="596" height="836" data-path="images/cloud/agent-builder/tools-button.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/tools-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=e98e46712afcbb5aa6347c8b7446ffd2" alt="Модальное окно Agent Tools с сеткой сторонних интеграций, включая Google, OpenAI Image Tools, Wolfram, DALL-E-3, Tavily Search, Calculator и Stable Diffusion" size="lg" width="2560" height="1280" data-path="images/cloud/agent-builder/tools-modal.webp" />

    [Субагенты](/docs/ru/products/cloud/features/ai-ml/agents/builder/subagents) настраиваются в разделе **Advanced settings** — подробности см. на странице субагентов.

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

  <Step title="Выполните запрос" id="run-a-query">
    Сохраните агента, откройте новый диалог и выберите своего агента в списке выбора агентов. Введите вопрос — например, *"Какие 10 моих таблиц имеют наибольшее число строк на этой неделе?"* — и агент составит план, при необходимости вызовет инструменты и вернет ответ.

    <Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/chat-query.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=c3dcfe8f94d8348a1bae938cb8c04f3d" alt="Диалог в чате с вопросом 'Какие 10 моих таблиц имеют наибольшее число строк на этой неделе?' и ответом агента — таблицей Markdown с рейтингом 10 лучших таблиц по сервисам по числу строк, а ниже — Key Observations" size="lg" width="2722" height="1882" data-path="images/cloud/agent-builder/chat-query.webp" />
  </Step>
</Steps>

<div id="next-steps">
  ## Следующие шаги
</div>

* [Откройте общий доступ к агенту](/docs/ru/products/cloud/features/ai-ml/agents/sharing-and-access) для коллег.
* Опубликуйте его в [маркетплейсе](/docs/ru/products/cloud/features/ai-ml/agents/marketplace), когда агент станет стабильным.