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

# Démarrage rapide

> Créez et exécutez votre premier ClickHouse Agent avec un service 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>
                Fonctionnalité en bêta. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        En savoir plus.
                    </a>
                </u>
            </span>
        </div>;
};

Créez un agent personnalisé dans la console Cloud et exécutez une requête en langage naturel sur votre service.

<div id="prerequisites">
  ## Prérequis
</div>

* Un service ClickHouse Cloud que vous pouvez interroger.
* L’option **Create agent** dans Agent Builder. Si elle n’apparaît pas, demandez à un administrateur de l’org d’autoriser la création d’agents via Admin Settings, comme indiqué dans [sharing and access](/fr/products/cloud/features/ai-ml/agents/sharing-and-access).

<div id="build-the-agent">
  ## Créer l’agent
</div>

<Steps>
  <Step>
    ### Lancer ClickHouse Agents

    Depuis votre service Cloud, cliquez sur **ClickHouse agents** dans la barre latérale gauche pour ouvrir la page de lancement des agents. Cliquez sur **Launch ClickHouse agents** pour ouvrir l’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="Navigation du service Cloud avec ClickHouse agents (Beta) sélectionné, affichant la page de lancement avec le bouton Launch ClickHouse agents" size="lg" width="3836" height="1938" data-path="images/cloud/agent-builder/launch-ch-agents.png" />
  </Step>

  <Step>
    ### Créer l’agent

    Dans l’Agent Builder, cliquez sur **Create New Agent** en haut du panneau de gauche. Renseignez les champs principaux :

    * **Name** - un identifiant court pour votre agent.
    * **Description** - une description de l’objectif de l’agent, visible par vos coéquipiers.
    * **Category** - une catégorie pour votre agent. Vous pouvez laisser `General`, sauf si votre org utilise des catégories personnalisées.
    * **Instructions** - le system prompt, qui décrit le rôle de l’agent, les questions auxquelles il doit répondre et les règles métier qu’il doit suivre.
    * **Model** - choisissez un modèle dans la liste déroulante.

    <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="Panneau Agent Builder affichant le menu déroulant Create New Agent, les champs du formulaire (Name, Description, Category, Instructions, Model) et la section Capabilities" size="lg" width="3834" height="1932" data-path="images/cloud/agent-builder/agent-builder.png" />
  </Step>

  <Step>
    ### Ajouter des capacités et des outils

    Les capacités et les outils de l’agent se trouvent à deux endroits.

    Les **Capabilities** du panneau principal — des fonctionnalités natives comme [Run Code](/fr/products/cloud/features/ai-ml/agents/builder/code-interpreter), [Web Search](/fr/products/cloud/features/ai-ml/agents/builder/web-search), File Context, Artifacts, [MCP Servers](/fr/products/cloud/features/ai-ml/agents/builder/mcp-servers) et [Skills](/fr/products/cloud/features/ai-ml/agents/builder/skills). Activez celles dont l’agent a besoin.

    <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="Section Capabilities du panneau Agent Builder affichant les interrupteurs Run Code, Web Search, File Context, Artifacts, MCP Servers et Skills" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/capabilities.png" />

    Les **Tools**, accessibles via le bouton **Add Tools** en bas du panneau — des intégrations tierces comme la [génération d’images](/fr/products/cloud/features/ai-ml/agents/builder/image-generation), [Vision](/fr/products/cloud/features/ai-ml/agents/builder/vision), des API de recherche et des services externes.

    <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="Bas du panneau Agent Builder avec le bouton Add Tools mis en évidence" size="sm" width="596" height="836" data-path="images/cloud/agent-builder/tools-button.png" />

    Cliquez sur **Add Tools** pour parcourir le catalogue :

    <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="Fenêtre modale Agent Tools affichant une grille d’intégrations tierces, dont Google, OpenAI Image Tools, Wolfram, DALL-E-3, Tavily Search, Calculator et Stable Diffusion" size="lg" width="2560" height="1280" data-path="images/cloud/agent-builder/tools-modal.png" />

    Les [Subagents](/fr/products/cloud/features/ai-ml/agents/builder/subagents) se configurent dans **Advanced settings** — consultez la page des subagents pour plus de détails.

    Vous pouvez modifier les capacités et les outils associés à tout moment.
  </Step>

  <Step>
    ### Exécuter une requête

    Enregistrez l’agent, ouvrez une nouvelle conversation et sélectionnez votre agent dans le sélecteur d’agents. Saisissez une question — par exemple, *"Quelles sont mes 10 principales tables par nombre de lignes cette semaine ?"* — et l’agent planifie, appelle des outils si nécessaire, puis fournit une réponse.

    <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="Échange dans le chat affichant la question 'Quelles sont mes 10 principales tables par nombre de lignes cette semaine ?' et la réponse de l’agent — un tableau Markdown classant les 10 principales tables de tous les services par nombre de lignes, avec Key Observations en dessous" size="lg" width="2722" height="1882" data-path="images/cloud/agent-builder/chat-query.png" />
  </Step>
</Steps>

<div id="next-steps">
  ## Étapes suivantes
</div>

* [Partagez l’agent](/fr/products/cloud/features/ai-ml/agents/sharing-and-access) avec vos collègues.
* Publiez-le dans le [Marketplace](/fr/products/cloud/features/ai-ml/agents/marketplace) une fois l’agent stable.