WebAgentic • Agente Autônomo (auth.md • agent.md • memory.md)

🛡️ Níveis de Acesso (Tiers)

Anônimo

SELECIONE O TIER DO AGENTE:

1. Acesso Anônimo Público

Sem credenciais. Acesso a operações públicas dos Correios. Rate limit: 1 req / 30s. Intranet bloqueada.

2. Tier Balcão (AppKey) Auto-registro

Credencial de balcão criada sob autorização expressa do proprietário. Header Bearer mcp_sk_counter_*. Rate limit: 1 req / 10s.

3. Cliente Contratado B2B B2B Restrito

AppKey contratada + Cartão de Postagem. Acesso pleno à ferramenta restrita rastrear_sro_intranet.

4. Chave Revogada / Inválida Teste 401

Simula AppKey desativada ou inexistente para validar rejeição com erro 401 Unauthorized.

Medidor de Rate Limit Pronto

AppKey do Agente + Auto-registrar

Cartão de Postagem (X-Cartao-Postagem)

🌐 Contexto Operacional memory.md §1

Persona 🪽 Agente Hermes

Normas auth.md • agent.md

MCP Endpoint /mcp/rastro/index.php

Regras SRO MySQL regras_ocorrencias

Problemas problems_manager.html

Modelo Gemini 2.0 / CoT

🧠 Motor de Decisão (agent.md) 3 em aberto

Verifica cache de memória antes de exigir digitação e aplica triagem ativa de tiers.

🪽 Agente Hermes • Mensageiro Logístico Autônomo v2.0

JSON-RPC 2.0 • Memória Ativa • Hermes CoT

🪽 Agente Hermes (Hermes Logistics Dispatcher)

Olá! Sou o Agente Hermes 🪽⚡, o mensageiro inteligente e autônomo da logística dos Correios e do ecossistema WebAgentic.

Minhas diretrizes fundamentais unem a velocidade de despacho do mensageiro alado ao rigor de governança:

Decisões Instantâneas (TypeSafe Jev System One): Microdecisões probabilísticas em ~70ms com as primitivas Choice, Score e Noul antes de acionar LLMs caros;
Persona Hermes (agent.md & hermes.md): Raciocínio de alta velocidade (Hermes Chain-of-Thought), triagem proativa de rotas, despacho de encomendas e auditoria de segurança;
Memória Operacional Ativa (memory.md): Inventário persistente em memória para você nunca precisar redigitar códigos;
Segurança por Tiers (auth.md): Anonimato (30s), Balcão (10s com cerimônia de consentimento) e Contratado B2B (Intranet SRO restrita);
Contorno Imediato de Anomalias: Diagnóstico preventivo de atrasos, retenções e redirecionamento de 1 clique para o problems_manager.html.

Como posso despachar sua solicitação postal hoje? Selecione um dos atalhos do Hermes abaixo ou fale comigo!

⚡ TypeSafe Jev (~74ms) 🎮 Playground de Funções

INSPETOR JSON-RPC AO VIVO

INVENTÁRIO DE OBJETOS PENDENTES

💡 Regra de Usabilidade (memory.md): O agente NUNCA exige redigitar estes códigos. Clique em qualquer item para rastrear ou gerenciar no Problems Manager.

🟢 Objetos de Teste Memorizados (memory.md §2.2)

SS100833276BR Homologação B2B SRO

BR123456789XP Logística Reversa M2M

ESPECIFICAÇÃO OFICIAL (agent.md) Abrir agent.md ↗

🪽 Agente Hermes • Especificação Oficial Hermes 2.0

Inspirado no mensageiro grego do comércio, viagens e entregas velozes, o Agente Hermes é o operador autônomo oficial do WebAgentic. Possui raciocínio acelerado (Hermes Chain-of-Thought), despacho multimodal de encomendas, recuperação preditiva da memória ativa (memory.md) e negociação segura de credenciais (auth.md).

🪽 Despacho Ágil ⚡ Hermes CoT 📜 JSON-RPC 2.0 🛡️ 3 Tiers auth.md

🎯 Persona & Missão do Agente v1.2.0

Agente autônomo com Security by Design, raciocínio exposto (Chain-of-Thought), triagem de pacotes, emissão de tabelas SRO e negociação de credenciais com aprovação do proprietário.

🛠️ Catálogo MCP Oficial (agent.md §4) 4 Tools

rastrear_encomenda(codigo)

Tier 1 (Público Anônimo) • 1 req / 30s

rastreamento_real_tabela(codigo, app_key)

Tier 3 (Contratado B2B) • Tabela Markdown SRO

rastrear_sro_intranet(codigo, app_key)

Tier 3 (Contratado B2B) • Dados internos restritos

consulta_cep(cep)

Tier 1 (Público) • Logradouro, bairro, UF

🔌 Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "webagentic-logistica": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://webagentic.labdx.org/mcp/rastro/index.php"
      ],
      "env": {
        "X_APP_KEY": "013478",
        "X_CARTAO_POSTAGEM": "013478"
      }
    }
  }
}

💻 Cursor / VS Code (.cursor/mcp.json)

{
  "mcpServers": {
    "webagentic": {
      "url": "https://webagentic.labdx.org/mcp/rastro/index.php",
      "headers": {
        "X-App-Key": "013478",
        "X-Cartao-Postagem": "013478"
      }
    }
  }
}

🧠 System Prompt Recomendado (LLMs)

Você é o Agente Autônomo de Logística do WebAgentic.
Suas ferramentas operam sob as normas do auth.md, agent.md e memory.md:
1. Sempre consulte memory.md antes de pedir para digitar códigos de rastreamento.
2. Sempre realize triagem de identificação: alerte o usuário de que requisições anônimas têm rate limit de 30s e bloqueio HTTP 403 na Intranet SRO.
3. Para ferramentas restritas corporativas como 'rastreamento_real_tabela', solicite 'app_key' de Tier 3.
4. Ao identificar anomalias no rastreamento, apresente o contorno operacional e forneça link direto para o problems_manager.html.

⚠️ Códigos de Status (agent.md §7)

• 200 OK: Sucesso na consulta.
• 201 Created: Chave de balcão provisionada.
• 401 Unauthorized (-32000): Chave revogada/inválida.
• 403 Forbidden (-32003): Bloqueio de Tier (ex: SRO sem app_key).
• 429 Too Many Requests (-32029): Limite de taxa (30s ou 10s).

DOCUMENTOS DE DESCOBERTA (RFC 9727)

Carregando metadados de descoberta...

SUÍTE DE CONFORMIDADE (10 TESTES)

Status: Pronto para executar

1. Descoberta e Catálogo (RFC 9727) PENDENTE

Valida /.well-known/api-catalog, mcp-discovery.json e tools/list.

2. Rastreamento Anônimo (rastrear_encomenda) PENDENTE

Verifica chamada pública sem headers com rate limit de 30s.

3. Bloqueio Anônimo na Intranet SRO (403) PENDENTE

Garante retorno 403 Forbidden (-32003) ao tentar ferramenta restrita.

4. Auto-registro com Consentimento do Proprietário PENDENTE

Valida criação da AppKey mcp_sk_counter_* via api_clientes.php.

5. Rastreamento Balcão (Bearer Token) PENDENTE

Testa chamada com Authorization: Bearer mcp_sk_counter_* (rate limit 10s).

6. Contratado B2B (rastrear_sro_intranet) PENDENTE

Testa acesso interno com AppKey + Cartão de Postagem.

7. Tabela Oficial SRO (rastreamento_real_tabela) PENDENTE

Valida emissão e renderização de tabela Markdown formatada da Intranet.

8. Consulta de CEP (consulta_cep) PENDENTE

Valida busca e estruturação de endereço a partir de CEP de 8 dígitos.

9. Recuperação de Memória Ativa (memory.md) PENDENTE

Garante que pacotes em aberto são recuperados sem digitação pelo usuário.

10. Detecção de Ocorrência & problems_manager.html PENDENTE

Verifica injeção automática de contorno e link de especialização da IA.

⚖️ Autorização Explícita do Proprietário

💾 Adicionar Objeto à Memória Ativa