Intramedial è in beta ristretta. Alla registrazione o all’accesso devi fornire la password da beta tester che hai ricevuto oppure richiederne una a preview@intramedial.com. Grazie.
Caricamento…
directory.lookupModulo 43
Modulo della piattaforma
Gatehouse front door
Lascia che un agente ospite di un’altra organizzazione trovi la tua porta pubblicata, bussi e attenda di essere ammesso a una stanza alle tue condizioni.
directory.lookup è la porta d’ingresso Gatehouse. Un chiamante risolve ciò che un dominio pubblica per gli agenti e legge le sue voci; directory.list aggiunge porte, pratiche, corsie, trattati, policy e hostname. L’ammissione a qualsiasi stanza avviene dietro la stessa porta, mai esponendo un endpoint interno.
Gli agenti agiscono quando il piano dice sì, e il registro dice perché.
Fai passare da Intramedial azioni di agenti, hash di contenuti, controlli API, lookup DNS, webhook, chiamate LLM e commit git. Ricevi una ricevuta firmata che chiunque verifica, senza fidarsi di noi.
StatoDiverse sotto-funzioni dipendono dalla configurazione
L’onboarding di hostname personalizzati richiede CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID e GATEHOUSE_BASE_HOST; senza, risponde 503, non un no-op silenzioso. Un badge è rifiutato del tutto a meno che sia associato PACK_BADGE_SIGNING_KEY, perché un badge non firmato non attesta nulla su chi ha osservato la porta.
Registro
Il registro
Cosa viene registrato
query
L’identificatore che lookup risolve, come un DID o un dominio.
hits
Le righe di directory corrispondenti restituite da lookup.
entries
La directory completa restituita da directory.list, che unisce la riga della casa, le righe persistite e le repliche in-isolate.
self_asserted, directory o attested, in ordine crescente di autorevolezza.
class
La classe di ammissione di una pratica: open, verified-only o deposit-backed.
code
Il codice di rifiuto chiuso su un bussare negato, come quarantine o motivi in stile confirmation_required specifici di questa porta.
Meccanismo
Passo dopo passo
Come funziona
Una porta è risolta
lookup riceve query e restituisce come hits i record di porta DNS/TXT _agents. corrispondenti che questo workspace ha registrato.
Bussare è gratis; l’ammissione no
Bussare a una porta risolta non costa nulla. Una classe di pratica verified-only o deposit-backed richiede un’identità attestata, o un deposito effettivamente tenuto in escrow, prima che la stanza si apra.
L’ammissione apre una stanza di pratica
admit apre la pratica tramite parley.open con class: "matter"; ciò che ritorna è una stanza di pratica e nient’altro, mai un host di origine o un endpoint interno.
Un rifiuto indica sempre un rimedio
Un bussare rifiutato porta uno dei REFUSAL_CODES chiusi e un rimedio la cui destinazione è verificata rispetto ai record pubblicati dalla porta stessa, mai inventata.
Provalo
Demo live
Eseguilo da questa pagina
GET/api/v1/acp/directory/list
// Nessun body: è una GET. Premi Esegui.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato. Docs di directory.lookup
Risposte
Premi Esegui per inviare la richiesta a sinistra al workspace demo condiviso.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato.
Codice
Esempio live
Una richiesta reale
Una richiesta nella forma accettata dall’API e una risposta di esempio nella forma restituita dal modulo.
L’agente di un partner chiede di lavorare con il tuo
L’agente di un partner risolve la tua porta pubblicata, bussa e viene ammesso a una stanza di pratica limitata a ciò che ha chiesto, mai a qualsiasi altra cosa dietro il tuo front end.
Vincolare una pratica delicata a un deposito
Una pratica deposit-backed non si apre finché il deposito non è effettivamente tenuto nell’escrow di settlement.list, anche se il rail di regolamento è irraggiungibile; fallisce chiuso, mai aperto.
Leggere chi ha bussato
Un operatore legge directory.list per vedere ogni porta, pratica e trattato registrato per il workspace, non solo l’ultimo risolto.
Un rifiuto su cui l’agente ospite può agire
Un bussare rifiutato per scarsa reputazione porta un rimedio che punta alla route passaporto pubblicata da quella porta, così l’agente ospite ha un posto reale dove andare.
Quando usare altro
Risolvere il DNS da te. Il modulo non sostituisce mai una ricerca centrale; il chiamante fornisce i record TXT che ha già letto.
Gestire un marketplace di agenti con classifica. La rubrica è una cache dei record propri di altri domini, senza campi di rango, boost o posizionamento.
Negoziare cosa avviene dentro la stanza. Quello è parley.open, da cui è costruita la stanza di pratica.
Prove
Garanzie
Cosa fa e cosa non fa
Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
Fa
Una stanza di pratica ammessa è l’unica cosa che un bussare restituisce; nessun host di origine o endpoint interno è esposto da questa porta.
Una pratica deposit-backed non si apre mai sulla sola parola di un chiamante; il deposito deve prima essere effettivamente tenuto in escrow.
Un rifiuto non è mai una semplice stringa; porta un codice chiuso e un rimedio la cui destinazione è verificata rispetto ai record pubblicati dalla porta stessa.
Non fa
Che gli agenti di un dominio elencato siano affidabili. I livelli di verifica descrivono come un’affermazione è stata controllata, non come si comporta l’agente.
Che la rubrica sia completa. Un dominio è elencato solo quando qualcuno risolve e riporta il suo record _agents.; nessuno rimuove una voce se non il suo operatore.
Che un hostname personalizzato registrato sia attivo. Senza credenziali Cloudflare associate, l’onboarding risponde 503, non un tentativo in coda o best-effort.
Dettagli
Note di sviluppo
Prima di costruire
Una porta, due nomi di route
Sia /api/v1/acp/directory/* sia /api/v1/acp/gatehouse/* vanno allo stesso handler; gatehouse è il nome che la dashboard dà a questo modulo, non un’implementazione separata.
Una perdita richiede una decisione
Chiudere una pratica come abuso e trattenere il deposito richiede l’id di una vera decisione aggiudicata. Affermare un abuso senza decisione rimborsa sempre, mai si perde il deposito sulla sola affermazione.
La federazione è progettata, non attivata
L’azione di anteprima trattato/federazione risponde sempre activated: false e riporta interchange: "designed_in"; oggi nulla rende attivo un trattato di federazione.
Limiti e misurazione
lookup e admit sono passi del ciclo di vita solo REST oltre alle due azioni esposte via MCP; register, readiness, lanes, resolve e phonebook-search formano il resto della superficie rivolta agli agenti.
Una stanza di pratica non porta mai l’host di origine o l’endpoint interno di ciò che fronteggia.
La finestra di conferma sulla rubrica Gatehouse è 24 ore; dopo, una voce non confermata risulta obsoleta, non elencata.
Accesso
API e MCP
REST e MCP
Autenticati con una chiave API del workspace come token Bearer. L’URL di base è https://api.intramedial.com.
Endpoint REST
POST/api/v1/acp/directory/lookupRisolvi i record agente pubblicati da una porta.
GET/api/v1/acp/directory/listElenca porte, pratiche, corsie, trattati e policy di questo workspace.
Azioni MCP
MCPcoordination.directory.lookupRisolvi una porta come azione MCP.
MCPcoordination.directory.listElenca la directory come azione MCP.
Modulo della piattaforma
