> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alyzai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bien formuler une demande

> Trois réflexes pour une réponse juste du premier coup : cadrer, mentionner, formater.

> [!NOTE]
>
> Référence · 7 min

> [!TIP]
>
> **Exemple métier.** Les exemples achats, qualité ou industrie illustrent le parcours. Adaptez
> les données, les rôles et le vocabulaire à votre contexte.

Une demande utile décrit le **résultat**, le **périmètre**, les **sources** et le **format de sortie**.
L’Assistant peut poser une question lorsque l’une de ces informations manque, mais les préciser dès
le départ réduit les interprétations.

## La structure recommandée

Utilisez cette formule :

> À partir de **\[source]**, réalise **\[objectif]** sur **\[périmètre]**, puis présente le résultat
> sous la forme **\[format]**. Signale **\[contrôles ou limites]**.

Exemple métier : « À partir de la table des commandes, compare les délais par fournisseur sur le
premier semestre, présente les dix écarts les plus élevés dans un tableau et indique les lignes
incomplètes. »

## Cadrer le périmètre

Précisez les dimensions qui changent le sens de la réponse : période, entité, statut, catégorie,
équipe ou niveau de détail. Une expression comme « cette année » peut devenir ambiguë dans une
conversation reprise plus tard ; préférez une période explicite.

Si vous ne connaissez pas encore le bon périmètre, demandez d’abord à l’Assistant de vous proposer
les valeurs disponibles, puis formulez l’analyse.

## Sélectionner une source avec @

Tapez `@` dans le composer pour ouvrir les ressources mentionnables. Recherchez puis sélectionnez
une collection, un ou plusieurs documents, une table, un formulaire, un modèle de rapport ou un
agent. La mention reste visible dans la demande avant l’envoi.

![Menu de mention @ ouvert dans le composer, avec catégories et recherche](https://mintcdn.com/alyzai/St7evzCbpXJOLQ-i/images/product/assistant/mention.png?fit=max\&auto=format\&n=St7evzCbpXJOLQ-i\&q=85\&s=8d9038deb76a8d3f048dd114a86eda36)

Le menu « @ » : catégories (agents, outils, collections, formulaires, modèles de rapport), recherche.

> [!TIP]
>
> Dans une collection, vous pouvez sélectionner plusieurs documents. N’ajoutez que les sources
> utiles : un contexte plus large n’est pas toujours un contexte plus précis.

## Demander un format et un niveau de preuve

Indiquez comment vous utiliserez le résultat : trois points de synthèse, tableau comparatif, e-mail,
plan d’action ou document. Pour une décision, demandez également les hypothèses, les sources, les
données manquantes et les éléments qui nécessitent une validation.

| Demande floue | Demande exploitable |
| - | - |
| « Comment va l’activité ? » | « Compare le volume mensuel du premier semestre dans la table mentionnée, en cinq puces, puis indique les valeurs absentes. » |
| « Écris un e-mail. » | « Rédige un rappel professionnel de moins de 120 mots, avec un objet explicite et sans inventer de date. » |
| « Analyse ce fichier. » | « Vérifie d’abord sa structure, puis classe les cinq écarts les plus importants et explique le calcul utilisé. » |

*À gauche, l’assistant doit deviner ; à droite, il exécute.*

## Ajuster la demande après la réponse

Dans le même fil, vous pouvez demander :

* « explique le calcul de la deuxième colonne » ;
* « limite le résultat aux éléments dont le statut est ouvert » ;
* « cite la source de chaque chiffre » ;
* « transforme cette synthèse en e-mail, sans l’envoyer ».

Si vous changez de ressource ou d’objectif, reformulez les éléments importants au lieu de compter
uniquement sur l’historique.

## Limites et questions fréquentes

> [accordion] Pourquoi l’Assistant demande-t-il une précision ?
>
> Plusieurs sources, périodes ou actions peuvent correspondre à votre phrase. Répondez avec le
> choix exact plutôt que de lui demander de deviner.

> [accordion] Une mention donne-t-elle de nouveaux droits ?
>
> Non. Elle sélectionne une ressource déjà accessible dans votre workspace ; elle ne modifie
> pas les permissions.

> [accordion] Faut-il écrire une demande très longue ?
>
> Non. Une phrase structurée vaut mieux qu’un long texte sans objectif. Ajoutez ensuite les
> contraintes qui changent réellement le résultat.

> [accordion] Que faire si un chiffre semble faux ?
>
> Demandez le champ, le filtre, l’agrégat et la source utilisés, puis contrôlez une valeur
> dans la ressource d’origine.

## Étapes suivantes

> [card] [Générer et envoyer un e-mail](https://docs.alyzai.com/fr/assistant/generer-et-envoyer-un-email.md)
>
> Du brouillon au départ, en passant par le ton.

> [card] [Analyser un fichier](https://docs.alyzai.com/fr/assistant/analyser-un-fichier.md)
>
> D’un export brut à des constats visuels.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.