Intramedial est en bêta restreinte. À l’inscription ou à la connexion, vous devez fournir le mot de passe de bêta-testeur que vous avez reçu ou en demander un à preview@intramedial.com. Merci.
Chargement…
roles.chartersModule 45
Module du plan
Roles and posts
Pourvoyez un poste d'un yard une fois, et laissez chaque dépendant se lier au rôle lui-même, pour que le titulaire puisse changer sans que rien de ce qui en dépend s'en aperçoive.
roles.charters lit les rôles utilitaires figés – yardmaster, steward, librarian, gatekeeper, clerk, auditor et treasurer – et les rôles applicatifs qu'un yard a déclarés. Un yard reçoit les sept pourvus automatiquement à sa création ; d'autres routes résolvent une tâche, transmettent un poste ou lisent son historique.
Les agents agissent quand le plan dit oui, et le registre dit pourquoi.
Faites passer actions d’agents, hash de contenu, contrôles d’API, requêtes DNS, webhooks, appels LLM et commits git par Intramedial. Obtenez un reçu signé vérifiable par tous – sans nous croire.
ÉtatREST uniquement, et en mémoire seule sans stockage
Aucune action ici n'a d'id MCP ni de contrat ; les rôles ne sont accessibles que par la surface REST brute. Sans POLICY_STORE lié, l'état des postes vit uniquement dans la mémoire de l'isolate et ne survit pas aux redémarrages.
Registre
Le registre
Ce qui est enregistré
role
Le nom du poste, comme gatekeeper ou un rôle applicatif déclaré par un yard.
yardId
Le yard auquel le poste appartient.
staffing
null si vacant, ou {by:"agent", did}, ou , chacun avec .
Les tâches qu'un rôle doit assurer, servant à valider toute dotation proposée pour lui.
history
Les transmissions qu'un poste a connues, de la plus ancienne à la plus récente.
posts
Chaque poste que list ou staff-yard renvoie pour un yard.
Mécanisme
Pas à pas
Comment ça marche
Un yard est pourvu à la création
Les actions create et fork de yards.list appellent la routine de dotation de ce module, qui pourvoit les sept postes utilitaires s'ils ne le sont pas déjà.
Adressé par rôle, pas par titulaire
get et resolve trouvent un poste par role et yardId seuls. Un appelant qui a stocké un DID a déjà rompu le contrat d'adressage de son côté.
La dotation est d'abord validée
staff et restaff vérifient que la dotation couvre toutes les tâches listées dans la charte du poste ; un point de service doit être en https, ni localhost, ni interne, ni une IP nue.
Les postes utilitaires ne peuvent pas rester vacants
vacate refuse sur un rôle utilitaire ; seul un rôle applicatif déclaré par un yard peut être libéré, car un yard sans gatekeeper a une porte ouverte, pas un simple manque de personnel.
Essayer
Démo en direct
Exécutez-le depuis cette page
GET/api/v1/acp/roles/charters
// Pas de corps : c’est un GET. Appuyez sur Exécuter.
S’exécute dans un workspace de démonstration partagé avec une clé de démonstration : tout le monde peut voir ce qu’il contient, n’envoyez donc rien de privé. Docs roles.charters
Réponses
Appuyez sur Exécuter pour envoyer la requête de gauche au workspace de démonstration partagé.
S’exécute dans un workspace de démonstration partagé avec une clé de démonstration : tout le monde peut voir ce qu’il contient, n’envoyez donc rien de privé.
Code
Exemple en direct
Une vraie requête
Une requête dans la forme acceptée par l’API, et un exemple de réponse dans la forme renvoyée par le module.
api.intramedial.com/api/v1/acp/roles/chartersGET
GET/api/v1/acp/roles/chartersAuthorization: Bearer av_workspace_••••→ 200 { utility, application, names } (there is no `charters` field; `utility` lists the seven frozen posts and `application` lists the ones a yard has declared)
restaff fait passer yardmaster du DID d'un agent à un autre sans toucher à rien de ce qui adresse le poste par rôle et yard, puisque l'adresse n'a pas changé.
Repérer une dotation insuffisante
Un opérateur tente de pourvoir treasurer avec un service qui ne couvre que budget, pas charge, forecast ni freeze. L'appel est refusé avec les tâches manquantes nommées.
Savoir qui répond d'une tâche en ce moment
resolve avec un duty indique quel poste la couvre et depuis quand, ou renvoie 409 si le poste est vacant plutôt que de deviner une valeur par défaut.
Lire l'historique de transmission d'un poste
history montre chaque titulaire qu'un poste a eu, utile pour retrouver quel agent pourvoyait clerk lors d'un incident.
Quand utiliser autre chose
Décider de ce qu'un agent peut faire. Un poste nomme qui répond d'un rôle ; les habilitations viennent des mandats compilés via coordination.admit.
Un nouveau compteur de facturation ou une action de catalogue. La dotation est incluse dans la création du yard, déjà mesurée à cet endroit.
Adresser un poste par le DID d'un agent. Les postes ne se trouvent que par role et yardId ; une recherche par DID n'est pas prise en charge.
Preuves
Garanties
Ce qu’il fait, et ce qu’il ne fait pas
Un module est une affirmation forte sur un sujet étroit. Fiez-vous-y exactement pour ce qu’il est.
Il le fait
Les sept postes utilitaires d'un yard existent dès sa création, pourvus par défaut vers des points d'accès de modules de l'arbre sauf re-dotation.
Une dotation proposée pour un poste n'est acceptée que si elle nomme chaque tâche exigée par la charte du poste ; une dotation partielle est refusée avec les manques listés.
Un poste utilitaire ne peut jamais rester vacant ; vacate le refuse et ne réussit que pour un rôle applicatif déclaré par le yard lui-même.
Il ne le fait pas
Qu'un agent ou service pourvu est réellement joignable ou se comporte bien. La dotation est un registre de qui répond d'un rôle, pas un contrôle de santé.
Que l'état survit à un redémarrage. Sans stockage de politique lié, les postes ne vivent que dans la mémoire de l'isolate.
Qui est responsable d'une transmission. restaff garde la dotation précédente et la nouvelle, mais pas qui a fait le changement.
Détails
Notes de conception
Avant de construire
Une écriture réessaie, puis abandonne honnêtement
Une écriture sur le stockage de politique réessaie jusqu'à cinq fois en cas de changement concurrent avant de répondre 503, plutôt que de réessayer indéfiniment ou d'abandonner l'écriture en silence.
La dotation par défaut pointe vers l'arbre
Avant que quiconque re-pourvoie un poste, il répond à un point d'accès de module de l'arbre, comme clerk qui pointe par défaut vers le module de registre, donc un yard neuf n'est jamais pourvu de rien.
Catalogue figé volontairement
Ce module n'ajoute aucune action au catalogue figé ni aucun compteur de facturation ; la dotation s'appuie sur le compteur de création de yard.
Limites et mesure
Aucune action ici n'a d'id d'action MCP ou de contrat ; elle n'est accessible qu'en REST.
Un point de service affecté à un poste doit être en https, avec un vrai nom d'hôte ; localhost, .local, .internal, une IPv4 nue ou un littéral IPv6 nu sont tous refusés.
restaff refuse si le poste n'est pas déjà pourvu ; utilisez staff pour une première affectation.
Accès
API et MCP
REST et MCP
Authentifiez-vous avec une clé d’API d’espace de travail comme jeton Bearer. L’URL de base est https://api.intramedial.com.
Points d’accès REST
GET/api/v1/acp/roles/chartersLire les rôles utilitaires figés et ceux déclarés par ce yard.
GET/api/v1/acp/roles/listLister les postes d'un yard et combien sont pourvus, par type.
Actions MCP
Ce module n’a aucune action MCP. Appelez-le via REST depuis n’importe quel agent ou programme.
Module du plan
