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.
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
-
O agente usa uma ferramenta para criar o arquivo. Por exemplo, ele pode usar
execute_codepara renderizar um gráfico matplotlib, ou uma skilldocxpara montar um documento Word, ou uma skillxlsxpara planilhas, ou uma skillpdfpara relatórios. -
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. -
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