Guide d'utilisation

Vous n'avez pas besoin de clé API pour commencer : un modèle hébergé est déjà inclus, et les agents du niveau Gratuit fonctionnent automatiquement sur le pool partagé de la plateforme. Si votre plan autorise votre propre fournisseur, allez dans Connecter → Fournisseurs, choisissez Anthropic, OpenAI, ou un autre fournisseur compatible, et collez votre propre clé API depuis le tableau de bord de ce fournisseur. La clé est validée par un appel réel (non facturé) avant d'être enregistrée et chiffrée au repos. Une fois qu'elle affiche ACTIF, vos agents l'utilisent à la place du pool hébergé.

Après cela, l'ordre de construction naturel est : créer un Agent (Construire → Agents), l'essayer en privé dans le Playground (Tester → Playground), puis soit l'intégrer à un Workflow pour une automatisation multi-étapes, soit le connecter directement à un canal (WhatsApp, Telegram, e-mail) pour que de vraies personnes puissent lui parler.

Tout champ demandant un prompt système ou une description (prompt système d'un agent, description d'une collection de connaissances, et d'autres à l'avenir) a un petit bouton ✨ Demander à l'IA à côté de son libellé. Cliquez dessus, décrivez ce que vous voulez en une phrase (ex: "un agent de support qui gère les remboursements et le statut des commandes"), et il rédigera le texte en utilisant le fournisseur LLM que vous avez activé. Rien n'est appliqué automatiquement : vous examinez toujours la suggestion et cliquez vous-même sur Utiliser, ou sur Régénérer pour un autre essai.

Un agent est une persona d'IA : un prompt système, un fournisseur/modèle LLM, et optionnellement une base de connaissances et un ensemble restreint d'outils. Partez d'un modèle (tri du support, assistant de recherche, etc.) pour pré-remplir un prompt système pertinent, ou partez de zéro et utilisez "Demander à l'IA" pour en rédiger un.

L'accès aux outils et l'accès aux connaissances sont des listes d'autorisation : laissez-les vides pour un accès "sans restriction" (l'agent peut utiliser tout ce qui est disponible pour votre tenant), ou cochez des éléments spécifiques pour restreindre l'agent à ceux-ci. C'est important pour tout ce qui est en contact avec les clients : vous ne voulez généralement pas qu'un bot de support public ait accès à tous les outils internes.

Téléchargez des fichiers .md, PDF, Word, des images (OCR), ou des fichiers audio/vidéo (transcrits) et ils seront segmentés et vectorisés dans une base de données interrogeable. Les Collections sont des dossiers que vous pouvez imbriquer et utiliser pour limiter l'accès des agents. Par exemple, une collection "Politique de retour" que seuls certains agents peuvent consulter, par opposition à une collection "FAQ publique" que tous les agents peuvent utiliser.

Un agent ne consulte sa base de connaissances que si l'option "Attacher la base de connaissances" est cochée lors de sa création (ou activée plus tard depuis la page Agents), et uniquement dans les collections autorisées par sa liste d'accès.

Le canevas visuel pour l'automatisation multi-étapes : glissez et connectez des nœuds (Déclencheur, Agent, Recherche de connaissances, Condition, Sortie, Contrôle d'appareil, etc.). Chaque nœud appelle le service réel correspondant : une exécution de Workflow appelle réellement votre agent, recherche réellement dans votre base de connaissances, envoie réellement le message WhatsApp.

Les workflows peuvent démarrer de trois manières : manuellement (bouton "Exécuter"), selon une planification (expression cron, ex: "tous les matins à 8h"), ou via une URL de webhook que vous pouvez appeler depuis un système externe. Chaque exécution est journalisée étape par étape dans l'onglet Exécutions du workflow, y compris chaque appel d'outil individuel effectué par un nœud Agent.

Une place de marché de serveurs Model Context Protocol et d'outils intégrés qu'un agent peut appeler en pleine conversation (recherche web, base de données, système de fichiers, vos propres scripts...). Activez ceux que vous souhaitez rendre disponibles, puis définissez quels agents peuvent les utiliser depuis l'éditeur d'accès aux outils de chaque agent. Désactiver un serveur ici le retire immédiatement des outils disponibles pour tous les agents, même ceux pour qui il était coché.

Sous Admin → Canaux : connectez WhatsApp soit via Twilio (configuration rapide du bac à sable, faibles frais par message), soit directement via la WhatsApp Business Platform de Meta (sans frais d'intermédiaire, plus de configuration - votre propre App Meta, jeton d'utilisateur système et secret d'application). Si les deux sont configurés, la connexion directe à Meta est utilisée automatiquement.

La première fois qu'un nouveau numéro de téléphone envoie un message, il apparaît sous Appairages d'expéditeurs en attente et doit être approuvé avant que vos agents puissent avoir une conversation en direct avec lui. Cela empêche un inconnu qui envoie un message à votre numéro d'avoir par défaut une conversation IA non supervisée.

Associez un téléphone (Android ou iOS) à votre tenant depuis la page Appareils, et le nœud Contrôle d'appareil d'un workflow pourra appuyer, taper, ouvrir des applications ou faire une capture d'écran. Android prend en charge l'automatisation complète via le service d'accessibilité d'Android ; iOS est limité par le sandboxing d'Apple à l'ouverture d'applications uniquement. Consultez le fichier CONSTRAINTS.md du SDK Mobile pour la description complète et honnête de ce que chaque plateforme peut et ne peut pas faire.

Utilisateurs : invitez des coéquipiers et assignez des rôles (seul un administrateur du tenant peut changer les rôles ou les identifiants). Approbations est la boîte de réception pour intervention humaine : toute action que votre politique de garde-fou signale comme nécessitant une validation (ex: un agent sur le point d'envoyer un message WhatsApp) attend ici jusqu'à être approuvée ou rejetée. Le Journal d'audit est un enregistrement complet et non modifiable de chaque action significative effectuée dans votre tenant, par une personne ou un agent.

"No active providers yet" when creating an agent - you should not see this on a new account: every new account runs on the platform's hosted pool for its first 3 months, and the Free plan does after that. It appears once you are on a paid plan using your own provider - activate one under Connect → Providers.

Le bouton Demander à l'IA renvoie une erreur - même cause que ci-dessus. Il échoue uniquement lorsque votre compte n'est plus sur le pool hébergé et n'a pas de fournisseur actif propre.

Un expéditeur en attente sur WhatsApp/Telegram ne reçoit jamais de réponse - vérifiez dans Admin → Canaux s'il y a un appairage en attente de votre approbation.

Un outil n'apparaît pas pour un agent - confirmez qu'il est activé sous Outils MCP, et que la liste d'accès aux outils de l'agent l'inclut ou est laissée vide (sans restriction).