O que envia um agente ao registar horas?
Um registo de horas precisa de poucos dados para criar um lançamento. Tudo o que for enviado além disso é risco acrescido sem utilidade. Na Half5, a lista é a seguinte:
| Dados | Enviado? | Para quê |
|---|---|---|
| Descrição | Sim, uma linha | O que fez, numa frase que o cliente possa ler |
| Data, duração, hora de início e fim | Quando conhecido | O próprio lançamento |
| Cliente, projeto, atividade | Quando indicados | Escolher o cliente correto |
| Nome do repositório | De assistentes de código | Reconhecer o cliente; só o nome, nunca o caminho local |
| Branch e assuntos dos commits | Opcional, até 10 | Ajuda extra para cliente e projeto |
| Caminhos de ficheiros, código, conteúdos de ficheiros | Não | Não é necessário para registar horas |
A descrição pode aparecer numa fatura. Indique nas instruções do projeto do agente que escreva uma linha legível para o cliente, sem nomes de ficheiros ou classes.
O que vê o fornecedor de AI e o que armazena a Half5?
São entidades distintas. O seu assistente corre num fornecedor de AI como Anthropic, OpenAI ou Cursor. Processa toda a conversa: o seu pedido, as chamadas de ferramenta do agente e as respostas da Half5, como nomes de clientes ou a lista de lançamentos. O que o fornecedor faz com esses dados depende dos seus próprios termos e definições.
A Half5 só recebe o que o agente envia na chamada de ferramenta, não o resto da conversa. Armazena o lançamento, a indicação de que agente o criou com o nome do repositório e a sua memória de repositórios.
- No fornecedor de AI: a sua conversa, incluindo o que a Half5 devolve.
- Na Half5: o lançamento (descrição, data, duração, cliente, projeto, atividade), que agente o criou, o nome do repositório e a sua memória de repositórios.
- Em lado nenhum: a sua palavra-passe. A autenticação na Half5 é feita no seu navegador, não no assistente.
A que está a dar consentimento?
A ligação usa OAuth: o agente abre um ecrã de consentimento da Half5, onde inicia sessão e escolhe a organização. O ecrã mostra exatamente o que o agente pode fazer. Um agente não consegue obter mais do que isto pela ligação.
- Ver horas: as suas próprias horas e os clientes, projetos e atividades que pode consultar nessa organização.
- Registar horas: criar novas horas pendentes de aprovação, alterar ou eliminar as suas próprias horas ainda não aprovadas.
- Não: ver ou alterar faturas, colegas ou definições.
Se aparecer ‘Aplicação não verificada’, confirme que foi mesmo o utilizador a iniciar esta ligação. Se não tiver a certeza, escolha Recusar.
O que memoriza a Half5 e como pode apagar?
A Half5 memoriza, por utilizador, que repositório pertence a que cliente, para o agente não ter de perguntar sempre. Essa memória está associada a si e aparece em Definições → ‘Agentes ligados’ → ‘Memória de repositórios’. ‘Esquecer …’ apaga um repositório; ‘Esquecer tudo’ apaga todos.
Duas definições de organização em ‘Agentes AI’ determinam se a Half5 aprende também com outros. ‘Aprender com colegas’: se um colega já registou um repositório num cliente, a Half5 sugere esse cliente, mas o agente pergunta sempre primeiro. ‘Aprender com a aplicação desktop’: o trabalho do agente que regista na aplicação desktop conta para a sua própria memória. Os administradores podem ativar ou desativar estas opções.
Como se relaciona isto com a sua linha temporal?
A ligação MCP é independente da linha temporal nas apps Half5. A aplicação desktop pode colocar as suas sessões AI em Claude Code, Codex e Cursor na linha temporal, ao lado de apps e documentos. Essa linha temporal é encriptada de ponta a ponta: só o utilizador a pode ler, a Half5 não tem acesso e não é partilhada com a organização. As reuniões do calendário ligado são obtidas pelo servidor e visíveis apenas para si.
O seu gestor e administradores não podem aceder à sua linha temporal; nenhuma área ou relatório na Half5 a mostra a terceiros. Só veem o que regista: horas, ausências e deslocações. Os indicadores de produtividade na Half5 baseiam-se nessas horas registadas, não na linha temporal. A razão dessa distinção está em Produtividade sem vigilância; o funcionamento da linha temporal está em Registo automático de horas.
O que deve uma equipa acordar?
Alguns acordos evitam a maioria dos problemas. São rápidos de definir e aplicam-se a qualquer registo de horas com ligação a AI.
- Definir que assistentes AI podem ser usados e com que conta, profissional ou pessoal.
- Acordar que as descrições são uma linha legível para o cliente, sem código, caminhos ou dados confidenciais.
- Só ligar agentes que iniciou pessoalmente e recusar aplicações não verificadas que não reconheça.
- Enviar sempre as horas do agente para aprovação, como as restantes. Veja Registo de horas com AI.
- Enquanto administrador, decidir se ‘Aprender com colegas’ e ‘Aprender com a aplicação desktop’ devem estar ativos.
- Rever periodicamente os ‘Agentes ligados’ e desligar os que já não utiliza.
Como a Half5 faz
O servidor MCP da Half5 indica explicitamente aos agentes para nunca enviarem caminhos de ficheiros ou código e para escreverem a descrição numa linha legível para o cliente. Os lançamentos chegam como ‘Por aprovar’. Em Definições → ‘Agentes ligados’ pode ver o nome de cada ligação, se está verificada, quando foi usada pela última vez e o que pode fazer, e revogar o acesso com ‘Desligar’.
Como o log_work usa o repositório para escolher o cliente está em Como funciona o log_work. A Half5 não faz aqui declarações de certificação; o que faz ou não faz com os seus dados está na página de privacidade e confiança.
Perguntas frequentes
A Half5 lê a minha conversa com o Claude ou o ChatGPT?
Não. A Half5 só recebe o que o agente envia na chamada de ferramenta, como a descrição e a duração. A conversa em si fica com o fornecedor de AI.
O meu gestor pode ver o que faço com o assistente AI?
Não. As sessões AI ficam na sua linha temporal, que é encriptada de ponta a ponta e só o utilizador pode ler. O gestor vê as horas que regista, incluindo as que um agente registou por si.
Como apago o que a Half5 sabe sobre os meus repositórios?
Vá a Definições → ‘Agentes ligados’ → ‘Memória de repositórios’. Apague um repositório com ‘Esquecer …’ ou tudo com ‘Esquecer tudo’.
O que significa ‘Aplicação não verificada’ no ecrã de consentimento?
Que a Half5 não consegue confirmar quem criou o cliente. Pode ser um assistente normal, mas só deve permitir se foi mesmo o utilizador a iniciar a ligação.
Um agente envia o meu código-fonte para a Half5?
Não deve, e o servidor indica explicitamente aos agentes para não o fazerem. No máximo, o nome do repositório, o branch e alguns assuntos de commits são enviados como pistas para o cliente.
