Listar os agentes não registrados

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…

Caso de uso

A tarefa

Surgem agentes que ninguém inscreveu. Cada chamada pelo gateway MCP deixa um evento shadow com o DID e a ferramenta. Você os lê, compara os chamadores com seu registro e decide o que cada um é.

Pré-requisitos

Antes de começar

Plano: Qualquer plano, até o Free
Credencial: Chave API do workspace

O código lê a chave de INTRAMEDIAL_KEY. Guarde-a no seu shell ou no seu cofre de segredos, nunca em um arquivo que você faz commit. Chamadas que exigem uma pessoa logada não podem usar chave: o console as faz.

Passo a passo

Passos

Enviar uma chamada pelo gateway
Encaminhe uma chamada pelo gateway como um agente que ninguém inscreveu.

Saída de exemplo

O que é devolvido

events contém os 50 mais recentes, cada um com actorDid, tool e mode.

JSON

200 OK

{
  "events": [
    {
      "at": "2026-11-01T09:14:02.118Z",
      "event": {
        : ,
        : ,
        : ,
        : 
      }
    }
  ],
  : ,
  : 
}

Evidências

O que o recibo prova

Ele prova

Estes chamadores alcançaram o gateway MCP, com estas ferramentas e modos, nestes horários.
Uma inscrição é a única decisão armazenada.

Ele não prova isto

Continue

A seguir

Ver as tools

mcp.shadowmcp-shadow

identity.enrollidentity-enroll

Documentação

Descoberta de agentes shadow/docs/mcp-shadow

curl -sS -X POST https://api.intramedial.com/api/v1/acp/mcp/enforce \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "actorDid": "did:web:unknown.example:agent:scraper",
  "tool": "fs.write"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/mcp/enforce", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    actorDid: "did:web:unknown.example:agent:scraper",
    tool: "fs.write",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/mcp/enforce",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "actorDid": "did:web:unknown.example:agent:scraper",
        "tool": "fs.write",
    },
    timeout=30,
)
print(res.status_code, res.json())

Ler os eventos shadow

A rota devolve os 50 eventos mais recentes com o DID, a ferramenta e o modo. Ela não diz se um chamador está inscrito; compare os DIDs com a lista de identidades para achar os desconhecidos.

curl -sS https://api.intramedial.com/api/v1/acp/mcp/shadow \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY"

const res = await fetch("https://api.intramedial.com/api/v1/acp/mcp/shadow", {
  headers: { Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`, },
});
const body = await res.json();
for (const { at, event } of body.events) console.log(at, event.actorDid, event.tool, event.mode);

import os, requests

res = requests.get(
    "https://api.intramedial.com/api/v1/acp/mcp/shadow",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    timeout=30,
)
body = res.json()
for e in body["events"]:
    print(e["at"], e["event"]["actorDid"], e["event"]["tool"], e["event"]["mode"])

Oficializar um chamador

Inscreva o DID como identidade, com um dono e um tipo. Ele passa a resolver para um único agente, e seu perfil de confiança começa em 50.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/identity/enroll \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "did": "did:web:unknown.example:agent:scraper",
  "displayName": "Docs scraper",
  "kind": "partner"
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/identity/enroll", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    did: "did:web:unknown.example:agent:scraper",
    displayName: "Docs scraper",
    kind: "partner",
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/identity/enroll",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "did": "did:web:unknown.example:agent:scraper",
        "displayName": "Docs scraper",
        "kind": "partner",
    },
    timeout=30,
)
print(res.status_code, res.json())

Ou mantê-lo rastreado

Inscreva com shadow igual a true para rastrear um chamador sem oficializá-lo. Ele continua visível na lista, com todas as chamadas que fez, e um chamador recusado também continua visível.

curl -sS -X POST https://api.intramedial.com/api/v1/acp/identity/enroll \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "did": "did:web:unknown.example:agent:scraper",
  "displayName": "Docs scraper",
  "kind": "partner",
  "shadow": true
}'

const res = await fetch("https://api.intramedial.com/api/v1/acp/identity/enroll", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    did: "did:web:unknown.example:agent:scraper",
    displayName: "Docs scraper",
    kind: "partner",
    shadow: true,
  }),
});
console.log(res.status, await res.json());

import os, requests

res = requests.post(
    "https://api.intramedial.com/api/v1/acp/identity/enroll",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    json={
        "did": "did:web:unknown.example:agent:scraper",
        "displayName": "Docs scraper",
        "kind": "partner",
        "shadow": True,
    },
    timeout=30,
)
print(res.status_code, res.json())

Os agentes agem quando o plano diz sim, e o registo diz porquê.

A tarefa

Antes de começar

Passos

Enviar uma chamada pelo gateway

O que é devolvido

O que o recibo prova

Ele prova

Ele não prova isto

A seguir

Ver as tools

Documentação

Aviso de marcas registradas

Região

Escolha seu idioma

Ler os eventos shadow

Oficializar um chamador

Ou mantê-lo rastreado

Receitas ligadas

Controlar a chamada de ferramenta MCP de um agente

Dar a um agente o próprio DID

Ler o Fleet Map inteiro em uma única chamada

Receitas por e-mail

Experimente com a chave grátis.

Listar os agentes não registrados

Os agentes agem quando o plano diz sim, e o registo diz porquê.

A tarefa

Antes de começar

Passos

Enviar uma chamada pelo gateway

O que é devolvido

O que o recibo prova

✓Ele prova

×Ele não prova isto

A seguir

Ver as tools

Documentação

Ler os eventos shadow

Oficializar um chamador

Ou mantê-lo rastreado

Receitas ligadas

Controlar a chamada de ferramenta MCP de um agente

Dar a um agente o próprio DID

Ler o Fleet Map inteiro em uma única chamada

Receitas por e-mail

Experimente com a chave grátis.

Ele prova

Ele não prova isto