Perguntas frequentes
As perguntas que surgem na primeira semana.
Tem alguma dúvida? Pergunte ao agente
Se você tiver dúvidas sobre o que o Letaido pode fazer, encontrar um erro ou não tiver certeza de como algo funciona, a resposta mais rápida é perguntar diretamente ao agente no chat. Ele pode ler seus próprios documentos, ver sua área de trabalho, verificar suas configurações e orientar você sobre o que ele vê, tudo no mesmo lugar.
As perguntas frequentes abaixo cobrem as questões que surgem com mais frequência. Se a sua não estiver aqui, pergunte ao agente; se valer a pena incluir, o agente se oferecerá para adicioná-la.
Básico
Ele se lembra entre conversas?
Sim, mas apenas o que você disser para ele lembrar. Ele lê ~/workspace/.memory.md no início de cada conversa. Diga "lembre-se disso: X" e ele adiciona. O registro de alterações (progress.md) também é lido, então ele sabe o que foi construído recentemente.
Posso reverter algo que ele criou?
Arquivos são fáceis: pergunte "mostre o que você alterou na última hora e reverta X". Alterações no banco de dados não são revertidas automaticamente, mas cada ação é registrada, então desfazer geralmente é uma conversa clara. Para alterações destrutivas (excluir tabelas, remover habilidades), o agente pergunta antes de fazer.
Várias pessoas podem compartilhar uma área de trabalho?
Sim. As funções são proprietário, administrador, membro e visualizador. Proprietário e administrador decidem cartões de aprovação, gerenciam segredos e alternam o site público. Membros conversam e usam páginas do Console. Visualizadores são somente leitura.
Algo que eu digitar é enviado a terceiros?
O agente raciocina por meio de um provedor de LLM através de um proxy local. As mensagens são enviadas para inferência e as saídas retornam. Nenhuma retenção além do que a própria política do provedor do modelo estabelece. Nada é compartilhado com outras áreas de trabalho.
O que acontece quando uma API externa falha?
O agente relata a falha (código de status, categoria de erro se o conector expor uma), para e aguarda instruções. Ele não tenta novamente até que seu orçamento exploda.
Construindo coisas
Quanto tempo leva para criar um aplicativo de Console?
Os simples (um formulário, uma consulta, um resultado) ficam prontos em alguns minutos. Os complexos (pipeline de várias etapas, integrações de terceiros, visualização personalizada) levam uma sessão de chat, às vezes duas. O agente avisará se espera precisar de mais de uma ida e volta.
Como compartilho algo com um cliente?
Crie no site público, obtenha o URL, alterne o modo do site para open ou authorized, compartilhe o link. Padrões a conhecer: relatórios com token (/<route>/<token>), documentos públicos (este site), páginas de captura de leads.
O agente pode criar algo que nunca criou antes?
Sim, desde que os primitivos existam (blueprint do Console, rota do site, cron job, webhook, conector). Ele os compõe. Se o primitivo não existir (uma nova capacidade da plataforma for necessária), ele informará claramente em vez de fingir.
E se não houver um conector para o serviço de que preciso?
Peça ao suporte para adicionar um novo conector para esse aplicativo. Novos conectores são adicionados regularmente com base em solicitações de clientes; enquanto isso, o agente geralmente pode recorrer a uma chave de API genérica, uma lista de permissões de domínio e HTTP bruto, mas um conector adequado é sempre preferível (ele fornece entradas digitadas, registro, credenciais com escopo e aprovação por superfície prontos para uso).
Memória, habilidades, voz
Como faço para garantir que o agente use a voz da nossa marca?
Há uma habilidade de voz da marca na sua Área de trabalho. O agente a lê ao escrever ou revisar textos. Para adicionar uma nova regra: "atualize a habilidade de voz da marca para adicionar:
Por que você diz não aos travessões?
É uma escolha de estilo que esta área de trabalho assumiu. A regra está na memória e na habilidade de voz da marca, então todo rascunho (e esses documentos) os evita. Substitua por vírgulas, dois-pontos, pontos finais ou parênteses.
Devo colocar tudo na memória?
Não. A memória é para coisas que mudam os padrões do agente: quem você é, como você escreve, o que você se importa a longo prazo. Para regras de fluxo de trabalho ("nossa lista de verificação de lançamento padrão é X"), uma habilidade é melhor. Para contexto pontual ("este cliente é sensível sobre preços"), diga no chat.
Site público, documentos, resumo semanal
Como esses documentos são atualizados?
O código-fonte do markdown fica em ~/workspace/docs/*.md. O mantenedor edita manualmente. Um trabalho de sincronização (a cada 30 minutos) renderiza o markdown no banco de dados. O site público lê do banco de dados.
O que é o resumo semanal?
Um trabalho agendado que é executado às segundas-feiras às 10h00 no horário Europa/Bucareste. Ele compara a memória do agente, o registro de alterações e a pasta de habilidades desde o último resumo, pergunta ao LLM o que mudou e que os clientes devem saber, e envia sugestões de edições de documentação via Slack para o responsável pela manutenção. O responsável revisa; os documentos são atualizados.
Por que não publicar automaticamente as sugestões?
Dois motivos. (1) Uma edição sugerida por LLM pode estar sutilmente errada; a documentação é a cara pública do produto. (2) A revisão humana mantém a voz consistente e detecta coisas que parecem certas, mas não são.
Como faço para relatar um problema com a documentação?
Avise o agente no chat. Ele abrirá uma nota na área de trabalho e a apresentará ao responsável pela documentação no próximo resumo semanal.
Aprovações, segredos, dinheiro
Por que ele continua pedindo para eu aprovar coisas?
Como a ação custa dinheiro, acessa a rede ou envolve credenciais. Cada uma é registrada. A solução para "muitos cartões de aprovação" geralmente é agrupar a solicitação: peça ao agente para planejar todo o fluxo primeiro, para que ele solicite todos os escopos e aprovações de uma só vez.
Posso ver quais credenciais estão configuradas?
Sim, na interface da área de trabalho. Você pode ver o nome do segredo, o tipo, o status e a quais conectores e superfícies ele foi concedido. Você não pode ver o valor do segredo; ninguém pode, incluindo o agente.
Posso limitar a taxa de gastos do agente?
A plataforma mede tokens de LLM e chamadas de conector. Para controle de custos sustentado, os trabalhos são a superfície certa (eles são gastos recorrentes explícitos); o gasto com chat ad-hoc é o que você solicitar. Se um trabalho estiver com problemas, pause-o na aba Trabalhos.
Solução de problemas
O URL do site público retorna 403.
O modo do site está desativado. Alterne para autorizado (somente membros) ou aberto (qualquer pessoa) na guia Site público.
Uma página do Console está carregando para sempre.
A página está fazendo uma chamada externa longa (o tempo limite do nginx é de 30 segundos; trabalhos longos devem usar o padrão job-id-then-poll) ou o processo Flask travou. Verifique os logs finais em /home/console/http/data/.tail.log.
Uma chamada de conector retorna approval_pending ou not_approved.
Primeira vez para essa combinação de (conector, segredo, superfície). Aprove o cartão. Para superfícies de Console ou site, um proprietário ou administrador clica em request_connector_approval separadamente da superfície de chat.
Um trabalho não foi executado quando eu esperava.
Os horários do Cron são UTC no host. Se sua tarefa é "toda segunda-feira às 9h em Bucareste", a linha de agendamento é 0 7 * * 1 (verão) ou 0 8 * * 1 (inverno); o agente normalmente escolhe um e adiciona uma proteção de zoneinfo dentro do script para lidar com o horário de verão. Verifique a aba Jobs para ver o horário da próxima execução.
Um gatilho não está sendo acionado.
Verifique a lista de assinaturas. Se mostrar paused ou revoked, assine novamente. Se mostrar active, mas sem eventos, verifique a configuração do aplicativo de terceiros (a URL da assinatura também precisa ser definida do lado deles).
Minha área de trabalho está lenta.
Sessões de chat longas se degradam. Inicie um novo chat; a memória e o progresso transferem o contexto importante.