GUIA COMPLETO do Hermes Agent: Dê ao Hermes um cérebro corporativo para que ele possa colaborar com sua equipe

Este artigo foi escrito por @chriskim_dev

Agentes de IA são ótimos quando trabalham para uma pessoa. Eles ficam muito mais interessantes quando podem trabalhar com todo o seu time.

Este guia é um tutorial passo a passo para desenvolvedores fazer exatamente isso: construir um "cérebro da empresa" que conecta o @NousResearch Hermes Agent aos arquivos, comentários, versões e contexto compartilhados que seu time já usa no @Box. Ao final, você terá uma implementação funcional onde o Hermes não é mais apenas um assistente pessoal, mas sim um colega de equipe que realiza o trabalho a partir da mesma fonte de verdade que todos os outros.

Para manter este tutorial focado, vou assumir que você já tem alguma experiência configurando o Hermes Agent Gateway em um VPS para que seu agente fique disponível 24/7. Para um guia de configuração detalhado, consulte a documentação do Hermes para desenvolvedores. Usaremos um Droplet da DigitalOcean para hospedar nossa instância do Hermes, mas o mesmo padrão funciona em qualquer provedor de VPS.

Assista à demonstração primeiro

Antes de construirmos, veja o fluxo de trabalho em ação!

https://x.com/chriskim_dev/status/2066898496842846557

O problema: agentes de IA ainda são muito isolados

Se você trabalha em uma equipe de marketing, conteúdo, produto ou de atendimento ao cliente, essa história provavelmente parece familiar. Você está trabalhando em um vídeo institucional da empresa. Alguém joga um ZIP em uma thread do Slack, um colega pergunta quais arquivos estão dentro, mais versões se acumulam (video_project_v2_FINAL.zip, final_final_revised.mov, launch_copy_v3.txt), o feedback fica enterrado e alguém edita a versão errada.

Então um agente de IA entra no circuito e piora a situação, trabalhando com confiança a partir de sua própria cópia local do projeto. Ferramentas como o Hermes são poderosas para a produtividade individual, mas as transferências entre agente-humano e agente-agente falham porque todos, humanos e máquinas, estão trabalhando a partir de contextos diferentes.

A solução: dê aos seus agentes o mesmo espaço de trabalho compartilhado que seu time já usa, uma única fonte de verdade da qual todos se baseiam. É aí que o Box entra.

O que você vai construir

Ao final deste guia, você terá:

• Hermes Agent rodando em um VPS com Slack como gateway
• Box CLI instalado no mesmo servidor
• Um aplicativo Box usando autenticação Client Credentials Grant (CCG)
• Uma conta de serviço Box dedicada para o Hermes
• Uma pasta de projeto compartilhada que se torna o espaço de trabalho para humanos e agentes
• Um padrão repetível para fluxos de trabalho de agentes onde o Hermes pode fazer upload, ler, analisar e organizar o trabalho no Box

A principal escolha de design aqui é não autenticar o Hermes no Box CLI como sua conta de usuário pessoal do Box. Em vez disso, criamos um aplicativo Box usando Client Credentials Grant (CCG), que dá ao seu agente sua própria identidade de serviço no Box.

O que é uma conta de serviço?

Uma conta de serviço é uma identidade dedicada para uma aplicação ou automação. Se o Hermes usar sua conta pessoal, ele pode acessar tudo que você pode, o que é bom para experimentos locais, mas é o modelo errado para fluxos de trabalho em equipe ou voltados para o cliente. Com uma conta de serviço, o Hermes ganha sua própria identidade no Box, e você compartilha apenas as pastas que ele precisa. Isso proporciona um limite de segurança claro: o Hermes age como Hermes, e vê apenas o que você compartilhou com ele.

Um aplicativo Box CCG é como criamos essa identidade no lado do servidor. O CCG permite que seu aplicativo se autentique sem um login de usuário interativo. Você cria um aplicativo no Console do Desenvolvedor Box, o autoriza no Console de Administração e usa seu ID de cliente, segredo do cliente e ID da empresa para autenticar a partir do seu servidor. Você aprenderá como criar o aplicativo abaixo, mas para mais detalhes, leia a documentação do Box sobre Client Credentials Grant.

Pré-requisitos

Você vai precisar de:

• Uma conta gratuita de desenvolvedor Box
• Uma conta na DigitalOcean (ou qualquer outro provedor de VPS)
• Um espaço de trabalho Slack onde você possa criar e instalar aplicativos
• Hermes Agent com um provedor de modelo configurado
• Familiaridade básica com terminal

Primeiro, crie uma conta gratuita de desenvolvedor Box. Após o cadastro, você será redirecionado ao Console do Desenvolvedor Box, onde criará o aplicativo CCG que dá ao Hermes sua identidade de serviço.

Passo 1: Criar um Droplet na DigitalOcean

Para este tutorial, usaremos um Droplet da DigitalOcean como VPS. A DigitalOcean tem um guia completo para criar um Droplet.

Para uma demonstração de desenvolvimento, um Droplet Ubuntu pequeno é suficiente:

• Ubuntu 24.04
• 1 vCPU
• 2 GB de RAM
• Autenticação por chave SSH
• Monitoramento ativado

Assim que o Droplet for criado, conecte-se via SSH:

1ssh root@SEU_IP_DO_DROPLET

Atualize os pacotes e instale o básico:

1apt update
2apt upgrade -y
3apt install -y curl git unzip jq build-essential nodejs npm

Passo 2: Instalar o Hermes Agent

Instale o Hermes Agent no droplet seguindo a documentação oficial do Hermes.

Após a instalação, verifique se funciona:

1hermes --version

Em seguida, execute a configuração:

1hermes setup

Escolha o provedor de modelo de IA que deseja usar e siga as instruções. O Hermes suporta diferentes provedores de modelo, então não vou prescrever um (qualquer provedor importante funciona). A parte importante é que o Hermes seja executado com sucesso antes de conectá-lo ao Slack e ao Box.

Verifique rapidamente se o Hermes está configurado corretamente:

1hermes

Em seguida, envie "Olá" para ver se o Hermes responde. Uma configuração funcional responde no terminal; se não houver resposta, execute hermes setup novamente e confirme se a chave do seu provedor de modelo está configurada.

Passo 3: Criar o aplicativo Slack e configurar o Hermes Gateway

O Hermes Gateway permite que seu agente opere dentro de plataformas de mensagens como o Slack. Vamos configurar o Slack como a plataforma de mensagens para nosso agente Hermes. Consulte o guia de configuração detalhado do Slack na documentação do Hermes para desenvolvedores. Ao final, você deve ter: um token do bot do Slack, um token do aplicativo Slack, o aplicativo Slack instalado em seu espaço de trabalho e o gateway configurado.

Nota: Como o Hermes está rodando em um VPS, instale o Hermes Gateway como um serviço do sistema quando solicitado. Dessa forma, ele inicia na inicialização e continua em execução depois que você fecha o terminal.

Verifique o serviço com:

1systemctl status hermes-gateway

Comandos úteis:

1systemctl restart hermes-gateway          # reiniciar gateway
2journalctl -u hermes-gateway -f            # exibir os logs do gateway em tempo real
3journalctl -u hermes-gateway -n 100 --no-pager   # exibir as últimas 100 linhas do log

Assim que o aplicativo Slack estiver instalado e configurado como seu gateway Hermes, reinicie o Hermes no VPS:

1systemctl restart hermes-gateway

Teste no Slack enviando uma mensagem com @Hermes:

1@Hermes olá

Passo 4: Instalar o Box CLI

Agora que seu agente Hermes está funcionando no Slack, vamos conectá-lo ao Box com o Box CLI. O Box CLI basicamente torna o Box completamente autônomo (headless), e você permite que seu agente Hermes realize todas as operações no Box, como ler arquivos, criar/enviar arquivos e gerenciar conteúdo no Box por meio de comandos CLI.

Instale o Box CLI no VPS (usando o terminal no qual você se conectou remotamente ao VPS):

1npm install --global @box/cli

Verifique:

1box --version

Ótimo! O Box CLI está instalado no seu VPS. Faremos a autenticação nele mais tarde. Para mais informações, consulte a documentação do Box CLI.

Passo 5: Criar um aplicativo Box CCG

Vá para o Console do Desenvolvedor Box e crie um novo aplicativo usando Client Credentials Grant. Este aplicativo é a identidade de serviço que age em nome do seu agente Hermes.

Após a criação, encontre a barra lateral Detalhes do Aplicativo à direita e localize estas credenciais:

• clientID (ID do Cliente)
• clientSecret (Segredo do Cliente)
• enterpriseID (ID da Empresa)

Agora crie um arquivo de configuração no seu VPS:

1nano /root/box-ccg-config.json

Cole:

1{
2  "boxAppSettings": {
3    "clientID": "SEU_CLIENT_ID",
4    "clientSecret": "SEU_CLIENT_SECRET"
5  },
6  "enterpriseID": "SUA_ENTERPRISE_ID"
7}

Salve e saia:

1Ctrl+O ou Cmd+O
2Enter
3Ctrl+X ou Cmd+X

Agora vamos configurar o ambiente do Box CLI para usar nosso aplicativo CCG para autenticação. Isso permitirá que o Hermes faça login no Box CLI usando o aplicativo CCG e não uma conta de usuário pessoal.

Adicione o ambiente ao Box CLI:

1box configure:environments:add /root/box-ccg-config.json --ccg-auth --name service

Defina-o como atual:

1box configure:environments:set-current service

Verifique a identidade do serviço:

1box users:get

Você deve ver um usuário de automação, não seu usuário pessoal. Pode ser algo como:

1Nome: my-app
2Login: [email protected]

Essa é a identidade que seu agente Hermes usará no Box. Agora, quando você disser ao seu agente Hermes para realizar qualquer operação no Box, o Hermes poderá usar o Box CLI para fazê-lo.

Passo 6: Compartilhar uma pasta de projeto com a conta de serviço

Crie uma pasta no Box para o seu projeto — por exemplo, "Projeto de Vídeo de Lançamento de Produto".

Vá para a página do aplicativo CCG criado no Console do Desenvolvedor Box e copie o e-mail do usuário de automação na barra lateral Detalhes do Aplicativo.

Agora compartilhe essa pasta com o usuário de automação da etapa anterior.

Este é o limite de segurança chave. O Hermes não precisa de acesso a toda a sua conta; ele precisa apenas de acesso a esta pasta de projeto.

Vamos verificar se a configuração de acesso limitado funciona! Pergunte ao seu agente Hermes no Slack:

1@Hermes Você pode verificar quais pastas e arquivos você vê no nível raiz?

Se você vir apenas a pasta de projeto que criou anteriormente, estamos prontos para prosseguir!

Parabéns! O Box agora está pronto para atuar como o cérebro da empresa para seu agente Hermes. Use esta pasta como sua única fonte de verdade e deixe o Hermes se basear nela como contexto para as tarefas que você atribuir.

Deixe o Hermes aprender o Box CLI

Aqui está uma das minhas partes favoritas do Hermes: seu ciclo de autoaperfeiçoamento. Você não precisa criar manualmente e perfeitamente cada comando do Box CLI antecipadamente. Em vez disso, dê uma tarefa ao Hermes e deixe-o aprender.

Por exemplo, no Slack:

1@Hermes use o Box CLI para descobrir quem você é como autenticado e, em seguida, liste os arquivos na pasta de projeto compartilhada.

Depois tente:

1@Hermes crie uma habilidade reutilizável para operações comuns do Box CLI, como listar pastas, enviar arquivos, baixar arquivos e verificar a conta de serviço atual.

Na demonstração em vídeo, o Hermes descobriu como trabalhar eficientemente com o Box CLI e criou sua própria habilidade box-cli reutilizável. Eu não criei essa habilidade primeiro. O Hermes aprendeu com o ambiente e melhorou seu comportamento futuro.

Você ainda pode guiá-lo com uma breve instrução:

• Sempre use o ambiente de serviço do Box CLI.
• Opere apenas dentro da pasta de projeto aprovada.
• Pergunte antes de deletar ou sobrescrever conteúdo.
• Preserve o histórico de versões sempre que possível.
• Trate o Box como a fonte de verdade durável.

Peça ao Hermes para usar o Box CLI, observe onde ele tem dificuldades, corrija-o e deixe-o criar um fluxo de trabalho melhor para a próxima vez.

Onde isso realmente brilha: maneiras reais de equipes usarem o cérebro compartilhado

Minha demonstração foi sobre colaborar em um lançamento de vídeo, mas uma vez que o Hermes e sua equipe compartilham a mesma fonte de verdade no Box, você pode usar isso para qualquer trabalho onde humanos e agentes precisem estar na mesma página. Aqui estão alguns cenários para inspirar ideias. Experimente-os e depois invente os seus próprios!

Colaboração em conteúdo e marketing (seu lançamento de vídeo, em outro nível). Seu editor coloca o corte final no Box, um redator deixa feedback como comentário, e o Hermes capta isso sem que ninguém precise reexplicar o projeto:

1@Hermes o corte V2 está aprovado — gere legendas, uma descrição para o YouTube e 3 conceitos de miniatura, e salve-os na pasta de lançamento.

Um segundo agente na máquina de um colega pode depois acessar essa mesma pasta para agendar as publicações. Ninguém nunca mais pergunta "qual arquivo é o final?"

Coordenação de lançamento de produto. Gerência de produto, design e marketing estão todos correndo para a mesma data. Em vez de um documento de lançamento que fica desatualizado no momento em que é escrito, deixe o Hermes montá-lo ao vivo a partir do espaço de trabalho compartilhado:

1@Hermes leia a especificação, os protótipos mais recentes e as notas de QA na pasta de Lançamento, depois elabore uma lista de verificação de go/no-go e um briefing de lançamento de uma página.

Quando a especificação mudar, execute novamente — o cérebro sempre lê a verdade atual, não a cópia da semana passada.

Trabalho de engenharia. Aponte o Hermes para as exportações do repositório, documentos de design e notas de incidentes que estão no Box para que toda a equipe trabalhe a partir de um único contexto:

1@Hermes resuma os problemas em aberto e o documento de design na pasta Auth-Service, depois elabore as notas de versão para o deploy v3.2.

Integrando um novo engenheiro? Ele (e seu agente) leem a mesma pasta que a equipe sênior — sem conhecimento tácito preso em mensagens diretas.

Projetos pessoais paralelos. Mesmo sozinho, a configuração compensa — sua "equipe" é apenas você entre um laptop, um telefone e alguns agentes:

1@Hermes aqui estão meus registros de treino e receitas do mês — monte um plano de refeições e treinos e coloque-o na minha pasta de Projetos Paralelos.

Comece a ideia no seu telefone, termine-a no laptop e deixe um agente diferente pegá-la amanhã.

Trabalho jurídico e contratos. O jurídico vive e morre pelo controle de versão, então uma única fonte de verdade é um presente aqui:

1@Hermes compare a V2 com alterações do MSA do fornecedor contra a V1, liste cada cláusula alterada e sinalize qualquer coisa que toque em responsabilidade ou rescisão.

O advogado comenta diretamente no arquivo no Box; o Hermes (e o agente de qualquer revisor) sempre puxa a versão assinada mais recente, não um anexo de e-mail perdido.

O fio condutor de todos esses exemplos é aquele para o qual você vem construindo:

Equipes diferentes. Agentes diferentes. Interfaces diferentes. O mesmo espaço de trabalho compartilhado.

Escolha o cenário mais próximo da sua realidade e execute-o hoje. Depois, seja criativo! O melhor caso de uso é quase sempre aquele que você descobre assim que o atrito desaparece. Divirta-se e compartilhe o que você construiu nos comentários!