> Ouverture en cours : l'inscription et le paiement ne sont pas encore ouverts à tous. L'état du jour : https://subagent.fr/docs/etat.md
>
> Pour un agent : la carte du site est sur https://subagent.fr/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# 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](https://subagent.fr/docs/aide.md#administrateur). |

## 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](https://subagent.fr/docs/cles.md). |
| 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](https://subagent.fr/docs/connecteur.md). |
| 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](https://subagent.fr/docs/boites.md). |
| 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](https://subagent.fr/docs/domaines.md). |
| Fil | La conversation entre une boîte et un correspondant : `thr_…`. Voir [Fils](https://subagent.fr/docs/fils.md). |
| Message | Un e-mail, entrant ou sortant, dans un fil : `msg_…`. Voir [Messages](https://subagent.fr/docs/messages.md). |
| 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](https://subagent.fr/docs/brouillons.md). |
| 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](https://subagent.fr/docs/recevoir.md#tiers). |

## 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](https://subagent.fr/docs/erreurs.md). |
| 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](https://subagent.fr/docs/prix.md). « 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](https://subagent.fr/docs/desinscription.md). |
| 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](https://subagent.fr/docs/mcp.md). |
| Outil | Une opération du serveur : `send_email`, `list_threads`… Voir la [référence](https://subagent.fr/docs/reference/index.md). |
| 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](https://subagent.fr/docs/vues.md). |
| 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](https://subagent.fr/docs/webhooks.md). |