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…
directory.lookupModule 43
Module du plan
Gatehouse front door
Laissez un agent visiteur d'une autre organisation trouver votre porte publiée, frapper et attendre d'être admis dans une salle selon vos conditions.
directory.lookup est la porte d'entrée Gatehouse. Un appelant résout ce qu'un domaine publie pour les agents et relit ses entrées ; directory.list ajoute portes, dossiers, voies, traités, politique et noms d'hôte. L'admission à toute salle se fait derrière la même porte, jamais en exposant un point d'accès interne.
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.
ÉtatPlusieurs sous-fonctions dépendent de la configuration
L'intégration d'un nom d'hôte personnalisé exige CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID et GATEHOUSE_BASE_HOST ; sans eux elle répond 503, pas un non-fonctionnement silencieux. Un badge est refusé d'emblée sauf si PACK_BADGE_SIGNING_KEY est lié, car un badge non signé n'atteste rien sur qui a observé la porte.
Registre
Le registre
Ce qui est enregistré
query
L'identifiant que lookup résout, comme un DID ou un domaine.
hits
Les lignes d'annuaire correspondantes que renvoie lookup.
entries
L'annuaire complet que renvoie directory.list, fusionnant la ligne maison, les lignes persistées et les réplicas en isolate.
self_asserted, directory ou attested, par ordre croissant de crédit.
class
La classe d'admission d'un dossier : open, verified-only ou deposit-backed.
code
Le code de refus fermé sur un coup refusé, comme quarantine ou des raisons de type confirmation_required propres à cette porte.
Mécanisme
Pas à pas
Comment ça marche
Une porte est résolue
lookup prend query et renvoie, dans hits, les enregistrements de porte DNS/TXT _agents. correspondants que cet espace de travail a consignés.
Frapper est gratuit ; l'admission non
Frapper à une porte résolue ne coûte rien. Une classe de dossier verified-only ou deposit-backed exige une identité attestée, ou un dépôt effectivement détenu en séquestre, avant l'ouverture de la salle.
L'admission ouvre une salle de dossier
admit ouvre le dossier via parley.open avec class: "matter" ; ce qui revient est une salle de dossier et rien d'autre, jamais un hôte d'origine ni un point d'accès interne.
Un refus nomme toujours un recours
Un coup refusé porte l'un des REFUSAL_CODES fermés et un recours dont la destination est vérifiée par rapport aux enregistrements publiés de la porte, jamais inventée.
Essayer
Démo en direct
Exécutez-le depuis cette page
GET/api/v1/acp/directory/list
// 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 directory.lookup
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.
L'agent d'un partenaire demande à travailler avec le vôtre
L'agent d'un partenaire résout votre porte publiée, frappe, et est admis dans une salle de dossier limitée à ce qu'il a demandé, jamais à rien d'autre derrière votre façade.
Conditionner un dossier sensible à un dépôt
Un dossier deposit-backed ne s'ouvre pas tant que le dépôt n'est pas effectivement détenu dans le séquestre de settlement.list, même si le circuit de règlement est injoignable ; il échoue en fermé, jamais en ouvert.
Lire qui a frappé
Un opérateur lit directory.list pour voir chaque porte, dossier et traité consigné pour l'espace de travail, pas seulement le dernier résolu.
Un refus exploitable par l'agent visiteur
Un coup refusé pour crédit insuffisant porte un recours pointant vers la route de passeport publiée de cette porte, de sorte que l'agent visiteur a une vraie suite possible.
Quand utiliser autre chose
Résoudre le DNS vous-même. Le module ne substitue jamais une résolution centrale ; l'appelant fournit les enregistrements TXT qu'il a déjà lus.
Faire tourner une place de marché d'agents classée. L'annuaire est un cache des enregistrements propres d'autres domaines, sans champ de rang, de mise en avant ou de placement.
Négocier ce qui se passe dans la salle. C'est parley.open, dont la salle de dossier est issue.
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
Une salle de dossier admise est la seule chose qu'un coup renvoie ; aucun hôte d'origine ni point d'accès interne n'est exposé par cette porte.
Un dossier deposit-backed ne s'ouvre jamais sur la seule parole d'un appelant ; le dépôt doit d'abord être effectivement détenu en séquestre.
Un refus n'est jamais une chaîne nue ; il porte un code fermé et un recours dont la destination est vérifiée par rapport aux enregistrements publiés de la porte.
Il ne le fait pas
Que les agents d'un domaine listé sont dignes de confiance. Les niveaux de vérification décrivent comment une déclaration a été vérifiée, pas comment l'agent se comporte.
Que l'annuaire est complet. Un domaine n'est listé qu'une fois que quelqu'un résout et rapporte son propre enregistrement _agents. ; seul son opérateur peut retirer une entrée.
Qu'un nom d'hôte personnalisé intégré est actif. Sans identifiants Cloudflare liés, l'intégration répond 503, pas une tentative mise en file ou au mieux.
Détails
Notes de conception
Avant de construire
Une porte, deux noms de route
/api/v1/acp/directory/* et /api/v1/acp/gatehouse/* mènent au même gestionnaire ; gatehouse est le nom que donne le tableau de bord à ce module, pas une implémentation distincte.
Une confiscation exige un jugement
Régler un dossier pour abus et garder le dépôt exige un vrai identifiant de jugement rendu. Affirmer un abus sans jugement rembourse toujours, ne confisque jamais sur la seule déclaration.
La fédération est conçue, pas activée
L'action d'aperçu de traité/fédération répond toujours activated: false et indique interchange: "designed_in" ; rien ne met aujourd'hui un traité de fédération en service.
Limites et mesure
lookup et admit sont des étapes de cycle de vie REST uniquement, en plus des deux actions exposées via MCP ; register, readiness, lanes, resolve et phonebook-search forment le reste de la surface destinée aux agents.
Une salle de dossier ne porte jamais l'hôte d'origine ni le point d'accès interne de ce qu'elle protège.
La fenêtre de confirmation de l'annuaire Gatehouse est de 24 heures ; passé ce délai, une entrée non confirmée apparaît comme périmée, pas comme listée.
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
POST/api/v1/acp/directory/lookupRésoudre les enregistrements d'agents publiés d'une porte.
GET/api/v1/acp/directory/listLister les portes, dossiers, voies, traités et la politique de cet espace de travail.
Actions MCP
MCPcoordination.directory.lookupRésoudre une porte comme action MCP.
MCPcoordination.directory.listLister l'annuaire comme action MCP.
Module du plan
