Déclarer les abonnements de vos agents
Nécessite @openlatch/client 0.11.11 ou une version ultérieure
Utilisez Settings › General › Agent Subscriptions pour déclarer les abonnements que votre entreprise paie, afin que les agents qui travaillent dessus soient lus Sanctioned et les autres Shadow. Il vous faut le rôle admin ou supérieur ; la page n’est pas affichée aux éditeurs ni aux lecteurs. Pour ce que veulent dire les deux statuts, lisez Agents Sanctioned et Shadow.
Tant que vous n’avez déclaré aucun abonnement, chaque agent est lu Shadow et aucune alerte Shadow n’est envoyée.
Déclarer un abonnement
Section intitulée « Déclarer un abonnement »- Choisissez Add subscription.
- Choisissez le Kind, comme Anthropic org, ChatGPT workspace ou Cursor team.
- Choisissez le Subscription ID parmi les ID que vos agents signalent pour ce type, avec le nombre d’agents sur chacun et la date à laquelle il a été vu pour la dernière fois, ou saisissez-en un. Un ID saisi est vérifié selon le format du type avant d’être enregistré.
- Donnez-lui un Label de 80 caractères au plus, comme « Acme engineering Claude org ». Le libellé est ce qu’affichent l’en-tête de l’agent et le budget.
- Sous Allowed org units, choisissez Whole organization, ou Selected org units et choisissez au moins une unité. Une unité couvre toutes les unités en dessous d’elle.
- Si vous le souhaitez, définissez un Default monthly budget per agent, puis choisissez Save.
Le Subscription ID est un identifiant d’organisation, d’équipe ou de compte, jamais une clé d’API ni un jeton : chaque rôle le voit sur la page de l’agent, et le journal d’audit le conserve. Un ID qu’aucun agent ne signale encore est enregistré et marqué Not observed yet.
Chaque type et Subscription ID ne peut être déclaré qu’une fois. Vous pouvez déclarer plusieurs abonnements du même type, et le même ID sous deux types fait deux déclarations. Une organisation compte au plus 500 déclarations, et chaque déclaration au plus 200 unités organisationnelles.
Formats des Subscription ID
Section intitulée « Formats des Subscription ID »| Type | Format |
|---|---|
| Anthropic org · ChatGPT workspace | Un UUID |
| Azure OpenAI resource | Un nom d’hôte seul, sans schéma, port ni chemin |
| Gateway | Un nom d’hôte seul. L’hôte d’API propre à un fournisseur de modèles est refusé |
| GitHub enterprise | Le slug de l’entreprise, ou son nom d’hôte se terminant par .ghe.com |
| GitHub org | Le slug de l’organisation : lettres, chiffres et tirets simples, 39 caractères au plus |
| GCP project | L’ID du projet : de 6 à 30 caractères, commençant par une lettre minuscule |
| AWS account | L’ID de compte à 12 chiffres |
| Cursor team | L’ID de l’équipe, tel que la console d’administration de Cursor l’affiche |
| Cline org | L’ID de l’organisation : lettres, chiffres, tirets et tirets bas, 128 caractères au plus |
La casse ne compte pas, sauf pour les ID Cursor team et Cline org, qui doivent correspondre exactement. GitHub enterprise et GitHub org sont réservés à GitHub Copilot, qui n’est pas encore pris en charge, donc aucun agent ne les signale encore.
Modifier ou supprimer une déclaration
Section intitulée « Modifier ou supprimer une déclaration »Ouvrez les actions d’une déclaration pour la modifier ou la supprimer. Vous pouvez changer son libellé, ses unités organisationnelles autorisées et son budget par défaut ; son type et son Subscription ID ne peuvent pas changer, donc pour les changer, supprimez la déclaration et ajoutez-la de nouveau. Pour en supprimer plusieurs, sélectionnez-les dans le tableau et choisissez Delete.
| Changement | Effet sur les agents |
|---|---|
| Ajouter une déclaration, ou autoriser plus d’unités organisationnelles | Les agents qui l’utilisent sont lus Sanctioned aussitôt, sans alerte. Votre première déclaration vérifie aussi chaque agent et envoie une notification qui compte les agents Shadow |
| Supprimer une déclaration, ou autoriser moins d’unités organisationnelles | Les agents qu’elle ne couvre plus sont lus Shadow aussitôt, et une notification compte ceux qui n’ont pas été alertés dans les dernières 24 heures |
| Changer seulement le libellé ou le budget par défaut | Aucun agent ne change de statut |
Chaque déclaration que vous ajoutez, modifiez ou supprimez est enregistrée dans le journal d’audit, et figure dans son export.
Quand une unité organisationnelle d’une déclaration est supprimée, le tableau la marque Deleted org unit et la déclaration la conserve : l’unité ne correspond à aucun agent, et un périmètre n’est jamais élargi à toute l’organisation par une suppression. Quand toutes les unités d’une déclaration sont supprimées, la page avertit qu’elle ne correspond à aucun agent tant que vous n’avez pas modifié ses unités organisationnelles autorisées. Vous pouvez retirer une unité supprimée de la déclaration quand vous la modifiez.
Définir les budgets par défaut
Section intitulée « Définir les budgets par défaut »Le budget mensuel par défaut de l’organisation se définit dans la section Agent Budgets de cette page. Un agent utilise d’abord son propre budget, puis le budget par défaut de l’abonnement officiel sur lequel il est Sanctioned, puis le budget par défaut de l’organisation :
| Agent | Budget qu’il utilise |
|---|---|
| A son propre budget | Son propre budget |
| Pas de budget propre, Sanctioned sur un abonnement avec un budget par défaut | Le budget par défaut de cet abonnement, affiché comme « Default of » suivi du libellé de l’abonnement |
| Pas de budget propre, Shadow, ou Sanctioned sur un abonnement sans budget par défaut | Le budget par défaut de l’organisation, s’il est défini |
Chaque budget par défaut s’applique à chaque agent séparément : un défaut de 500 $ donne à chaque agent 500 $ par mois, pas 500 $ partagés. Effacer un budget par défaut n’écrase jamais un budget défini sur un agent. Le budget propre d’un agent se définit depuis son onglet Economics ; voir Suivre les dépenses d’un agent.
Lire le statut d’un agent
Section intitulée « Lire le statut d’un agent »Ouvrez un agent : son en-tête affiche Sanctioned ou Shadow avec sa raison, comme Shadow · Subscription not official. Survolez le statut ou placez-y le focus pour ses détails, comme l’abonnement que l’agent a signalé en dernier et la date à laquelle il a été observé. Pour un abonnement non déclaré, un administrateur lit aussi où le déclarer. Chaque rôle peut lire le statut.
| Ce que vous lisez | Ce qu’il faut faire |
|---|---|
| Shadow · Subscription not official | Si l’abonnement est l’un de ceux que votre entreprise paie, déclarez-le. Sinon, demandez au propriétaire de l’agent de passer à un abonnement officiel |
| Shadow · Org unit not allowed | Autorisez l’abonnement pour l’unité organisationnelle du propriétaire, ou vérifiez le propriétaire de l’agent dans son onglet Identity |
| Shadow · User can’t be placed | Placez le propriétaire dans une unité organisationnelle, ou autorisez l’abonnement pour toute l’organisation |
| Shadow · Subscription can’t be determined | L’agent ne signale aucun abonnement, par exemple avec une clé d’API brute. Aucune déclaration n’y change rien |
- Une clé d’API brute ne révèle aucune organisation, donc un agent qui en utilise une est lu Subscription can’t be determined.
- Un nom d’hôte de passerelle partagé n’identifie aucune entreprise, et une déclaration Gateway ne couvre que les agents Claude Code, Codex CLI et Cline.
- La collecte des signaux d’identité n’est pas nécessaire : la comparaison utilise l’identifiant d’abonnement, jamais une adresse e-mail.
- Sanctioned veut dire que l’agent signale un abonnement officiel, pas que son compte est vérifié.
- Seuls les agents des hôtes qui exécutent le client sont classés.
Pour choisir les canaux qui reçoivent la notification Shadow agent detected, voir Configurer les canaux de notification.