🤖HermesBlog
Guias de Recursos do Hermes · Parte 328/9/2026

Modo Entregável — Foco na Saída

Modo Entregável — Foco na Saída — guia fácil de entender baseado na documentação oficial

Modo de Entrega — Foco no Resultado


Imagine pedir comida para viagem e, em vez de receber um saco de ingredientes crus com um cartão de receita, o chef vem até você e te entrega um prato quente, pronto. Essa é exatamente a ideia por trás do Modo de Entrega do Hermes Agent. Quando seu agente produz um arquivo — um gráfico, um PDF, uma planilha — ele não te dá apenas um caminho de arquivo para você ir caçar. Ele te entrega o prato pronto, direto na sua janela de chat.

hermes-feature-32-deliverable-mode

O Que Ele Realmente Faz

Quando o Hermes Agent roda em uma plataforma de chat (Slack, Discord, Telegram e outras), cada arquivo que ele gera é automaticamente anexado à resposta dele. Por exemplo:

  • Um gráfico → aparece diretamente como uma imagem
  • Um relatório em PDF → aparece como um arquivo para download
  • Uma tabela → é enviada como um arquivo .xlsx

Você não precisa fazer nada de especial. O agente simplesmente menciona o caminho absoluto do arquivo na resposta — tipo /tmp/q3-revenue.png — e o gateway detecta, extrai e envia para você.

Como Funciona em Três Passos

  1. O agente usa uma ferramenta para criar o arquivo. Por exemplo, ele pode usar execute_code para renderizar um gráfico matplotlib, ou uma skill docx para montar um documento Word, ou uma skill xlsx para planilhas, ou uma skill pdf para relatórios.

  2. O gateway verifica a resposta em busca de caminhos de arquivo. Ele procura por caminhos que começam com /tmp/... ou ~/... e terminam com uma extensão de arquivo suportada. Caminhos dentro de blocos de código são ignorados, então seus exemplos de código ficam limpos.

  3. O gateway envia de acordo com o tipo de arquivo:

    • Imagens → incorporadas diretamente no chat
    • Vídeos → incorporados para reprodução (se a plataforma suportar)
    • Áudio → enviado como anexo de voz ou áudio
    • Todo o resto → enviado como arquivo comum

Formatos de Arquivo Suportados

Categoria Exemplos Como É Enviado
Imagens .png .jpg .gif .svg Exibidas inline
Vídeo .mp4 .mov .mkv Reprodução incorporada
Áudio .mp3 .wav .m4a Anexo de voz
Documentos .pdf .docx .txt .md Upload de arquivo
Dados .xlsx .csv .json Upload de arquivo
Apresentações .pptx .ppt Upload de arquivo
Arquivos compactados .zip .rar .7z Upload de arquivo

Nota: Arquivos de código-fonte como .py e .log não são enviados automaticamente. Isso é proposital — evita que o agente fique te enchendo com arquivos de código. Quer compartilhar código? Use um bloco de código.

Como Fazer o Agente Produzir Arquivos

O agente não gera arquivos sozinho por padrão. Você precisa dar um empurrãozinho.

Método 1: Basta pedir na conversa

“Faça um gráfico comparando os resultados e me envie” “Exporte os dados como CSV”

Método 2: Defina preferências no nível do projeto Adicione suas preferências no arquivo AGENTS.md, CLAUDE.md ou .cursorrules do projeto. Ou adicione uma regra na sua configuração global em ~/.hermes/SOUL.md. Você pode até definir um “persona preset” em ~/.hermes/config.yaml e alternar entre eles quando quiser.

O Mecanismo Central em Uma Frase

O agente salva um arquivo em um caminho absoluto (como /tmp/q3-revenue.png), menciona esse caminho em texto puro na resposta, e o gateway cuida do resto. Só isso.


Resumindo: o Modo de Entrega muda o trabalho da IA de “te dizer onde o arquivo está” para “te entregar o arquivo diretamente”. Chega de procurar em pastas. Dica prática: da próxima vez que pedir ao agente para analisar dados, diga apenas: “Transforme os resultados em um gráfico e me envie.” Ele vai gerar a imagem e entregar na hora — experimente uma vez e você não vai querer voltar atrás.


📖 Documentação oficial

この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › user-guide/features/deliverable-mode