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

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

> Создайте и запустите своего первого агента ClickHouse для сервиса 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>
                Beta feature. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        Learn more.
                    </a>
                </u>
            </span>
        </div>;
};

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

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

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

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

<Steps>
  <Step>
    ### Запустите ClickHouse Agents

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

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

  <Step>
    ### Создайте агента

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

    * **Name** - короткий идентификатор агента.
    * **Description** - описание назначения агента, которое будет видно вашим коллегам.
    * **Category** - категория агента. Можно оставить `General`, если в вашей организации не используются пользовательские категории.
    * **Instructions** - системный промпт, который описывает роль агента, вопросы, на которые он должен отвечать, и бизнес-правила, которым он должен следовать.
    * **Model** - выберите модель из выпадающего списка. Настройте temperature и другие параметры генерации в разделе [параметры модели](/ru/products/cloud/features/ai-ml/agents/builder/model-parameters).

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

  <Step>
    ### Подключите возможности и инструменты

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

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

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

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

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/huP88Vza7bEG09HU/images/cloud/agent-builder/tools-modal.png?fit=max&auto=format&n=huP88Vza7bEG09HU&q=85&s=80cb90aa3290765aeb07f2f9b7420c80" 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.png" />

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

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

  <Step>
    ### Выполните запрос

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

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

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

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