Gleam.br Wiki

GBR: ADR-0013 Adoção de Formatos Binários (DAG-CBOR/TOON) para Comunicação de Agentes | Wiki

Documentação de engenharia e especificações técnicas da Gleam-BR.

GBR: ADR-0013 Adoção de Formatos Binários (DAG-CBOR/TOON) para Comunicação de Agentes

  • *Status:* Aceito
  • *Data:* 2026-05-01

*Contexto:*

Embora o JSON seja o padrão de facto para interoperabilidade, ele é extremamente ineficiente para sistemas distribuídos de alta frequência. O uso de JSON consome uma quantidade excessiva de tokens de contexto em LLMs devido à verbosidade de chaves e aspas, além de exigir parsing pesado na Erlang VM. Para que o Gleam-BR escale para 1M req/sec e suporte dispositivos de borda anêmicos, precisamos de uma serialização que seja compacta e capaz de referenciar dados criptograficamente (hashes).

*Decisão:*

  1. *Padronização em DAG-CBOR:* Adotar o formato Concise Binary Object Representation orientado a Grafos (DAG-CBOR) como o "esperanto binário" entre nós.
  2. *Uso de CIDs (Content Identifiers):* Assim como no IPFS, os dados não serão apenas transmitidos, mas vinculados via hashes. Isso permite que um Agente refira-se a um arquivo de 1GB enviando apenas um CID de 32 bytes no protocolo binário.
  3. *Exploração do Formato TOON:* Implementação de suporte ao formato TOON (toonformat.dev) para passar informações estruturadas para LLMs, reduzindo drasticamente o consumo de tokens de entrada ao eliminar a sintaxe repetitiva do JSON.

*Consequências:*

  • *Positivas:* Redução imediata na latência de rede e no custo de inferência (Tokens); suporte nativo a estruturas de dados imutáveis e verificáveis.
  • *Negativas/Riscos:* Exige que os desenvolvedores de ferramentas MCP utilizem codificadores/decodificadores específicos, aumentando a complexidade de debug visual (o dado não é mais "legível por humanos" em trânsito sem ferramentas de inspeção).