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

# Prompts

> Bibliothèque de prompts sauvegardés pour ClickHouse Agents

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>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Fonctionnalité en bêta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        En savoir plus.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

La bibliothèque Prompts permet d’enregistrer et de réutiliser des prompts en langage naturel que vous saisissez régulièrement. Considérez-la comme des extraits réutilisables pour votre composer — pratique lorsque la même question d’analyse ou la même consigne de mise en forme revient d’une conversation à l’autre.

<div id="create-a-prompt">
  ## Créer un prompt
</div>

Ouvrez le panneau Prompts à partir de l’icône **Prompts** dans la barre de navigation de gauche, puis cliquez sur le bouton **+** pour ouvrir le formulaire **Create Prompt**. Renseignez les champs :

* **Prompt Name** (obligatoire) - le nom affiché dans le sélecteur. Soyez explicite : *"Utilisateurs actifs hebdomadaires par région"* est préférable à *"WAU"*.
* **Text** (obligatoire) - le texte qui sera effectivement inséré dans le composer.
* **Special variables** - cliquez sur le bouton **Special variables** pour insérer des marqueurs de substitution, ou saisissez directement des marqueurs au format `{{name}}`. Le sélecteur vous invite à renseigner les valeurs avant l’insertion.
* **Category**, **Description**, **Command** (facultatif) - pour organiser la bibliothèque, définir le texte d’aperçu dans le sélecteur et ajouter un raccourci d’appel rapide.

Cliquez ensuite sur **Create Prompt** en bas à droite.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/prompts/create-prompt.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=b2718ba048bd45cba4a6d21ec58a9cb9" alt="Panneau Prompts avec le bouton + mis en évidence à gauche et le formulaire Create Prompt ouvert à droite, affichant les champs Prompt Name, Text, Category, Special variables, Description et Command, avec un bouton Create Prompt" size="lg" width="3836" height="1176" data-path="images/cloud/agent-builder/prompts/create-prompt.webp" />

<div id="use-a-prompt">
  ## Utiliser un prompt
</div>

Dans le panneau Prompts, ouvrez le menu **...** d'une carte de prompt et choisissez **Preview** :

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/prompts/preview.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=52a9b1cb081eceabe6ab0dd49f8ac645" alt="Panneau Prompts avec un prompt sélectionné, ses détails visibles à droite et un menu contextuel affichant les options Preview et Edit" size="lg" width="3836" height="1310" data-path="images/cloud/agent-builder/prompts/preview.webp" />

L'aperçu affiche le texte du prompt, ainsi que son auteur et sa date. Cliquez sur **Use Prompt** pour insérer le contenu dans le composer. Si le prompt contient des variables, renseignez-les d'abord.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/prompts/use-prompt-modal.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=6da9ccdb6cc2eaa55afd4d475d7d912c" alt="Fenêtre modale d'aperçu du prompt affichant le titre du prompt, l'auteur, la date, le contenu du texte et un bouton Use Prompt" size="md" width="2052" height="516" data-path="images/cloud/agent-builder/prompts/use-prompt-modal.webp" />

<div id="share-prompts">
  ## Partager les prompts
</div>

Par défaut, un prompt est privé et visible uniquement par la personne qui l’a créé. Le propriétaire peut modifier la visibilité d’un prompt comme suit :

* **Utilisateurs ou groupes spécifiques** - toutes les personnes que vous désignez peuvent trouver et utiliser le prompt.
* **À l’échelle de l’organisation** - tous les membres de votre organisation ClickHouse Cloud peuvent le trouver et l’utiliser.

Les prompts utilisent le même modèle d’autorisations que les agents. Pour consulter la matrice complète des rôles et les actions autorisées pour chacun, voir [Partage et
accès](/docs/fr/products/cloud/features/ai-ml/agents/sharing-and-access).

<div id="prompts-vs-skills-vs-instructions">
  ## Prompts vs. skills vs. instructions
</div>

Les Prompts, les skills et les agent instructions ajoutent tous du texte au modèle, mais ils se distinguent par ce qui les déclenche et par leur degré de persistance.

* **Prompts** - texte que vous insérez vous-même dans le composer, modifié à chaque tour.
* **[Skills](/docs/fr/products/cloud/features/ai-ml/agents/builder/skills)** - ensembles d'instructions que l'agent charge lui-même lorsqu'il les juge pertinents pour la tâche.
* **Agent instructions** - le system prompt persistant de l'agent, appliqué à chaque conversation.

Optez pour un prompt lorsque vous souhaitez réutiliser une formulation tout en gardant, à chaque fois, le contrôle sur le texte. Optez pour un skill lorsque vous voulez que l'agent applique
les mêmes consignes de façon cohérente à un type de tâche sans avoir à les saisir. Optez pour des agent instructions lorsque le comportement doit être conservé pendant toute la
durée de vie de l'agent.