A Letaido / docs
DOCUMENTATION

Como conversar com ele

Padrões práticos que geram bons resultados e aqueles que desperdiçam uma rodada.

Seja específico sobre o artefato

Vago: "me ajude com e-mails de integração."

Específico: "elabore uma sequência de boas-vindas de 4 e-mails para novos assinantes do Ahrefs Starter, focada em fazer com que eles configurem seu primeiro Projeto. Um CTA por e-mail, cada um com menos de 120 palavras."

O agente trata o segundo como um briefing e produz rascunhos. O primeiro aciona um questionário de esclarecimento, o que é aceitável, mas custa uma ida e volta.

Diga o formato que você quer de volta

  • "Responda em uma tabela com colunas: ângulo, público, canal, responsável."
  • "Me dê apenas o JSON."
  • "Markdown com títulos, sem preâmbulo."

Os resultados padrão são conversacionais. As dicas de formato economizam edições.

Envie o trabalho para artefatos, não para o chat

Se você quiser algo que vai reutilizar, peça um arquivo ou um aplicativo, não uma resposta de chat. O chat rola para longe. Um arquivo na sua Área de trabalho, uma página no Console ou um trabalho agendado não.

Exemplos:

  • "Salve isso como ~/workspace/notes/q1-launches.md."
  • "Crie uma página do Console que mostre nossas 20 principais páginas orgânicas por tráfego, atualizada diariamente."
  • "Agende uma tarefa que me envie um e-mail toda sexta-feira com novas palavras-chave para as quais meus concorrentes começaram a classificar."

Use "lembrar disso"

O agente lê ~/workspace/.memory.md no início de cada conversa. Quando você diz "lembre-se disso", ele adiciona. Coisas boas para lembrar:

  • Sua função e equipe.
  • Vocabulário recorrente (nomes de produtos, siglas internas).
  • Regras de estilo ("nunca use travessões," "sempre envie em duas variantes").
  • Objetivos de longo prazo para que possa conectar os pontos mais tarde.

Coisas ruins para lembrar: qualquer coisa sensível, qualquer coisa que mude semanalmente.

Aprove uma vez, não a cada turno

Algumas ações exibem um cartão de aprovação: instalar um pacote Python, agendar um trabalho, permitir um novo domínio, conectar uma API de terceiros. O proprietário ou administrador clica uma vez; o agente tenta novamente automaticamente.

Se você continua travando nas aprovações, a solução geralmente é agrupar a solicitação: "configure a integração completa do Slack, solicite todos os escopos necessários de uma vez." Um cartão, um clique.

Quando pedir um plano vs partir para a execução

Solicitar um plano quando:

  • O trabalho afeta vários sistemas.
  • Você não tem certeza do que é viável.
  • Você quer opções para escolher.

Ir para a execução quando:

  • O resultado é pequeno e claramente definido.
  • Você tem um modelo em mente ("igual à última vez, mas para X").

O agente tem uma tendência a perguntar antes de trabalhos grandes. Você pode substituir isso com "pule o questionário, apenas construa."

Coisas que não funcionam bem

  • Colar uma captura de tela e dizer "você sabe o que fazer".
  • "Melhore isso". (Melhor do que o quê, em qual dimensão?)
  • "Faça tudo de uma vez". (Para trabalhos com vários sistemas, o agente planejará primeiro, quer você peça ou não.)
  • Conversas que se estendem por centenas de turnos. Inicie um novo chat para novas tarefas; a memória mantém o contexto importante entre elas.

Nos bastidores. Cada chat tem uma janela de contexto finita. O agente prefere gravar resultados intermediários no disco em vez de exibi-los no chat. Se você pedir "mostre-me todas as 5.000 linhas", ele as gravará em um arquivo e mostrará uma amostra mais uma contagem. Isso é intencional e mantém as sessões longas utilizáveis.

Last updated 2026-07-16