A Letaido / docs
DOCUMENTATION

Capacités principales

Une carte complète de ce que Letaido peut construire aujourd'hui. Chaque capacité est une primitive qu'il compose, et non quelque chose qu'il prétend faire.

En bref

Capacité Ce que c'est Où ça se trouve
Fichiers Lecture/écriture/édition réelles sur un système de fichiers que vous possédez ~/workspace/
Base de données PostgreSQL, le stockage persistant pour tout Trois bases de données nommées (voir Données)
Application web interne Application Flask réservée aux membres (la Console) console-http, réservée aux membres
Application web publique Application Flask accessible sur Internet (le site public) site-http, processus séparé derrière nginx
Connecteurs Wrappers d'API tierces typées (Ahrefs, Slack, HubSpot, ...) Répartiteur de connecteurs local
Automatisations Scripts planifiés, exécutions d'agents planifiées et exécutions déclenchées Automatisations enregistrées dans votre espace de travail
Webhooks et déclencheurs Réactions événementielles aux signaux tiers Déclencheurs de connecteurs + ad-hoc
Compétences Playbooks réutilisables que l'agent lit à la demande ~/workspace/skills/ + plateforme
Mémoire Persistance inter-conversations des faits que vous signalez ~/workspace/.memory.md
Recherche Recherche web, récupération de pages, synthèse multi-étapes avec sources Intégré
Accès LLM Appels à plus de 300 modèles via un proxy local Proxy LLM local
Exports de fichiers Génération de PDF et PNG sous un chemin de rendu sécurisé en sandbox Intégré (voir compétence PDF)

Fichiers

Letaido dispose d'un accès en lecture/écriture/modification à votre Workspace. Il traite les fichiers comme le résultat d'un travail, et non comme un espace de travail temporaire.

  • Les brouillons, notes et recherches sont stockés en markdown.
  • Le code, les générateurs et les scripts ponctuels sont stockés en .py.
  • Les fichiers que vous déposez dans le chat arrivent dans ~/workspace/uploads/ et sont référencés par chemin absolu.
  • Les fichiers que vous souhaitez partager arrivent dans ~/workspace/downloads/ et sont publiés via une URL de téléchargement enregistrée.

Ce qu'il ne fait PAS : écrire en dehors de votre espace de travail dans les composants internes de la plateforme, modifier la propriété des fichiers ou toucher d'autres espaces de travail.

Base de données

PostgreSQL est le seul magasin persistant. Pas de SQLite, pas de JSON sur disque, pas de dictionnaires en mémoire qui disparaissent au redémarrage.

Trois bases de données, chacune avec une audience différente (couvert dans Données et stockage) : - console_db pour les outils internes et l'état privé. - site_db pour le contenu que le site public sert. - console_site_db pour les canaux explicites entre surfaces.

Application web interne (la Console)

Agent-A---Console.gif

Lorsque vous demandez « une page où je peux coller X et obtenir Y », l'artefact est une application Console : un blueprint Python plus un template Jinja, auto-enregistré dans une application Flask réservée aux membres.

  • Les routes sont accessibles à des URL prévisibles (/applications/<slug>/).
  • Les pages peuvent lire depuis la base de données, appeler des connecteurs et afficher les résultats.
  • L'application redémarre automatiquement lors d'un changement de fichier ; vous n'exécutez jamais flask run manuellement.

Application web publique (le site public)

Agent-A---Public-site.gif

Un processus Flask distinct servant l'internet ouvert, avec son propre rôle de base de données et trois modes de visibilité (désactivé, autorisé, ouvert). C'est ici que se trouvent les pages destinées aux clients, les flux de génération de leads, les rapports publics et cette documentation.

0

Le site public peut lire les données précalculées que la Console écrit, mais il ne peut pas accéder à l'état interne de la Console. Cette séparation est appliquée au niveau du système d'exploitation et de la base de données, et non par convention.

Connecteurs

Agent-A---Connectors.gif

Wrappers typés autour des API tierces. La découverte est une arborescence (fournisseur → catégorie → connecteur), chaque appel est enregistré, chaque identifiant est limité, et chaque nouvelle surface (chat, Console, site) nécessite sa propre approbation.

Câblé aujourd'hui, regroupé par utilisation typique :

  • Intelligence SEO et marketing : Ahrefs (suite complète), Semrush, Apify, Firehose.
  • CRM et ventes : HubSpot, Gong, Chargebee, Stripe.
  • Communication et collaboration : Slack, Notion, Linear, GitHub.
  • Contenu et e-mail : WordPress, Mailchimp, Resend, SendGrid, Fathom.
  • Données et opérations : Airtable.
  • Infrastructure : Cloudflare, DNSimple.

De nouveaux fournisseurs sont ajoutés régulièrement. Consultez l'onglet Connecteurs dans votre Workspace pour voir la liste en direct.

Automatisations

Agent-A---Jobs.gif

Les tâches récurrentes existent sous forme d'automatisations enregistrées, et non comme des « rappelle-moi plus tard » dans le chat. Une automatisation est soit un script Python qui s'exécute sur cron, soit un chat d'agent planifié qui s'exécute avec un prompt fixe, soit une exécution déclenchée par un événement qui se déclenche lors d'un événement tiers. Chacune est soumise à l'approbation du propriétaire/administrateur, puis s'exécute selon son calendrier avec stdout et stderr capturés pour chaque exécution.

Demandes typiques : analyses hebdomadaires de la concurrence, instantanés quotidiens du trafic, actualisations horaires de Brand Radar, résumés du lundi matin comme celui qui met à jour ces documents.

Webhooks et déclencheurs

Letaido peut écouter et interroger. Les déclencheurs de connecteur (messages Slack, événements GitHub, changements d'état Linear, modifications d'enregistrements HubSpot) transmettent des événements dans une file d'attente locale qu'une application ou une tâche consomme.

Pour les services sans déclencheur de connecteur, il existe toujours un chemin webhook ad hoc avec accusé de réception explicite afin que les événements ne soient pas supprimés silencieusement.

Compétences

Agent-A---Skills.gif

Une compétence est un dossier contenant un fichier SKILL.md et tous les éléments associés. L'agent les lit à la demande lorsque la tâche correspond. Certaines compétences sont fournies avec la plateforme (Postgres, Pydantic, export PDF, recherche web). D'autres sont spécifiques à l'espace de travail et se trouvent dans ~/workspace/skills/, notamment la voix de marque, le manuel de conception, la banque de publications et la stratégie marketing pour votre équipe.

Les compétences permettent à Letaido d'apprendre le style de votre maison sans qu'il ne s'infiltre dans chaque conversation sous forme de texte standard.

Mémoire

Agent-A---Memory.gif

Mémoire de Letaido

Letaido lit ~/workspace/.memory.md au début de chaque conversation. Lorsque vous dites « souviens-toi de ceci : X », il l'ajoute. Ce qu'il est bon de mémoriser : rôle, vocabulaire récurrent, règles stylistiques, objectifs à long terme. Ce qu'il ne faut pas mémoriser : tout ce qui est sensible, tout ce qui change chaque semaine.

Il existe également un journal des modifications (progress.md) que l'agent complète après chaque changement significatif, afin que vous puissiez reconstituer ce qui s'est passé d'une session à l'autre.

Recherche

  • Recherche web sur le web ouvert avec extraits surlignés (souvent suffisant ; évite une récupération).
  • Récupération de page en markdown propre (supprime les publicités, la navigation, le contenu standard).
  • Recherche en plusieurs étapes alternant recherche et synthèse lorsque la tâche est large.
  • Lecture de PDF téléchargés, transcriptions, présentations et extraction de résultats structurés.

Letaido cite les sources par défaut et vous indique quand il n'a pas pu vérifier une affirmation.

Accès aux LLM

Agent-A---AI-bots.gif

Letaido lui-même raisonne via un LLM. Il expose également cette capacité aux applications et aux tâches via un proxy local : n'importe quel code peut appeler les derniers modèles Claude, GPT, Gemini et plus de 300 autres modèles sans gérer de clés API. Cela signifie que les applications Console et les tâches en arrière-plan que l'agent construit pour vous peuvent elles-mêmes exécuter des agents IA et des appels LLM en leur sein, et pas seulement dans le chat dans lequel vous parlez à Letaido.

C'est ce qui alimente des fonctionnalités telles que « une application qui prend une URL et renvoie un script vidéo de 90 secondes dans la voix de notre marque », ou une tâche qui classe les leads entrants HubSpot avec un LLM toutes les heures.

Exports de fichiers

Génération de PDF et PNG sous un chemin sécurisé par sandbox. Il existe une compétence dédiée qui répertorie les bibliothèques qui fonctionnent à l'intérieur de cette sandbox (Pillow, ReportLab, chemins headless) et celles à éviter (la plupart des exportateurs basés sur web-canvas).

Si vous demandez « un PDF de ce rapport », l'agent lit d'abord la compétence pour choisir un itinéraire fonctionnel, plutôt que de deviner.

Sous le capot. Chaque capacité ci-dessus correspond à un petit ensemble de primitives : une écriture de fichier, une requête SQL, un blueprint Flask, une entrée cron, un abonnement webhook, une invocation de connecteur. L'agent n'invente pas de primitives. Il les compose. C'est pourquoi « construis-moi quelque chose qui fait X tous les Y et notifie Z » est une forme de demande fiable.

Last updated 2026-07-13