Not translated yet
This page is not available in English yet. Showing the Português version.
Agentes
build, plan e os seus: principais e subagentes, o arquivo, os campos, @menção.
Updated on Sep 16, 2026
Um agente é uma combinação de instruções, modelo e permissões, ou seja, um jeito de trabalhar. O HiNow Code vem com dois principais: build, que põe a mão no código, e plan, que só lê e propõe. Vem também com quatro auxiliares que trabalham como subagentes: general (tarefas em paralelo), explore (achar coisas no código), deploy (instalar o HiNow Code em outras máquinas suas; veja Instalar em outra máquina) e browser (usar o seu próprio navegador pela extensão HiNow Web; veja abaixo). E você pode criar os seus, para o que se repete no seu dia.
Com a extensão HiNow Web instalada no seu Chrome e online no HINOW Connect, o HiNow Code sabe que existe um navegador seu disponível e passa a poder usá-lo: abrir sites, ler a página que está na sua frente, preencher formulários e seguir fluxos, inclusive em sites em que você já está logado. Quem faz isso é o subagente browser, chamado pelo agente principal só quando a tarefa precisa de um navegador de verdade; o principal recebe de volta um relatório curto, e as páginas nunca entram no contexto da sua conversa.
- Ler a tela: "o que está na página que eu estou vendo?", preços, textos, erros.
- Navegar: "abre o painel da hospedagem e me diz o consumo deste mês".
- Mostrar: "abre a documentação desse pacote pra mim".
As leituras rápidas (browser_query, browser_open, browser_tabs) o agente principal faz direto, em segundos; a tarefa de navegação (browser_task) fica com o subagente browser, que mostra o passo atual no card enquanto trabalha e para junto quando você interrompe o turno. Todas respeitam as permissões do hinow.jsonc (por exemplo, "permission": { "browser_task": "ask" } para confirmar cada tarefa), e a extensão confirma com você, no navegador, qualquer ação sem volta (pagar, enviar, apagar). Com mais de um navegador online, browser_tabs lista todos e você escolhe pelo nome ou pelo hostname.
| Modo | Como se usa | Para quê |
|---|---|---|
primary | Aparece em /agents e no Tab; conduz a conversa | Jeitos diferentes de trabalhar: construir, planejar, revisar |
subagent | Chamado com @nome no pedido, ou pelo próprio agente quando delega | Tarefas com contexto isolado: revisão, pesquisa, testes |
all | Os dois |
Um subagente roda numa sessão filha, com o próprio contexto, e devolve só o resultado. ↓ entra nela, ↑ volta.
Um agente é um arquivo Markdown: em .hinow/agents/<nome>.md ele vale só para o projeto, em ~/.config/hinow/agents/<nome>.md vale para todos. O cabeçalho configura e o corpo é o prompt. Este é o revisor que usei para testar esta página:
---
description: Revisa código em busca de bugs e falhas de segurança, sem editar nada
mode: subagent
temperature: 0.1
tools:
write: false
edit: false
bash: false
---
Você é um revisor de código rigoroso. Aponte problemas concretos, com linha e motivo.
Não proponha refatorações de estilo.Depois de reabrir a interface, basta escrever @revisor revise calc.py. Neste exemplo o revisor leu o arquivo, apontou a divisão por zero sem tratamento e respondeu na sessão filha, sem conseguir editar nada nem rodar comandos, exatamente como o cabeçalho manda.
| Campo | O que faz |
|---|---|
description | Uma frase. É o que o agente principal lê para decidir **quando** delegar para este |
mode | primary, subagent ou all |
model | Modelo deste agente (hinow/hinow/hicode); padrão: o da sessão |
variant | Nível de raciocínio fixo: low, medium, high |
temperature, top_p | Criatividade: 0.1 para revisão, mais alto para ideias |
tools | Ligar/desligar ferramentas: write, edit, bash, webfetch, mcp_*… |
permission | Regras próprias, no mesmo formato de hinow.json: edit: deny, bash: { "git *": allow } |
steps | Limite de iterações por pedido |
hidden | true esconde da lista (/agents) |
disable | true desliga um agente, inclusive um embutido (build.md com disable: true) |
color | Cor do nome na interface |
O mesmo pode ser escrito em hinow.json, na chave agent, com prompt no lugar do corpo do arquivo.
hinow-cli agent create # perguntas guiadas; gera o arquivo
hinow-cli agent list # os agentes e as permissões de cada um
hinow-cli debug agent revisor # a configuração final de um agente
hinow-cli run --agent plan "…" # rodar com um agente principal
hinow-cli --agent plan # abrir a interface já com eleSó principais no --agent
--agent e /agents aceitam agentes primary (ou all). Um subagent se chama com @nome dentro do pedido; se for passado em --agent, o HiNow Code avisa e usa o padrão.
"default_agent": "plan" em hinow.json abre sempre no modo de planejamento; bom em repositórios onde a regra é revisar antes de mudar.