docsDocumentation › Glossaire
Glossaire
Les mots de cette documentation, et ceux du serveur. Quand le serveur emploie un autre mot dans ses réponses, il est donné : « réchauffage » pour la montée progressive, « créneau d’envoi » pour les heures ouvrées.
Qui
| Mot | Sens |
|---|---|
| Agent | Le programme d’IA qui se branche au serveur avec une clé, écrit, lit et répond. |
| Humain | La personne pour qui l’agent travaille. Elle reçoit le code à 6 chiffres, paie le forfait et valide les brouillons. Dans les outils : human_email. |
| Correspondant | La personne ou le service à qui une boîte écrit, ou qui lui écrit. Dans un fil : counterpart. |
| Administrateur de Subagent | La personne qui exploite le service. Elle fait ce qu’aucun outil ne fait : voir Aide. |
Accès
| Mot | Sens |
|---|---|
| Espace | Les boîtes, les fils, les clés, les domaines, la liste de blocage et le forfait d’un même client. La clé l’impose : un agent ne sort pas du sien. Dans l’objet rendu par inbox_status, l’espace est le champ tenant. |
| Espace vérifié | Un espace dont l’humain a donné le code à 6 chiffres. Avant, ses boîtes reçoivent et n’envoient pas. |
| Clé | Ce qu’un agent présente à chaque appel : sak_…. Elle désigne un espace et porte des permissions. Voir Clés et permissions. |
| Permission | Ce qu’une clé ouvre : send, read, approve, manage_inboxes. |
| Code à 6 chiffres | Le code que l’humain reçoit par e-mail et que l’agent passe à verify. Il vaut 24 heures. |
| Connecteur | L’adresse https://api.subagent.fr/connect, par laquelle l’assistant en ligne d’un humain se branche à son espace, sans clé à copier. Voir Connecteur. |
| Code de connexion | Le code à 6 chiffres que l’humain reçoit quand il branche son assistant par le connecteur. Il vaut 10 minutes, et se saisit sur la page de Subagent. |
Courrier
| Mot | Sens |
|---|---|
| Boîte | Une adresse e-mail pilotée par un agent : inb_…. Elle reçoit dès sa création. Voir Boîtes. |
| Première boîte | La boîte ouverte par sign_up sur le domaine commun. |
| Domaine commun | subagentmail.fr, partagé par tous les espaces. Une fois le forfait payé, ses boîtes ne font que répondre à qui leur a écrit. |
| Domaine | Un nom de domaine enregistré par un espace pour y créer ses boîtes : dom_…. Voir Domaines. |
| Fil | La conversation entre une boîte et un correspondant : thr_…. Voir Fils. |
| Message | Un e-mail, entrant ou sortant, dans un fil : msg_…. Voir Messages. |
| Premier message | Le message qui ouvre un fil avec un destinataire. Il s’écrit avec send_email. |
| Réponse | Un message écrit dans un fil existant, avec reply_to_thread. |
| Relance | Une réponse dans un fil où le correspondant n’a pas encore écrit. |
| Conversation | Un fil où le correspondant a écrit. La réponse y part sans attendre les heures ouvrées, sans pied de désinscription. |
| Brouillon | Un message de statut draft : il attend la validation d’un humain. Voir Brouillons et validation. |
| Validation | Le geste d’un humain qui fait passer un brouillon en file : approve_message. Il demande la permission approve. |
| File | Les messages de statut queued d’une boîte : ils partiront quand les règles d’envoi le permettent. |
| Journal | La suite des événements d’un message : création, validation, départ, remise, rebond. get_message le rend. |
| Contenu reçu d’un tiers | Ce qu’un correspondant a écrit. Le serveur l’encadre et le marque untrusted. Voir Recevoir du courrier. |
Règles d’envoi
| Mot | Mot du serveur | Sens |
|---|---|---|
| Montée progressive | réchauffage | Le nombre d’e-mails par jour d’une boîte monte par paliers : 5, 10, 15, 20, un palier par semaine. |
| Palier | palier | Le nombre d’e-mails par jour de la semaine en cours. |
| Quota du jour | quota du jour | Ce qu’une boîte peut envoyer dans la journée : le plus petit du palier et de son quota maximal. |
| Heures ouvrées | créneau d’envoi | Les jours et les heures où un message part. Par défaut du lundi au vendredi, de 9 h à 18 h, heure de Paris, jours fériés exclus. |
| Écart entre deux envois | étalement | Le délai que le serveur laisse entre deux envois d’une même boîte. |
| Doublon | doublon | Un second premier message de la même boîte au même destinataire, en 30 jours. Il est refusé. |
| Départ au plus tôt | départ au plus tôt | L’estimation du moment où un message en file partira : estimated_send_at. |
| Message retenu | en file | Un message qui attend son départ. Ce n’est pas une erreur. |
| Refus | refus | Une demande que le serveur n’exécute pas. Il porte un code, un message et une piste. Voir Erreurs. |
| Piste | hint | La phrase d’un refus qui dit quoi faire. |
Forfait et paiement
| Mot | Sens |
|---|---|
| Forfait | Ce que l’espace paie par mois : un nombre de boîtes et un volume d’e-mails. Trois forfaits : 9 €, 19 € et 49 €. Voir Prix et paiement. « Palier » ne désigne jamais un forfait : c’est le mot de la montée progressive. |
| Volume du mois | Le nombre d’e-mails qu’un espace peut envoyer par période d’un mois. Au-delà, un message attend la période suivante. |
| Période | Le mois payé : il commence au paiement. billing_status rend son début et sa fin. |
| Lien de paiement | Le lien que rend subscribe, et que l’agent remet à son humain. Il vaut 72 heures. |
| Prélèvement mensuel | Le paiement du forfait, chaque mois, après le premier paiement. cancel_subscription l’arrête. |
| Envoi de test | Un message écrit avec test : il ne part que vers l’humain de l’espace, ou vers une autre de ses boîtes. Il part même sans forfait. |
Arrêts
| Mot | Sens |
|---|---|
| Désinscription | La demande d’une personne de ne plus recevoir d’e-mail : par le lien en un clic, ou par une réponse « STOP ». Voir Désinscription et blocages. |
| Liste de blocage | Les adresses et les domaines auxquels un espace n’écrit plus. Dans les outils : suppression. |
| Rebond | Un e-mail revenu : le serveur du destinataire l’a refusé. |
| Adresse morte | Une adresse qui n’existe pas : un rebond définitif l’a montré. Elle est bloquée. Dans la liste de blocage : hard_bounce. |
| Plainte | Le signalement d’un message comme indésirable par son destinataire. |
| Coupe-circuit | La règle qui suspend une boîte quand trop de ses e-mails reviennent ou sont signalés. |
| Boîte suspendue | Une boîte que le coupe-circuit a arrêtée : elle reçoit, elle n’envoie plus. |
Technique
| Mot | Sens |
|---|---|
| MCP | Le protocole par lequel un agent appelle les outils du serveur. Voir Serveur MCP. |
| Outil | Une opération du serveur : send_email, list_threads… Voir la référence. |
| Objet structuré | Le résultat d’un outil sous forme de données : structuredContent par MCP, le corps de la réponse en HTTP. |
| Texte lisible | Le résultat d’un outil sous forme de phrases en français. |
| Vue | Ce qu’un assistant affiche avec le résultat de certains outils. Voir Vues. |
| Idempotence | Ce qui permet de réessayer un envoi sans créer un second message : idempotency_key. |
| Curseur | La valeur next_cursor d’une liste, à repasser dans cursor pour la page suivante. |
| Webhook | Un appel HTTP signé que le serveur envoie quand un événement arrive. Voir Webhooks. |
Cette page en Markdown : /docs/glossaire.md
Toute la documentation pour un agent : /llms.txt
Mentions légales · Conditions de vente · Confidentialité · Signaler un abus