Your first Agent

O que é isto

O seu agente é um assistente de inteligência artificial que corre na sua máquina. Diferente do ChatGPT ou de outros serviços online, este agente:

Trabalha com os seus ficheiros e documentos
Não envia os seus dados para a internet
Está sempre disponível (não precisa de browser)
Pode executar tarefas passo a passo sem que tenha de supervisionar cada ação

Pense nele como um colaborador que está sempre disponível, que pode ler os seus documentos e que executa tarefas na sua máquina — mas que precisa de instruções claras sobre o que fazer.

Como iniciar o agente

Abra o terminal e escreva:

hermes --tui

O agente inicia e está pronto a receber instruções. Pode fechar o terminal a qualquer momento — a sessão é guardada automaticamente.

Para voltar à última sessão:

hermes --tui --continue

Para começar uma sessão nova (limpar tudo e recomeçar):

hermes --tui --new

Como falar com o agente

Escreva em linguagem natural, como se estivesse a explicar uma tarefa a um colaborador.

Exemplos do que pode pedir:

"Lê o ficheiro contrato-2024.pdf e faz um resumo dos pontos principais."
"Tens acesso à pasta documentos/. Lista todos os ficheiros PDF que lá estão."
"Escreve um email ao cliente João Silva a confirmar a reunião de amanhã."
"Analisa o relatório financeiro.txt e identifica os três maiores custos."
"Organiza esta lista de tarefas por prioridade e adiciona prazos estimados."

> Dica importante: Se quiser que o agente trabalhe com um ficheiro específico, diga-lhe o caminho completo. Se quiser que trabalhe com todos os ficheiros de uma pasta, diga-lhe qual é a pasta.

Tarefas complexas: o comando /goal

Para tarefas que requerem vários passos, use o comando /goal. O agente trabalha de forma autónoma até completar o objetivo.

Exemplo:

/goal "Lê todos os ficheiros PDF na pasta contratos/, extrai as datas de vencimento, e cria uma lista ordenada por data."

O agente começa a trabalhar imediatamente. Pode verificar o progresso com:

/goal status

Para parar o trabalho (sem apagar o objetivo):

/goal pause

Para retomar:

/goal resume

Para apagar o objetivo completamente:

/goal clear

Quando usar /goal:

Tarefas com mais de 2 ou 3 passos
Trabalho que requer ler múltiplos ficheiros
Tarefas repetitivas que o agente pode fazer sozinho

Quando NÃO usar /goal:

Uma pergunta simples
Uma tarefa única (ex: "resume este ficheiro")
Quando quer supervisionar cada passo

Segurança: permissões antes de agir

Antes de executar ações que modificam ficheiros ou correm comandos no sistema, o agente pergunta a sua autorização. Vê algo como:

Approval required
Command: write_file
Path: /home/utilizador/documento-novo.txt
Allow? (y/n):

Isto protege-o de alterações indesejadas. Responda y (sim) ou n (não).

> Regra geral: Aprovar quando entende o que o agente vai fazer e concorda. Negar quando não tem certeza ou quando a ação parece errada.

O agente nunca apaga ficheiros sem perguntar. Nunca envia dados para a internet sem perguntar. Nunca modifica ficheiros do sistema sem perguntar.

Comandos úteis

Estes são os comandos que provavelmente vai usar:

Comando	O que faz
`/help`	Mostra a lista de comandos disponíveis
`/new`	Começa uma sessão nova (limpa tudo)
`/save`	Guarda a conversa num ficheiro
`/continue`	Volta à última sessão
`/goal "texto"`	Define um objetivo para trabalho autónomo
`/goal status`	Verifica o progresso do objetivo
`/goal pause`	Pausa o trabalho do objetivo
`/goal resume`	Retoma o trabalho do objetivo
`/goal clear`	Apaga o objetivo
`/quit`	Sai do agente

O que o agente faz bem

Ler e resumir documentos — entende o conteúdo e extrai o essencial
Escrever e editar texto — redige emails, relatórios, documentos
Organizar informação — classifica, ordena, estrutura dados
Responder perguntas — sobre os ficheiros que tem acesso
Executar tarefas passo a passo — quando usa /goal
Trabalhar 24 horas — desde que a máquina esteja ligada

O que o agente NÃO faz (ainda)

Para ser honesto sobre o que pode esperar:

Não está ligado ao seu email — não pode ler ou enviar emails
Não está ligado ao seu site — não pode atualizar páginas web
Não está ligado aos seus outros sistemas — (software de faturação, CRM, etc.)
Não lembra de sessões anteriores — cada sessão começa "limpa" (a menos que use /continue)
Não adivinha o que quer — precisa de instruções claras

Estas capacidades são a segunda fase. Quando estiver pronto para avançar, podemos ligar o agente aos seus sistemas.

Problemas comuns

O agente não responde:

Verifique se a máquina está ligada e com internet (para a API de IA)
Tente Ctrl+C e inicie novamente com hermes chat

O agente diz que não consegue aceder a um ficheiro:

Verifique o caminho do ficheiro (deve ser completo: /home/utilizador/pasta/ficheiro.txt)
Verifique se tem permissões para ler esse ficheiro

O agente faz algo inesperado:

Responda n à próxima permissão
Use /new para começar uma sessão limpa
Contacte-nos se o problema persistir

A sessão ficou muito longa e o agente parece confuso:

Use /new para começar uma sessão nova
Ou use /save para guardar o que precisa e depois /new

Quando nos contactar

Contacte-nos quando:

Não consegue iniciar o agente
O agente está a comportar-se de forma inesperada
Quer adicionar capacidades (ligar a sistemas, adicionar perfis especializados)
Tem dúvidas sobre como usar uma funcionalidade
Quer avançar para a segunda fase (ligação a sistemas locais)

> Dica final: O agente melhora com instruções claras. Em vez de "ajuda-me com isto", diga "lê o ficheiro X, extrai os dados Y, e cria uma tabela com os resultados organizados por Z". Quanto mais específico for, melhor será o resultado. > > Se algo não funcionar como esperava, não se frustre — comece uma sessão nova com /new e tente reformular a instrução de forma diferente.

Suporte: contact@sophia.host Informação técnica: #main — irc.sophia.host Web: sophia.host