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

# L'agent Macaly

L'agent Macaly crée des sites web et des applications pour vous. Vous décrivez ce que vous souhaitez en langage courant, et l'agent détermine comment le réaliser.

## Qu'est-ce qu'un agent ?

Si vous avez utilisé ChatGPT ou des outils similaires, vous connaissez déjà les chatbots.

Vous posez une question, il vous donne une réponse. C'est là que ça s'arrête.

Un agent est différent. Il passe à l'action.

Pensez-y de cette façon :

* Un chatbot vous expliquera comment commander une pizza.
* Un agent consulte les restaurants, compare les prix, passe la commande et vous prévient quand elle arrive.

L'agent Macaly fonctionne de la même manière, sauf qu'il crée des sites web et des applications au lieu de commander des pizzas.

## Modes

Macaly dispose de 3 modes qui contrôlent la façon dont l'agent traite vos requêtes :

* **Construire :** Crée immédiatement sans poser de questions. Idéal si vous savez exactement ce que vous voulez.
* **Plan :** Élabore un plan ou pose des questions de clarification avant de créer. À utiliser lorsque la tâche est complexe ou que vous souhaitez revoir l'approche d'abord.
* **Auto (par défaut) :** Décide quand planifier et quand créer. Les requêtes simples sont réalisées directement, les requêtes complexes déclenchent une planification ou des questions.

Vous pouvez changer de mode directement dans le chat à l'aide du sélecteur de mode situé à côté du champ de saisie.

<img src="https://mintcdn.com/macalywl/j-Vf23AL_8eSkHUs/images/Execution%20modes.png?fit=max&auto=format&n=j-Vf23AL_8eSkHUs&q=85&s=aafa6cf111f694abecf6311473d5da79" alt="Modes d'exécution" width="2880" height="1324" data-path="images/Execution modes.png" />

## Capacités de l'agent

L'agent agit comme un collaborateur qui peut planifier, poser des questions, effectuer des recherches et créer votre application de A à Z.

<AccordionGroup>
  <Accordion title="Planifier avant de créer" icon="list">
    Pour les fonctionnalités complexes, l'agent décompose votre requête en étapes et vous montre le plan d'abord. Vous pouvez le revoir et l'approuver avant toute réalisation.
  </Accordion>

  <Accordion title="Demander quand quelque chose n'est pas clair" icon="question">
    Au lieu de deviner, l'agent s'arrête pour poser des questions ciblées. Ainsi, le résultat correspond à ce que vous souhaitez réellement.
  </Accordion>

  <Accordion title="Se souvenir des décisions passées" icon="clock">
    L'agent conserve le contexte de votre projet, de sorte que les modifications restent cohérentes avec les choix que vous avez faits précédemment.
  </Accordion>

  <Accordion title="Rechercher sur le web" icon="globe">
    Si l'agent a besoin d'informations actuelles, d'exemples ou de documentation, il les recherche sur le web.
  </Accordion>

  <Accordion title="S'inspirer de sites existants" icon="book-open-cover">
    Lorsque vous partagez une URL, l'agent peut analyser la structure et le design pour les utiliser comme référence ou source d'inspiration.
  </Accordion>

  <Accordion title="Travailler avec des photos" icon="image">
    Il trouve des photos libres de droits de haute qualité adaptées à votre projet, comme des images hero, des arrière-plans ou des photos d'ambiance.
  </Accordion>

  <Accordion title="Créer des visuels personnalisés" icon="wand">
    Génère de nouvelles images, modifie celles existantes ou supprime les arrière-plans lorsque les photos libres de droits ne conviennent pas.
  </Accordion>

  <Accordion title="Effectuer des modifications pour vous" icon="edit">
    Vous n'avez pas besoin de toucher au code. L'agent met à jour les pages, le contenu, la mise en page et les fonctionnalités en fonction de vos demandes.
  </Accordion>

  <Accordion title="Vérifier son propre travail" icon="check-circle">
    Avant de terminer, l'agent vérifie ce qu'il a créé pour détecter les erreurs ou les détails manquants.
  </Accordion>
</AccordionGroup>

## Modèles IA

Ouvrez **Paramètres → Général → Modèle IA** pour choisir le modèle d'un projet. Les options dépendent de la configuration de votre plateforme en marque blanche et peuvent inclure :

* **OpenAI** : GPT-5.6 Terra, Sol et Luna — traitement aux États-Unis
* **Anthropic** : Sonnet 5 et Opus 5 — traitement dans l'UE
* **Grok 4.5** et **Kimi K3** — traitement aux États-Unis
* **Minimax 3**, **GLM 5.2** et **DeepSeek Flash v4** — traitement dans l'UE

Le sélecteur affiche un drapeau UE ou États-Unis pour chaque modèle. Les modèles diffèrent en capacité, vitesse et consommation de crédits ; utilisez la description sous le sélecteur pour choisir le meilleur compromis pour la tâche en cours.

L'agent fonctionne dans un environnement sandbox sécurisé et a accès à de vrais outils de développement. Il peut naviguer sur Internet, raisonner sur la structure, itérer sur les solutions et améliorer les projets sans nécessiter de prompts manuels constants.

## Questions fréquentes

<AccordionGroup>
  <Accordion title="L'agent est bloqué ou met trop de temps. Que puis-je faire ?">
    Si l'agent ne montre aucun progrès pendant plus de 10 à 15 minutes, rechargez d'abord la page. Si l'aperçu est figé, ouvrez son menu et choisissez **Rebuild Preview** pour les projets récents ou **Restart App** pour les projets plus anciens.

    Si la dernière modification a cassé le projet, utilisez l'**Historique des versions** lorsqu'il est disponible, ou **Restaurer cette version** sous la dernière bonne réponse de l'agent. Si le problème persiste, signalez-le depuis la réponse concernée et joignez le lien du chat, l'heure approximative et une capture d'écran ou les détails de l'erreur.
  </Accordion>

  <Accordion title="L'agent refait toujours la même erreur. Comment éviter de consommer des crédits inutilement ?">
    Lorsque vous signalez une erreur, soyez aussi précis que possible. Décrivez ce que vous faisiez avant l'erreur, ce que vous voyez maintenant, ce qui ne fonctionne pas et quel devrait être le comportement correct. Plus vous fournissez de détails, mieux l'agent pourra résoudre le problème du premier coup.
  </Accordion>

  <Accordion title="Dois-je diviser une demande importante en étapes plus petites ?">
    Oui. La quantité de travail que l'agent peut accomplir dépend de la tâche et peut inclure du travail en parallèle : il n'existe donc pas de limite d'étapes unique et utile. Divisez les demandes importantes ou dépendantes en prompts gérables, vérifiez chaque résultat, puis continuez.
  </Accordion>

  <Accordion title="Comment créer une sauvegarde de mon projet ?">
    Utilisez l'**Historique des versions** lorsqu'il est disponible ou **Restaurer cette version** pour revenir à une version fonctionnelle. Dupliquez le projet lorsque vous voulez une branche indépendante pour expérimenter, et non comme mécanisme principal de récupération. Les duplicatas ordinaires commencent sans historique de conversation. Pour un projet avec base de données, vous choisissez de créer une nouvelle base ou de conserver la même.
  </Accordion>

  <Accordion title="Puis-je restaurer une version précédente de mon projet ?">
    Oui. Ouvrez l'**Historique des versions** lorsqu'il est disponible pour parcourir les aperçus précédents, identifier les versions la plus récente et publiée, les ouvrir séparément ou les restaurer. Vous pouvez aussi utiliser **Restaurer cette version** sous une réponse de l'agent pour revenir à cet état du code.
  </Accordion>

  <Accordion title="Quand utiliser /compact ?">
    Utilisez `/compact` lorsqu'un long chat commence à perdre le fil ou avant une nouvelle tâche liée à la précédente. La commande résume la conversation tout en conservant le même projet et le même code. La création du résumé utilise des crédits et nécessite un solde minimum, mais le contexte raccourci peut réduire le coût des messages suivants. Évitez de l'utiliser après chaque message, car des résumés répétés peuvent perdre des détails.
  </Accordion>
</AccordionGroup>


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