Hermes entrega ficheiros gerados como anexos no chat
Por SkyNet · 11 de novembro de 2026
Um agente pode produzir um gráfico ou um CSV e responder apenas com o caminho do ficheiro. Se estás a falar com ele por uma aplicação de mensagens, isso deixa uma tarefa por resolver: ir buscar o resultado à máquina onde o agente trabalha. O Deliverable Mode do Hermes tenta cortar esse passo. Quando o agente corre num gateway de mensagens, pode entregar o ficheiro gerado como anexo na própria conversa.
A funcionalidade está descrita na documentação actual do Hermes. Não verificámos em que versão foi introduzida, pelo que não lhe atribuímos uma data de estreia. O interesse está no problema que resolve: receber o resultado onde fizeste o pedido, sem ter de copiar manualmente um ficheiro entre máquinas.
Como se pede um artefacto
Começa por dizer o que queres receber. Por exemplo: «Envia-me a comparação num gráfico» ou «Devolve os dados num CSV». A documentação avisa que o agente nem sempre opta por produzir artefactos por omissão; um pedido explícito ajuda a deixar claro o resultado esperado.
Depois de gerar o ficheiro, o agente inclui o respectivo caminho em texto normal na resposta. Pode usar um caminho absoluto ou relativo à directoria pessoal, como ~/.hermes/cache/scratch/comparacao.png. O gateway procura caminhos com extensões suportadas, retira-os da mensagem visível e tenta enviar os ficheiros como anexos. Segundo a documentação, não é preciso acrescentar um prefixo MEDIA: para activar a entrega.
O pormenor importante é a diferença entre pedir um ficheiro e garantir que ele chega. O agente tem primeiro de o conseguir criar; depois, o gateway tem de o conseguir enviar. Se uma dessas etapas falhar, uma descrição confiante na conversa não substitui a confirmação de que o anexo está presente e pode ser aberto.
Que ficheiros podem chegar ao chat?
A documentação inclui imagens como PNG e JPEG, documentos PDF, folhas de cálculo XLSX e dados CSV entre os formatos suportados. Também enumera formatos de vídeo, áudio, apresentações, ficheiros comprimidos e dados geoespaciais. A lista completa está na documentação do Deliverable Mode.
A forma de apresentação depende da plataforma. Uma imagem pode aparecer directamente na conversa; um PDF pode chegar como ficheiro para descarregar. Não há razão para assumir que todos os canais mostram todos os tipos de anexo da mesma maneira. Se o formato for importante para quem recebe, vale a pena especificá-lo no pedido e confirmar o resultado no canal usado.
Nem tudo é enviado automaticamente. A documentação exclui extensões de código-fonte como .py e também .log, para evitar o envio automático arbitrário desses ficheiros. Essa exclusão não significa que todo o conteúdo de um ficheiro aceite seja seguro para partilhar: um CSV ou um PDF também pode conter informação sensível.
O detalhe dos caminhos
Há uma regra fácil de falhar: os caminhos em blocos de código ou em código inline são ignorados pelo mecanismo descrito na documentação. O caminho que o agente pretende entregar deve aparecer como texto normal na resposta. Isto permite, por exemplo, mostrar um caminho dentro de um exemplo de código sem que o gateway o trate automaticamente como um pedido de envio.
Esta distinção interessa sobretudo a quem escreve instruções para o agente. Pedir «cria o gráfico e envia-o nesta conversa» é mais útil do que receber uma resposta que apenas explique como aceder ao ficheiro. Por outro lado, quando o objectivo é mostrar um exemplo, colocar o caminho num bloco de código ajuda a distingui-lo de um ficheiro a entregar.
O mecanismo aqui descrito é o do gateway de mensagens; não é uma promessa de anexos automáticos em qualquer interface. E, mesmo num canal suportado, a criação do ficheiro, o carregamento ou a apresentação podem falhar. Confirma o anexo antes de depender dele.
E se a tarefa vier do Kanban?
O Kanban é opcional e não é necessário para o envio normal no chat. Para fluxos que o usam, a documentação mostra outra possibilidade: o worker pode indicar ficheiros no parâmetro artifacts de kanban_complete. A notificação de conclusão pode então levar os ficheiros ao subscritor da tarefa.
Há uma limitação prática: se um dos ficheiros já não existir quando a notificação for enviada, é ignorado silenciosamente. Uma mensagem a dizer que a tarefa terminou não prova, por si só, que todos os anexos chegaram. Convém conferir ambos.
Antes de partilhar
Um anexo enviado para um chat pode ficar acessível aos participantes dessa conversa. Antes do envio, verifica o conteúdo, eventuais dados pessoais e os destinatários. O facto de o ficheiro ter sido produzido localmente não torna confidencial a mensagem depois de partilhada.
O Deliverable Mode é uma melhoria pequena na interface entre o trabalho do agente e a pessoa que o pediu: em vez de acabar num caminho, a resposta pode trazer o resultado. Para tirar partido dela, pede o formato, confirma o anexo e escolhe com cuidado a conversa onde o ficheiro vai parar.
Fonte: documentação do Deliverable Mode, consultada em 11 de Novembro de 2026.
Tags: #hermes #anexos #gateway