Ir para o conteúdo
Documentação

Recursos · 4 min de leitura

Modo Agente

O Modo Agente é a superfície para tudo o que seja maior do que uma frase de trabalho. Diz «olá agente» ou enuncia uma tarefa que claramente precisa de vários passos, o Katchy lança uma sessão em segundo plano que planeia, executa, verifica o seu trabalho e mostra o resultado num pequeno cartão na dock ao lado do teu cursor.

O que um agente consegue fazer

  • Ler e escrever ficheiros em qualquer lugar onde tenhas concedido acesso.
  • Correr comandos da shell, git, npm, curl, python, qualquer coisa no teu PATH.
  • Abrir aplicações, clicar, arrastar, escrever (com o Computer Use ativado).
  • Pesquisar na web e seguir ligações.
  • Persistir memória, cada tarefa concluída é registada para que as sessões futuras saibam o que aconteceu.

O que um agente não consegue fazer

  • Mexer em nada fora das permissões do macOS que concedeste.
  • Usar credenciais que não lhe foram dadas.
  • Sobreviver a um encerramento do Katchy, fechar a aplicação interrompe os agentes em curso de forma limpa.

O cartão da dock

Enquanto um agente trabalha, vês um pequeno cartão ao lado do cursor com:

  • O título da tarefa (gerado automaticamente, começa por substantivo, por exemplo, «Limpeza dos Lembretes», não «Podes Por Favor…»)
  • Etapa atual, A planear / A executar / A compor resposta / Concluído
  • Uma linha de passo ao vivo com o comando de shell mais recente ou um excerto do assistente
  • Próximas ações sugeridas quando a tarefa termina

Clica no cartão para o registo completo da conversa, ou carrega em Parar / Dispensar sem nunca abrires o painel.

Combinar voz + agente

Os dois modos foram concebidos para serem usados em conjunto. A voz é o primeiro plano (uma pergunta, uma resposta); os agentes são o segundo plano (tarefas longas). Um ciclo típico:

  1. Voz: «o que está a impedir este teste de passar?»
  2. Lê a resposta. Pensa.
  3. Entrega: «olá agente, corrige o import em falta em auth/session.ts e volta a correr o teste.»
  4. Continua a trabalhar na próxima coisa. O cartão da dock do agente pisca quando termina.

Ações destrutivas perguntam primeiro

Eliminar, enviar, publicar, sobrescrever, as ações destrutivas pedem confirmação por predefinição. Tudo o resto podes desfazer com o habitual Cmd + Z. Podes parar o agente a qualquer altura com o mesmo atalho Control + Option.

Também disponível como markdown simples.

A seguir em Recursos

Motores de agente: Codex e Hermes

O Modo Agente é alimentado por dois motores. O Codex é o predefinido, polido e pronto a usar. O Hermes é a alternativa aberta e totalmente local. Eis quando cada um vence.