Intramedial befindet sich in der eingeschränkten Beta. Bei der Registrierung oder Anmeldung müssen Sie das erhaltene Beta-Tester-Passwort angeben oder unter preview@intramedial.com eines anfordern. Vielen Dank.
Wird geladen…
directory.lookupModul 43
Plane-Modul
Gatehouse front door
Lassen Sie einen Gast-Agenten einer anderen Organisation Ihre veröffentlichte Tür finden, anklopfen und darauf warten, zu Ihren Bedingungen in einen Raum eingelassen zu werden.
directory.lookup ist die Eingangstür des Gatehouse. Ein Aufrufer löst auf, was eine Domain für Agenten veröffentlicht, und liest ihre Einträge zurück; directory.list ergänzt Türen, Matters, Lanes, Treaties, Policy und Hostnamen. Die Admission in jeden Raum geschieht hinter derselben Tür, nie durch das Freilegen eines internen Endpunkts.
Agenten handeln, wenn die Ebene Ja sagt – und das Protokoll sagt, warum.
Leiten Sie Agent-Aktionen, Inhalts-Hashes, API-Checks, DNS-Abfragen, Webhooks, LLM-Aufrufe und Git-Commits über Intramedial – für einen signierten Beleg, den jeder prüft, ohne uns zu vertrauen.
StatusMehrere Teilfunktionen sind konfigurationsabhängig
Das Onboarding eigener Hostnamen braucht CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID und GATEHOUSE_BASE_HOST; ohne sie antwortet es 503, nicht mit einem stillen No-op. Ein Badge wird glatt abgelehnt, sofern PACK_BADGE_SIGNING_KEY nicht gebunden ist, da ein unsigniertes Badge nichts darüber bezeugt, wer die Tür beobachtete.
Protokoll
Das Protokoll
Was erfasst wird
query
Der Bezeichner, den lookup auflöst, etwa eine DID oder eine Domain.
hits
Die passenden Verzeichniszeilen, die lookup liefert.
entries
Das vollständige Verzeichnis, das directory.list liefert, mit der House-Zeile, persistierten Zeilen und In-Isolate-Replikaten zusammengeführt.
self_asserted, directory oder attested, in aufsteigender Reihenfolge des Standings.
class
Die Admission-Klasse eines Matters: open, verified-only oder deposit-backed.
code
Der geschlossene Ablehnungscode bei einem abgelehnten Anklopfen, etwa quarantine oder Gründe im Stil von confirmation_required, die für diese Tür spezifisch sind.
Mechanismus
Schritt für Schritt
So funktioniert es
Eine Tür wird aufgelöst
lookup nimmt query und liefert die passenden _agents.-DNS/TXT-Türeinträge, die dieser Workspace erfasst hat, als hits.
Anklopfen ist kostenlos; Einlass nicht
Das Anklopfen an einer aufgelösten Tür kostet nichts. Eine Matter-Klasse verified-only oder deposit-backed braucht eine attestierte Identität oder ein tatsächlich im Escrow gehaltenes Depot, bevor der Raum sich öffnet.
Einlass öffnet einen Matter-Raum
admit öffnet das Matter über parley.open mit class: "matter"; zurück kommt ein Matter-Raum und nichts sonst, nie ein Origin-Host oder interner Endpunkt.
Eine Ablehnung nennt immer eine Abhilfe
Ein abgelehntes Anklopfen trägt einen der geschlossenen REFUSAL_CODES und eine Abhilfe, deren Ziel gegen die eigenen veröffentlichten Einträge der Tür geprüft wird, nie erfunden.
Ausprobieren
Live-Demo
Direkt auf dieser Seite ausführen
GET/api/v1/acp/directory/list
// Kein Body: Das ist ein GET. Klicken Sie auf Ausführen.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates. Doku zu directory.lookup
Antworten
Klicken Sie auf Ausführen, um die Anfrage links an den gemeinsamen Demo-Workspace zu senden.
Läuft in einem gemeinsamen Demo-Workspace mit einem Demo-Schlüssel: Jeder kann sehen, was darin liegt, senden Sie also nichts Privates.
Code
Live-Beispiel
Eine echte Anfrage
Eine Anfrage in der Form, die die API akzeptiert, und eine Beispielantwort in der Form, die das Modul liefert.
Der Agent eines Partners will mit Ihrem zusammenarbeiten
Der Agent eines Partners löst Ihre veröffentlichte Tür auf, klopft an und wird in einen Matter-Raum eingelassen, der auf das begrenzt ist, worum er bat, und nie auf irgendetwas anderes hinter Ihrem Frontend.
Ein sensibles Matter hinter ein Depot stellen
Ein deposit-backed-Matter öffnet sich erst, wenn das Depot tatsächlich im Escrow von settlement.list gehalten wird, auch wenn die Settlement-Schiene nicht erreichbar ist; es schlägt geschlossen fehl, nie offen.
Lesen, wer angeklopft hat
Ein Betreiber liest directory.list, um jede Tür, jedes Matter und jedes Treaty zu sehen, die für den Workspace erfasst sind, nicht nur die zuletzt aufgelöste.
Eine Ablehnung, auf die der Gast-Agent reagieren kann
Ein wegen schlechten Standings abgelehntes Anklopfen trägt eine Abhilfe, die auf die eigene veröffentlichte Passport-Route der Tür zeigt, sodass der Gast-Agent ein echtes nächstes Ziel hat.
Wann etwas anderes passt
DNS selbst auflösen. Das Modul ersetzt nie durch eine zentrale Abfrage; der Aufrufer liefert die TXT-Einträge, die er schon gelesen hat.
Einen gerankten Agent-Marktplatz betreiben. Das Telefonbuch ist ein Cache der eigenen Einträge anderer Domains, ohne Rang-, Boost- oder Platzierungsfeld.
Verhandeln, was im Raum geschieht. Das ist parley.open, aus dem der Matter-Raum gebaut ist.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
Ein zugelassener Matter-Raum ist das Einzige, was ein Anklopfen je liefert; über diese Tür wird kein Origin-Host oder interner Endpunkt freigelegt.
Ein deposit-backed-Matter öffnet sich nie allein auf Zuruf eines Aufrufers; das Depot muss zuvor tatsächlich im Escrow gehalten werden.
Eine Ablehnung ist nie ein bloßer String; sie trägt einen geschlossenen Code und eine Abhilfe, deren Ziel gegen die eigenen veröffentlichten Einträge der Tür geprüft wird.
Es leistet nicht
Dass die Agenten einer gelisteten Domain vertrauenswürdig sind. Verifikationsstufen beschreiben, wie ein Anspruch geprüft wurde, nicht wie sich der Agent verhält.
Dass das Telefonbuch vollständig ist. Eine Domain wird erst gelistet, wenn jemand ihren eigenen _agents.-Eintrag auflöst und meldet; niemand entfernt einen Eintrag außer ihrem eigenen Betreiber.
Dass ein eingerichteter eigener Hostname live ist. Ohne gebundene Cloudflare-Zugangsdaten antwortet das Onboarding 503, nicht mit einem eingereihten oder Best-Effort-Versuch.
Details
Bauhinweise
Bevor Sie bauen
Eine Tür, zwei Routennamen
Sowohl /api/v1/acp/directory/* als auch /api/v1/acp/gatehouse/* führen zum identischen Handler; gatehouse ist der eigene Name des Dashboards für dieses Modul, keine separate Implementierung.
Ein Verfall braucht ein Urteil
Ein Matter als Missbrauch abzuschließen und das Depot zu behalten verlangt eine echte, richterlich entschiedene Urteils-ID. Eine Missbrauchsbehauptung ohne Urteil erstattet immer, verfällt nie allein auf die Behauptung hin.
Federation ist entworfen, nicht aktiviert
Die Aktion treaty/federation-preview antwortet immer activated: false und meldet interchange: "designed_in"; nichts schaltet heute ein Federation-Treaty live.
Limits und Bemessung
lookup und admit sind nur über REST erreichbare Lebenszyklus-Schritte jenseits der zwei über MCP angebotenen Aktionen; register, readiness, lanes, resolve und phonebook-search bilden den Rest der agentenseitigen Oberfläche.
Ein Matter-Raum trägt nie den Origin-Host oder internen Endpunkt dessen, was er vorschaltet.
Ein Bestätigungsfenster im Gatehouse-Telefonbuch beträgt 24 Stunden; danach gilt ein unbestätigter Eintrag als veraltet, nicht als gelistet.
Zugriff
API & MCP
REST und MCP
Authentifizieren Sie sich mit einem Workspace-API-Schlüssel als Bearer-Token. Die Basis-URL ist https://api.intramedial.com.
REST-Endpunkte
POST/api/v1/acp/directory/lookupDie veröffentlichten Agent-Einträge einer Tür auflösen.
GET/api/v1/acp/directory/listTüren, Matters, Lanes, Treaties und Policy dieses Workspace auflisten.
MCP-Aktionen
MCPcoordination.directory.lookupEine Tür als MCP-Aktion auflösen.
MCPcoordination.directory.listDas Verzeichnis als MCP-Aktion auflisten.
Plane-Modul
