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

# Démarrage rapide

> Créez et exécutez votre premier ClickHouse Agent avec un service ClickHouse Cloud

[Fonctionnalité en bêta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

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

## Prérequis

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

## Créer l’agent

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

![Navigation du service Cloud avec ClickHouse agents (Beta) sélectionné, affichant la page de lancement avec le bouton 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. 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.

![Panneau Agent Builder affichant le menu déroulant Create New Agent, les champs du formulaire (Name, Description, Category, Instructions, Model) et la section 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. 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](https://clickhouse.com/docs/fr/agents/builder/code-interpreter.md), [Web Search](https://clickhouse.com/docs/fr/agents/builder/web-search.md), File Context, Artifacts, [MCP Servers](https://clickhouse.com/docs/fr/agents/builder/mcp-servers.md) et [Skills](https://clickhouse.com/docs/fr/agents/builder/skills.md). Activez celles dont l’agent a besoin.

![Section Capabilities du panneau Agent Builder affichant les interrupteurs Run Code, Web Search, File Context, Artifacts, MCP Servers et Skills](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/capabilities.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=b82e23e834b7b1a8321f80ffc526c936)

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

![Bas du panneau Agent Builder avec le bouton Add Tools mis en évidence](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/tools-button.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=42c611769822a510b7b372437b0ddd70)

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

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

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

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

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

## Étapes suivantes

* [Partager l’agent](https://clickhouse.com/docs/fr/agents/sharing-and-access.md) avec vos collègues.
* Publiez-le dans le [marketplace](https://clickhouse.com/docs/fr/agents/marketplace.md) une fois l’agent stable.
