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:*
- *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.
- *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.
-
*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).