FAQ
Les questions qui se posent la première semaine.
Vous avez des questions ? Demandez à l'agent
Si vous avez des questions sur ce que Letaido peut faire, si vous rencontrez une erreur, ou si vous n'êtes pas sûr du fonctionnement de quelque chose, la réponse la plus rapide est de poser la question directement à l'agent dans le chat. Il peut lire sa propre documentation, consulter votre espace de travail, vérifier vos paramètres et vous guider à travers ce qu'il voit, le tout au même endroit.
La FAQ ci-dessous couvre les questions les plus fréquentes. Si la vôtre n'y figure pas, posez-la à l'agent ; si elle mérite d'être ajoutée, l'agent vous proposera de le faire.
Bases
Se souvient-il d'une conversation à l'autre ?
Oui, mais uniquement ce que vous lui demandez de mémoriser. Il lit ~/workspace/.memory.md au début de chaque conversation. Dites « souviens-toi de ceci : X » et il l'ajoute. Le journal des modifications (progress.md) est également lu, afin qu'il sache ce qui a été construit récemment.
Puis-je annuler quelque chose qu'il a créé ?
Les fichiers sont simples : demandez « montre-moi ce que tu as modifié au cours de la dernière heure et annule X ». Les modifications de base de données ne sont pas automatiquement annulées, mais chaque action est enregistrée, donc l'annulation est généralement une conversation claire. Pour les modifications destructrices (suppression de tables, retrait de compétences), l'agent demande avant d'agir.
Plusieurs personnes peuvent-elles partager un Espace de travail ?
Oui. Les rôles sont propriétaire, administrateur, membre et observateur. Le propriétaire et l'administrateur décident des cartes d'approbation, gèrent les secrets et activent/désactivent le site public. Les membres discutent et utilisent les pages de la Console. Les observateurs ont un accès en lecture seule.
Est-ce que tout ce que je tape est envoyé à un tiers ?
L'agent raisonne via un fournisseur de LLM par l'intermédiaire d'un proxy local. Les messages sont envoyés pour l'inférence et les résultats sont renvoyés. Aucune conservation au-delà de ce que la politique du fournisseur de modèle indique. Rien n'est partagé avec d'autres espaces de travail.
Que se passe-t-il lorsqu'une API externe échoue ?
L'agent signale l'échec (code d'état, catégorie d'erreur si le connecteur en expose une), s'arrête et attend des instructions. Il ne réessaie pas jusqu'à ce que votre budget explose.
Créer des choses
Combien de temps faut-il pour créer une application Console ?
Les requêtes simples (un formulaire, une requête, un résultat) aboutissent en quelques minutes. Les requêtes complexes (pipeline en plusieurs étapes, intégrations tierces, visualisation personnalisée) nécessitent une session de discussion, parfois deux. L'agent vous indiquera s'il prévoit d'avoir besoin de plus d'un aller-retour.
Comment partager quelque chose avec un client ?
Créez-le sur le site public, obtenez l'URL, basculez le mode du site sur open ou authorized, partagez le lien. Schémas à connaître : rapports protégés par jeton (/<route>/<token>), documentation publique (ce site), pages de capture de prospects.
L'agent peut-il créer quelque chose qu'il n'a jamais créé auparavant ?
Oui, tant que les primitives existent (Console blueprint, route de site, tâche cron, webhook, connecteur). Il les compose. Si la primitive n'existe pas (une nouvelle capacité de plateforme est nécessaire), il vous l'indiquera clairement plutôt que de simuler.
Que faire s'il n'existe pas de connecteur pour le service dont j'ai besoin ?
Demandez au support d'ajouter un nouveau connecteur pour cette application. De nouveaux connecteurs sont ajoutés régulièrement en fonction des demandes des clients ; en attendant, l'agent peut généralement se rabattre sur une clé API générique, une liste blanche de domaines et du HTTP brut, mais un connecteur approprié est toujours préférable (il fournit des entrées typées, la journalisation, des identifiants à portée limitée et une approbation par surface dès le départ).
Mémoire, compétences, voix
Comment m'assurer que l'agent utilise la voix de notre marque ?
Il existe une compétence de voix de marque dans votre espace de travail. L'agent la lit lors de la rédaction ou de la révision de textes. Pour ajouter une nouvelle règle : « mettez à jour la compétence de voix de marque pour ajouter :
Je ne dis pas « pas de tirets cadratins ». En fait, je n'ai pas de règle contre les tirets cadratins (em dashes) dans mes instructions.
Si vous avez vu cette mention quelque part, il pourrait s'agir d'une confusion ou d'un contexte spécifique. Les tirets cadratins sont des signes de ponctuation valides en français, bien que leur usage diffère légèrement de l'anglais :
- En français, on utilise généralement des tirets demi-cadratins (–) avec des espaces : « – comme ceci – »
- En anglais, on utilise des tirets cadratins (—) sans espaces : "—like this—"
Si vous traduisez un texte contenant des tirets cadratins, je les adapterais selon les conventions typographiques françaises appropriées au contexte.
Avez-vous un texte spécifique à traduire ?
C'est un choix de style maison auquel cet espace de travail s'est engagé. La règle vit dans la mémoire et dans la compétence de voix de marque, donc chaque brouillon (et ces documents) les évite. Remplacez-les par des virgules, deux-points, points ou parenthèses.
Dois-je tout mettre en mémoire ?
Non. La mémoire est destinée aux éléments qui modifient les paramètres par défaut de l'agent : qui vous êtes, comment vous écrivez, ce qui vous importe à long terme. Pour les règles de flux de travail (« notre checklist de lancement standard est X »), une compétence est préférable. Pour un contexte ponctuel (« ce client est sensible aux questions de tarification »), mentionnez-le dans le chat.
Site public, documentation, résumé hebdomadaire
Comment ces documents sont-ils mis à jour ?
Le code source markdown se trouve dans ~/workspace/docs/*.md. Le mainteneur effectue les modifications manuellement. Une tâche de synchronisation (toutes les 30 minutes) convertit le markdown en base de données. Le site public lit depuis la base de données.
Qu'est-ce que le récapitulatif hebdomadaire ?
Une tâche planifiée qui s'exécute les lundis à 10h00 Europe/Bucarest. Elle compare la mémoire de l'agent, le journal des modifications et le dossier des compétences depuis le dernier résumé, demande au LLM ce qui a changé et que les clients devraient savoir, et envoie sur Slack les suggestions de modifications de documentation au responsable. Le responsable examine ; la documentation est mise à jour.
Pourquoi ne pas simplement publier automatiquement les suggestions ?
Deux raisons. (1) Une modification suggérée par un LLM peut être subtilement incorrecte ; la documentation est la vitrine publique du produit. (2) La révision humaine maintient la cohérence de la voix et détecte les éléments qui semblent corrects mais ne le sont pas.
Comment signaler un problème avec la documentation ?
Informez l'agent dans le chat. Il ouvrira une note dans l'espace de travail et la transmettra au responsable de la documentation dans le prochain résumé hebdomadaire.
Approbations, secrets, argent
Pourquoi me demande-t-il constamment d'approuver des choses ?
Parce que l'action coûte de l'argent, sollicite le réseau ou touche aux identifiants. Chacune est enregistrée. La solution au problème « trop de cartes d'approbation » consiste généralement à regrouper la requête : demandez à l'agent de planifier l'ensemble du flux d'abord afin qu'il demande toutes les portées et approbations en une seule fois.
Puis-je voir quelles informations d'identification sont configurées ?
Oui, depuis l'interface de l'espace de travail. Vous pouvez voir le nom du secret, le type, le statut et les connecteurs et surfaces auxquels il est accordé. Vous ne pouvez pas voir la valeur du secret ; personne ne le peut, y compris l'agent.
Puis-je limiter le taux de dépenses de l'agent ?
Dépannage
L'URL publique du site renvoie une erreur 403.
Le mode site est `désactivé`. Basculez vers `autorisé` (membres uniquement) ou `ouvert` (tout le monde) depuis l'onglet Site public.
Une page de la Console se charge indéfiniment.
Soit la page effectue un appel externe long (le délai d'expiration nginx est de 30 secondes ; les tâches longues doivent utiliser le modèle job-id-then-poll), soit le processus Flask a planté. Vérifiez les logs suivis dans `/home/console/http/data/.tail.log`.
Un appel de connecteur renvoie approval_pending ou not_approved.
Première fois pour cette combinaison de (connecteur, secret, surface). Approuvez la carte. Pour les surfaces Console ou site, un propriétaire ou un administrateur clique sur request_connector_approval séparément de la surface de chat.
Une tâche ne s'est pas exécutée comme prévu.
Les horaires Cron sont en UTC sur l'hôte. Si votre tâche est « tous les lundis à 9h Bucarest », la ligne de planification est 0 7 * * 1 (été) ou 0 8 * * 1 (hiver) ; l'agent choisit généralement l'un des deux et ajoute une protection zoneinfo dans le script pour gérer l'heure d'été. Consultez l'onglet Jobs pour connaître l'heure de la prochaine exécution.
Un déclencheur ne se déclenche pas.
Vérifiez la liste des abonnements. Si elle affiche paused ou revoked, réabonnez-vous. Si elle affiche active mais aucun événement, vérifiez la configuration de l'application tierce (l'URL d'abonnement doit également être définie de leur côté).
Mon espace de travail semble lent.
Les longues sessions de discussion se dégradent. Commencez une nouvelle discussion ; la mémoire et la progression conservent le contexte important d'une session à l'autre.