Tutorial 18: Ferramentas & Conjuntos de Ferramentas — As Mãos da IA
Tutorial 18: Ferramentas & Conjuntos de Ferramentas — As Mãos da IA — guia fácil de entender baseado na documentação oficial
Esta é a parte da série oficial de tutoriais do Hermes Agent. Ver todos os tutoriais
Imagine dar ao seu assistente um canivete suíço — cada ferramenta é uma lâmina diferente, e um kit de ferramentas é a pequena caixa que mantém as lâminas organizadas. É exatamente isso que Tools & Toolsets fazem pelo Hermes Agent: eles dão ao seu IA “mãos” para realmente fazer coisas, não apenas conversar.
Passo 1: Conheça as Ferramentas (Os Dedos do Seu IA)
O Hermes vem com uma caixa de ferramentas cheia de ferramentas integradas. Aqui está o resumo:
| Categoria | O que faz | Exemplos |
|---|---|---|
| Web | Pesquisa na internet, lê páginas | web_search, web_extract |
| Terminal & Arquivos | Executa comandos, edita arquivos | terminal, read_file, patch |
| Navegador | Abre um navegador real, vê a tela | browser_navigate, browser_vision |
| Mídia | Olha imagens, cria arte, fala | vision_analyze, image_generate, text_to_speech |
| Orquestração de agente | Planeja, faz perguntas, escreve código | todo, clarify, execute_code, delegate_task |
| Memória | Lembra de conversas passadas | memory, session_search |
| Automação | Agenda tarefas | cronjob |
| Integrações | Conversa com casa inteligente, servidores MCP | ha_*, ferramentas MCP |
Dica para iniciantes: Não decore tudo isso. Apenas saiba que existe. Você vai escolher as que precisar conforme avança.
Passo 2: Ative as Ferramentas (Como Ligar um Interruptor)
As ferramentas são agrupadas em toolsets — pense neles como kits pré-montados. Você os ativa por sessão de chat ou por plataforma (como Telegram vs. seu computador).
Veja como controlá-los:
# Use toolsets específicos em um chat
hermes chat --toolsets "web,terminal"
# Veja todas as ferramentas disponíveis (menu interativo)
hermes tools
# Configure ferramentas para uma plataforma específica
hermes tools
O que você verá: Quando você executa hermes tools, aparece um menu amigável. Basta pressionar espaço para ativar/desativar ferramentas. É como escolher ingredientes para uma pizza — pegue o que quiser, deixe o resto.
Passo 3: Conheça os Toolsets Comuns (Seus Kits de Uso Diário)
Você não precisa lembrar de todos, mas estes são os que você mais vai usar:
web— pesquisar e ler sitesterminal— executar comandos no seu computadorfile— ler e editar arquivosbrowser— automatizar um navegador realvision— analisar imagensmemory— lembrar coisas entre conversascronjob— agendar tarefasdelegation— deixar o Hermes criar sub-agentes
Exemplo: Quer que o Hermes pesquise algo e salve anotações em um arquivo? Use --toolsets "web,file" e pronto.
Passo 4: Ferramentas Especiais (As Joias Escondidas)
Duas funcionalidades extras que valem a pena conhecer:
1. Busca no X (Twitter) — Pesquisa posts no X, mas fica desativada por padrão. Você precisa de credenciais xAI (SuperGrok ou XAI_API_KEY). Ative via hermes tools → 🐦 Busca no X (Twitter).
2. Tool Gateway — Se você é assinante pago do Nous Portal, ganha busca na web, geração de imagens, TTS e automação de navegador sem chaves de API separadas. Basta executar:
hermes model
Depois ative as ferramentas individuais com hermes tools.
Passo 5: Escolha Seu Backend de Terminal (Onde os Comandos Rodam)
A ferramenta terminal pode executar comandos em lugares diferentes:
| Backend | O que faz | Melhor para |
|---|---|---|
local |
Roda na sua máquina (padrão) | Tarefas confiáveis, desenvolvimento |
docker |
Roda em contêineres isolados | Segurança, testes |
ssh |
Roda em um servidor remoto | Manter o agente longe do próprio código |
singularity |
Usa contêineres Singularity | HPC / computação científica |
Dica para iniciantes: Comece com local. Mude para docker quando estiver preocupado com segurança.
A seguir: vamos mergulhar no Sistema de Skills — como ensinar novos truques ao Hermes que se encaixam perfeitamente no seu fluxo de trabalho.
Você agora sabe como dar “mãos” ao Hermes. Em seguida, vamos mergulhar em como criar suas próprias ferramentas personalizadas — para que você possa ensinar truques totalmente novos ao Hermes que se encaixam perfeitamente no seu fluxo de trabalho.
Fique ligado e boas automações! 🚀
📖 Documentação oficial
この記事は Hermes Agent のDocumentação oficialに基づいています:Documentação oficial › user-guide/features/tools