Outils
La boîte à outils créative de votre agent.
Chaque outil renvoie une structure JSON stable et se présente à votre agent avec des schémas riches, lisibles par l’IA. Votre agent choisit ainsi le bon outil sans avoir besoin d’être guidé.
01
Lancer une génération
generate_presentation_startLance une nouvelle tâche de génération de présentation. Par défaut, l’appel attend le résultat en long polling : un seul appel d’outil suffit donc généralement pour obtenir la présentation terminée. Une génération prend en général de 5 à 7 minutes.
- userPrompt
- Prompt décrivant la présentation souhaitée.
- systemInstructions
- Consignes d’IA à IA, réparties en trois champs : designStyle, resourcesToUse, context.
- slideCount
- Nombre de slides souhaité. De 1 à 25, 10 par défaut.
- generateImages
- Indique si le modèle doit générer des images.
- themeId
- Identifiant de thème facultatif, issu de list_available_themes.
- images
- Images jointes facultatives (8 au maximum). Chacune est une imageUrl publique transmise comme référence visuelle.
- waitForCompletionMs
- Durée maximale du long polling, en millisecondes. Valeur recommandée : 220000. Maximum : 900000.
02
Vérifier l’état d’une génération
generate_presentation_statusRenvoie l’état d’une tâche en cours. Passez waitForCompletionMs pour attendre en long polling que la tâche atteigne un état final et recevoir les notifications de progression MCP via votre progressToken.
- jobId
- UUID de la tâche, renvoyé par generate_presentation_start.
- waitForCompletionMs
- Durée maximale du long polling, en millisecondes.
03
Annuler une génération
generate_presentation_cancelAnnule une génération en cours. Sans effet si la tâche a déjà atteint un état final.
- jobId
- UUID de la tâche à annuler.
04
Lister les thèmes sélectionnés
list_available_themesRenvoie le catalogue des thèmes de design sélectionnés par nos soins. Chaque thème est fourni avec un prompt designStyle prêt à l’emploi, à passer tel quel dans systemInstructions.designStyle.
05
Consulter la facturation et les crédits IA
get_billing_statusRenvoie le billing_plan et les ai_credits restants de l’utilisateur authentifié, ainsi que l’URL à lui transmettre s’il doit changer d’offre ou recharger ses crédits.
06
Contrôle de disponibilité
health_checkRenvoie l’état de base du processus MCP côté backend. Pratique pour vérifier la connectivité.