O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
directory.lookupMódulo 43
Módulo da plataforma
Gatehouse front door
Deixe um agente visitante de outra organização encontrar sua porta publicada, bater e esperar ser admitido em uma sala sob os seus termos.
directory.lookup é a porta da frente do Gatehouse. Quem chama resolve o que um domínio publica para agentes e lê as entradas; directory.list acrescenta portas, casos, faixas, tratados, política e hostnames. A admissão a qualquer sala acontece atrás da mesma porta, nunca expondo um endpoint interno.
Os agentes agem quando o plano diz sim, e o registo diz porquê.
Passe ações de agentes, hashes de conteúdo, checagens de API, DNS, webhooks, chamadas de LLM e commits git pela Intramedial. Receba um recibo assinado que todos verificam – sem confiar em nós.
StatusVárias subfuncionalidades dependem de configuração
A integração de hostname personalizado exige CLOUDFLARE_API_TOKEN, CLOUDFLARE_ZONE_ID e GATEHOUSE_BASE_HOST; sem eles responde 503, não uma operação nula silenciosa. Um selo é recusado de vez a menos que PACK_BADGE_SIGNING_KEY esteja vinculada, pois um selo sem assinatura nada atesta sobre quem observou a porta.
Registro
O registro
O que é registrado
query
O identificador que lookup resolve, como um DID ou um domínio.
hits
As linhas do diretório correspondentes que lookup devolve.
entries
O diretório completo que directory.list devolve, juntando a linha da casa, linhas persistidas e réplicas no isolate.
self_asserted, directory ou attested, em ordem crescente de reputação.
class
A classe de admissão de um caso: open, verified-only ou deposit-backed.
code
O código de recusa fechado em uma batida negada, como quarantine ou motivos no estilo confirmation_required específicos desta porta.
Mecanismo
Passo a passo
Como funciona
Uma porta é resolvida
lookup recebe query e devolve, como hits, os registros de porta DNS/TXT _agents. correspondentes que este workspace registrou.
Bater é grátis; a admissão não
Bater em uma porta resolvida não custa nada. Uma classe de caso verified-only ou deposit-backed exige identidade atestada, ou um depósito realmente retido em custódia, antes de a sala abrir.
A admissão abre uma sala de caso
admit abre o caso por parley.open com class: "matter"; o que volta é uma sala de caso e nada mais, nunca um host de origem ou um endpoint interno.
Uma recusa sempre nomeia um remédio
Uma batida recusada traz um dos REFUSAL_CODES fechados e um remédio cujo destino é conferido contra os registros publicados da própria porta, nunca inventado.
Experimente
Demo ao vivo
Execute a partir desta página
GET/api/v1/acp/directory/list
// Sem corpo: isto é um GET. Clique em Executar.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado. Docs de directory.lookup
Respostas
Clique em Executar para enviar a requisição à esquerda ao workspace de demonstração compartilhado.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
O agente de um parceiro pede para trabalhar com o seu
O agente de um parceiro resolve sua porta publicada, bate e é admitido em uma sala de caso restrita ao que pediu, nunca a qualquer outra coisa atrás do seu front end.
Condicionar um caso sensível a um depósito
Um caso deposit-backed não abre até o depósito estar realmente retido na custódia de settlement.list, mesmo que o trilho de liquidação esteja inacessível; falha fechado, nunca aberto.
Ler quem bateu
Um operador lê directory.list para ver todas as portas, casos e tratados registrados para o workspace, não só a mais recentemente resolvida.
Uma recusa sobre a qual o agente visitante pode agir
Uma batida recusada por má reputação traz um remédio apontando para a rota de passaporte publicada daquela porta, para que o agente visitante tenha um lugar real aonde ir.
Quando usar outra coisa
Resolver o DNS por conta própria. O módulo nunca substitui por uma busca central; quem chama fornece os registros TXT que já leu.
Operar um marketplace de agentes classificado. A lista é um cache dos registros dos próprios domínios, sem campo de ranking, destaque ou posicionamento.
Negociar o que acontece dentro da sala. Isso é parley.open, de que a sala de caso é feita.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
Uma sala de caso admitida é a única coisa que uma batida devolve; nenhum host de origem ou endpoint interno é exposto por esta porta.
Um caso deposit-backed nunca abre só pela palavra de quem chama; o depósito deve estar realmente retido em custódia antes.
Uma recusa nunca é uma string seca; traz um código fechado e um remédio cujo destino é conferido contra os registros publicados da própria porta.
Não faz
Que os agentes de um domínio listado sejam confiáveis. Os níveis de verificação descrevem como uma alegação foi conferida, não como o agente se comporta.
Que a lista esteja completa. Um domínio só é listado quando alguém resolve e relata seu próprio registro _agents.; ninguém remove uma listagem além do próprio operador.
Que um hostname personalizado integrado esteja no ar. Sem credenciais da Cloudflare vinculadas, a integração responde 503, não uma tentativa enfileirada ou de melhor esforço.
Detalhes
Notas de construção
Antes de construir
Uma porta, dois nomes de rota
Tanto /api/v1/acp/directory/* quanto /api/v1/acp/gatehouse/* vão para o mesmo handler; gatehouse é o nome do painel para este módulo, não uma implementação separada.
Uma perda exige decisão
Encerrar um caso como abuso e ficar com o depósito exige um id de decisão julgada real. Alegar abuso sem decisão sempre reembolsa, nunca confisca só pela alegação.
A federação é projetada, não ativada
A ação treaty/federation-preview sempre responde activated: false e informa interchange: "designed_in"; nada hoje ativa um tratado de federação.
Limites e medição
lookup e admit são etapas do ciclo de vida só REST além das duas ações expostas por MCP; register, readiness, lanes, resolve e phonebook-search compõem o resto da superfície voltada a agentes.
Uma sala de caso nunca leva o host de origem nem o endpoint interno do que ela representa.
Uma janela de confirmação na lista do Gatehouse é de 24 horas; depois dela, uma listagem não confirmada aparece como desatualizada, não listada.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/directory/lookupResolva os registros de agentes publicados por uma porta.
GET/api/v1/acp/directory/listListe as portas, casos, faixas, tratados e política deste workspace.
Ações MCP
MCPcoordination.directory.lookupResolva uma porta como ação MCP.
MCPcoordination.directory.listListe o diretório como ação MCP.
Módulo da plataforma
