Tutorial 23: Kanban — Quadro Multiagente | Easy Understand Hermes Agent

Esta parte faz parte da série oficial de tutoriais do Hermes Agent. Ver todos os tutoriais

Imagine um quadro branco num escritório partilhado onde vários colegas podem afixar notas autocolantes, movê-las e escrever comentários — só que os colegas são agentes de IA, e o quadro nunca é apagado. É isto o Hermes Kanban: um quadro de tarefas durável que permite que vários agentes nomeados colaborem sem entregas frágeis ou trabalho perdido.

Passo 1: Compreender a Ideia Principal

O Kanban é uma base de dados partilhada (um único ficheiro em ~/.hermes/kanban.db) que todos os perfis Hermes podem ler e escrever. Cada tarefa é uma linha. Cada entrega é uma linha. Cada trabalhador é um processo completo do sistema operativo com a sua própria identidade e memória.

Diferença chave em relação ao delegate_task:

delegate_task é como uma chamada telefónica — ligas, esperas, desligas. Se falhar, desapareceu.
O Kanban é como um quadro de avisos — publicas uma tarefa, afastas-te, e qualquer pessoa pode pegá-la mais tarde. Se um trabalhador falhar, a tarefa permanece e outro agente pode reivindicá-la.

Passo 2: Conhecer as Duas Portas de Entrada

Ambas as superfícies usam a mesma base de dados, por isso nunca entram em conflito.

Porta 1 — Os agentes usam ferramentas.
O modelo de IA fala com o quadro através de um conjunto dedicado de ferramentas: kanban_show, kanban_list, kanban_create, kanban_complete, kanban_block, kanban_comment, e outras. O dispatcher dá estas ferramentas a todos os trabalhadores automaticamente.

Porta 2 — Tu usas a CLI.
Tu (ou scripts, ou cron jobs) usas hermes kanban … no terminal, /kanban … como comando de barra, ou o painel de controlo.

Regra prática: se há um modelo por trás, usa ferramentas. Se é um humano ou automação, usa a CLI.

Passo 3: Experimentar os Comandos Básicos

Aqui está como criar e gerir uma tarefa a partir do terminal:

# Criar uma nova tarefa
hermes kanban create "Escrever post de blogue" --assign researcher-1

# Listar todas as tarefas
hermes kanban list

# Mostrar detalhes de uma tarefa
hermes kanban show 42

# Marcar uma tarefa como concluída
hermes kanban complete 42

# Bloquear uma tarefa (a aguardar algo)
hermes kanban block 42 "Preciso de mais dados"

# Desbloquear mais tarde
hermes kanban unblock 42

# Adicionar um comentário
hermes kanban comment 42 "O rascunho está pronto para revisão"

Cada verbo da CLI tem uma chamada de ferramenta correspondente que o modelo usa internamente — mesma base de dados, mesmo resultado.

Passo 4: Ver o Que o Kanban Consegue Fazer Que o `delegate_task` Não Consegue

Aqui estão os tipos de carga de trabalho para os quais este quadro foi construído:

Triagem de pesquisa — vários investigadores trabalham em paralelo, um analista revê, um escritor redige. Um humano pode comentar e desbloquear a qualquer momento.
Operações agendadas — um agente de resumo diário que constrói um diário ao longo de semanas.
Gémeos digitais — assistentes persistentes como inbox-triage que acumulam memória ao longo do tempo.
Pipelines de engenharia — decompor uma funcionalidade grande, implementar em worktrees paralelos, rever, iterar e depois criar um PR.
Trabalho em frota — um especialista a gerir 50 contas de redes sociais ou 12 serviços monitorizados.

Passo 5: Lembrar a Distinção Numa Frase

delegate_task é uma chamada RPC fork-join; o Kanban é uma fila de mensagens durável com uma máquina de estados.
Em português simples: delegate_task é “pergunta e espera”, o Kanban é “publica e deixa a equipa trabalhar”.

Official Screenshots

Resumo

O Kanban transforma o Hermes de um assistente de agente único numa força de trabalho multi-agente com memória partilhada e persistente. As tarefas sobrevivem a falhas, os humanos podem intervir a qualquer momento, e múltiplos agentes podem tocar na mesma tarefa ao longo da sua vida. É a diferença entre contratar um temporário e construir uma equipa.