Cache de Dados Externos em Agentes
Ir para notas que citam estaCache de dados externos em agentes é a camada que guarda por um tempo as respostas de APIs e buscas, para que todos os agentes leiam o mesmo dado sem repetir chamada a cada execução.
Num sistema multiagente, vários agentes olham para o mesmo objeto: o pesquisador busca, o analista interpreta, o revisor confere. Sem uma camada comum, cada execução refaz buscas pagas, soma latência e ainda arrisca que dois agentes trabalhem com versões diferentes do mesmo fato. O cache resolve os três problemas ao mesmo tempo: a chamada paga é feita uma vez, a resposta sai mais rápido e todos os agentes partem do mesmo registro.
Controlador de dados: o agente dono da tabela
Num assistente de análise de investimentos construído no N8N, o cache é uma tabela administrada por um subagente próprio, o controlador de dados. O Agente Orquestrador o aciona assim que identifica o ativo, antes de qualquer pesquisa: se já houver registro, o sistema parte dele e só completa o que falta. Como qualquer subagente, o controlador é visto pelo orquestrador apenas pela descrição, algo como responsável por consultar e atualizar tabelas de ativos.
A tabela usa o recurso nativo de Data Tables do N8N, sem banco externo, mas a mesma lógica serve com MongoDB ou um banco SQL. Cada linha guarda ticker, nome, tipo do ativo, mercado, moeda, preço atual, fonte, um resumo das informações relevantes, limitações, data da última atualização, data de coleta do preço e o status do dado, incluindo se foi aprovado pelo revisor. A gravação é um upsert em que o próprio modelo separa e preenche cada campo a partir do que o Agente Pesquisador trouxe; nada é inserido à mão.
Validade do cache segue a volatilidade do dado
Quanto tempo um registro continua válido é decisão de projeto, e a regra é olhar a velocidade com que o dado muda:
- Cotações mudam a cada minuto. São buscadas de novo em toda requisição, porque entre uma execução e outra o preço pode mudar. O preço salvo na tabela serve só como referência para perceber se houve alta ou queda desde a última consulta.
- Notícias e análises mudam devagar. São reaproveitadas em consultas do mesmo dia, e um campo de data permite ao sistema marcar se a informação ainda é recente ou precisa ser refeita.
Numa execução de teste com a ação BBAS3, o preço da análise, R$ 19,73, bateu exatamente com o registrado na tabela, atualizado no mesmo dia: a cotação veio fresca e a tabela foi sincronizada com ela.
Tratar uma cotação como dado estável produz análise com preço velho e aparência de atual. Separe o que é volátil do que é estável antes de decidir o que entra no cache e por quanto tempo.
Dados com calendário fixo
Nem todo dado externo é contínuo. Cotações de bolsa mudam por segundo, mas indicadores de órgãos como Banco Central e IBGE saem em datas fixas, mensais, trimestrais ou anuais. Esse terceiro perfil não se encaixa bem na divisão entre volátil e estável: o desenho descrito acima resolve a questão restringindo o cache a notícias e análises e buscando cotações sempre na hora, sem tratar séries com calendário de divulgação. Quem incorporar esse tipo de fonte precisa decidir explicitamente como ela expira.
Um cache compartilhado também é um ponto de verdade comum: se um dado errado entra e ninguém confere, todos os agentes passam a repeti-lo. Guardar o status de aprovação do revisor em cada linha é a forma de reaproveitar só o que já passou por checagem.