Hermes Agent: Ferramentas e Conjuntos de Ferramentas
Última atualização: 2026-08-31
O sistema de ferramentas são as mãos do Hermes — um cérebro (LLM) sozinho não basta; você precisa de mãos (ferramentas) para realmente realizar tarefas. 70+ ferramentas integradas permitem ler/escriver arquivos, buscar na web, executar código e entender imagens.
📋 Pré-requisitos: Lição 7 — Sistema de Habilidades
1. O Que Você Vai Aprender
| # | Conteúdo |
|---|---|
| ❶ | 70+ categorias de ferramentas integradas |
| ❷ | Uso das ferramentas principais |
| ❸ | Permissões e segurança de ferramentas |
| ❹ | Desenvolvimento de ferramentas personalizadas |
| ❺ | Gerenciamento de conjuntos de ferramentas |
2. História
(1) Problema: IA Só Conversa, Não Age
Bob pede ao ChatGPT "verifique o clima de hoje" — a IA diz "não posso acessar a internet". Pede "execute este código" — também não pode.
(2) Solução: 70+ Ferramentas Deixam o Agente Realmente Trabalhar
me: Verifique o clima de Pequim hoje
Agent: [web_search] [web_scrape]
Pequim hoje: Ensolarado, 26°C, qualidade do ar excelente
me: Execute este código Python
Agent: [code_python]
Código executado com sucesso, saída: Hello World
3. Categorias de Ferramentas Integradas
| Categoria | Ferramentas | Qtd |
|---|---|---|
| Sistema de Arquivos | fs_read, fs_write, fs_list, fs_search, fs_move, fs_delete | 10+ |
| Web | web_search, web_scrape, web_download, web_api | 8+ |
| Execução de Código | code_python, code_shell, code_node | 5+ |
| Visão | vision_analyze, vision_ocr, vision_screenshot | 5+ |
| Voz | voice_tts, voice_stt | 4+ |
| Dados | db_query, json_parse, csv_process | 10+ |
| Comunicação | email_send, msg_send | 8+ |
| Sistema | sys_info, process_run | 5+ |
4. Ferramentas Principais
(1) Sistema de Arquivos
Permite ler, escrever, buscar e mover arquivos. Exemplo: ler src/main.py, buscar arquivos com APIs depreciadas.
(2) Execução de Código
Executa código Python, Shell e Node.js em sandbox. Exemplo: calcular Fibonacci(20).
(3) Visão
Analisa imagens, OCR e capturas de tela. Exemplo: identificar problemas em uma captura de tela de página web.
5. Segurança de Ferramentas
| Nível | Ferramentas | Confirmação |
|---|---|---|
| Somente leitura | fs_read, web_search | ❌ Auto-executar |
| Escrita | fs_write, email_send | ✅ Confirmar |
| Perigoso | fs_delete, code_shell | ✅ Deve confirmar |
Configuração de sandbox com limites de tempo, memória, acesso à rede e caminhos permitidos/negados.
6. Desenvolvimento de Ferramentas Personalizadas
(1) Definição YAML
Para ferramentas simples de API: nome, descrição, categoria, parâmetros e configuração de execução.
(2) Ferramenta Python
Para lógica complexa: classe Python que herda de Tool com método execute().
7. Conjuntos de Ferramentas
toolsets:
frontend-dev:
tools: [fs_read, fs_write, code_node, code_shell, web_search, vision_analyze]
config:
fs_write.allowed_extensions: [".ts", ".tsx", ".css", ".html"]
hermes chat --toolset frontend-dev
/toolset data-analysis
❓ Perguntas Frequentes
P: Latência de chamada de ferramenta? R: Sistema de arquivos e execução de código <1s, Web depende da rede 2-10s, Visão 3-8s.
P: Execução de código é segura? R: Sandbox Docker padrão com restrições de rede e sistema de arquivos. Níveis de segurança configuráveis.
P: Ferramentas personalizadas são difíceis de desenvolver? R: Chamadas simples de API precisam apenas de YAML. Lógica complexa usa classe Python Tool.
📖 Resumo
- 70+ ferramentas integradas cobrindo sistema de arquivos, web, código, visão, voz, dados
- Níveis de segurança: leitura automática, escrita confirma, perigoso deve confirmar
- Ferramentas personalizadas: YAML para ferramentas de API, classes Python para lógica complexa
- Conjuntos de ferramentas: combinações pré-configuradas para cenários específicos
📝 Exercícios
- Básico (⭐): Use ferramentas de sistema de arquivos e execução de código, observe o processo de chamada de ferramenta.
- Intermediário (⭐⭐): Desenvolva uma ferramenta YAML personalizada conectando sua API (ex: GitHub API).
- Avançado (⭐⭐⭐): Crie um conjunto de ferramentas completo (5+ ferramentas) para seu cenário de trabalho diário.
