Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
directory.lookupMódulo 43
Módulo de la plataforma
Gatehouse front door
Deja que un agente visitante de otra organización encuentre tu puerta publicada, llame y espere a ser admitido en una sala en tus condiciones.
directory.lookup es la puerta principal de Gatehouse. Quien llama resuelve lo que un dominio publica para agentes y lee sus entradas; directory.list añade puertas, asuntos, vías, tratados, política y hostnames. La admisión a cualquier sala ocurre tras la misma puerta, nunca exponiendo un endpoint interno.
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
EstadoVarias subfunciones dependen de configuración
El alta de hostnames personalizados necesita CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID y GATEHOUSE_BASE_HOST; sin ellos responde 503, no un no-op silencioso. Una insignia se rechaza sin más salvo que PACK_BADGE_SIGNING_KEY esté vinculada, ya que una insignia sin firmar no atestigua nada sobre quién observó la puerta.
Registro
El registro
Qué se registra
query
El identificador que resuelve lookup, como un DID o un dominio.
hits
Las filas de directorio coincidentes que devuelve lookup.
entries
El directorio completo que devuelve directory.list, combinando la fila de la casa, las filas persistidas y las réplicas en el isolate.
self_asserted, directory o attested, en orden ascendente de solidez.
class
La clase de admisión de un asunto: open, verified-only o deposit-backed.
code
El código de rechazo cerrado en una llamada denegada, como quarantine o motivos del estilo de confirmation_required propios de esta puerta.
Mecanismo
Paso a paso
Cómo funciona
Se resuelve una puerta
lookup recibe query y devuelve los registros de puerta DNS/TXT _agents. coincidentes que este workspace ha registrado, como hits.
Llamar es gratis; la admisión no
Llamar a una puerta resuelta no cuesta nada. Una clase de asunto verified-only o deposit-backed necesita identidad atestada, o un depósito realmente retenido en custodia, antes de abrir la sala.
La admisión abre una sala de asunto
admit abre el asunto mediante parley.open con class: "matter"; lo que vuelve es una sala de asunto y nada más, nunca un host de origen ni un endpoint interno.
Un rechazo siempre nombra un remedio
Una llamada rechazada lleva uno de los REFUSAL_CODES cerrados y un remedio cuyo destino se comprueba contra los registros publicados de la propia puerta, nunca inventado.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/directory/list
// Sin cuerpo: esto es un GET. Pulsa Ejecutar.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado. Docs de directory.lookup
Respuestas
Pulsa Ejecutar para enviar la solicitud de la izquierda al workspace de demostración compartido.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
El agente de un socio resuelve tu puerta publicada, llama y es admitido en una sala de asunto acotada a lo que pidió, nunca a nada más detrás de tu front end.
Condicionar un asunto sensible a un depósito
Un asunto deposit-backed no se abre hasta que el depósito está realmente retenido en la custodia de settlement.list, incluso si la vía de liquidación no responde; falla cerrado, nunca abierto.
Leer quién llamó
Un operador lee directory.list para ver cada puerta, asunto y tratado registrado en el workspace, no solo el resuelto más recientemente.
Un rechazo sobre el que el agente visitante puede actuar
Una llamada rechazada por mala reputación lleva un remedio que apunta a la propia ruta de pasaporte publicada de esa puerta, para que el agente visitante tenga un destino real al que ir.
Cuándo usar otra cosa
Resolver DNS tú mismo. El módulo nunca sustituye una búsqueda central; quien llama aporta los registros TXT que ya leyó.
Ejecutar un marketplace de agentes con ranking. La guía es una caché de los registros propios de otros dominios, sin campos de ranking, impulso ni posicionamiento.
Negociar lo que ocurre dentro de la sala. Eso es parley.open, con el que se construye la sala de asunto.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
Una sala de asunto admitida es lo único que devuelve una llamada; ningún host de origen ni endpoint interno se expone por esta puerta.
Un asunto deposit-backed nunca se abre solo por la palabra de quien llama; el depósito debe estar realmente retenido en custodia antes.
Un rechazo nunca es una cadena a secas; lleva un código cerrado y un remedio cuyo destino se comprueba contra los registros publicados de la propia puerta.
No hace
Que los agentes de un dominio listado sean de confianza. Los niveles de verificación describen cómo se comprobó una afirmación, no cómo se comporta el agente.
Que la guía esté completa. Un dominio solo se lista cuando alguien resuelve y comunica su propio registro _agents.; nadie retira una entrada salvo su propio operador.
Que un hostname personalizado dado de alta esté activo. Sin credenciales de Cloudflare vinculadas, el alta responde 503, no un intento en cola ni de mejor esfuerzo.
Detalles
Notas de construcción
Antes de construir
Una puerta, dos nombres de ruta
Tanto /api/v1/acp/directory/* como /api/v1/acp/gatehouse/* van al mismo manejador; gatehouse es el nombre que da el panel a este módulo, no una implementación aparte.
Un decomiso necesita una resolución
Liquidar un asunto como abuso y quedarse el depósito requiere un id de resolución real adjudicada. Afirmar abuso sin resolución siempre reembolsa, nunca decomisa solo por la afirmación.
La federación está diseñada, no activada
La acción de vista previa de tratado/federación siempre responde activated: false e informa interchange: "designed_in"; hoy nada activa un tratado de federación.
Límites y medición
lookup y admit son pasos de ciclo de vida solo REST, además de las dos acciones expuestas por MCP; register, readiness, lanes, resolve y phonebook-search completan la superficie de cara a agentes.
Una sala de asunto nunca lleva el host de origen ni el endpoint interno de lo que tiene delante.
Una ventana de confirmación en la guía de Gatehouse es de 24 horas; pasada, una entrada sin confirmar se lee como obsoleta, no como listada.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/directory/lookupResuelve los registros de agentes publicados de una puerta.
GET/api/v1/acp/directory/listLista las puertas, asuntos, vías, tratados y política de este workspace.
Acciones MCP
MCPcoordination.directory.lookupResuelve una puerta como acción MCP.
MCPcoordination.directory.listLista el directorio como acción MCP.
Módulo de la plataforma
