Atoms
Choose a Workflow

Trabalhando com Agentes

Use os Atoms Agents para planejar, criar, pesquisar, analisar e melhorar um projeto a partir do Chat dele. Desative o Modo Equipe para uma solicitação focada ao Alex ou ative-o para o Mike e a equipe de especialistas. Este guia mostra como alternar modos, mencionar Agentes, acompanhar perguntas e planos, enfileirar acompanhamentos, revisar versões e se recuperar de um resultado incorreto.

Use os Atoms Agents para planejar, criar, pesquisar, analisar e melhorar um projeto a partir do Chat dele. Desative o Modo Equipe para uma solicitação focada ao Alex ou ative-o para o Mike e a equipe de especialistas. Este guia mostra como alternar modos, mencionar Agentes, acompanhar perguntas e planos, enfileirar acompanhamentos, revisar versões e se recuperar de um resultado incorreto.

Como funciona o trabalho em equipe com Agentes

Com o Modo Equipe desativado, Alex cuida da solicitação. Ative o Modo Equipe quando o trabalho precisar que Mike coordene várias etapas ou quando você quiser mencionar um Product Manager, Architect, Data Analyst ou outro especialista disponível.

No Modo Equipe, o trabalho pode passar de um Agente para outro. Acompanhe o Working Process e as mensagens do Agente até que não haja mais trabalho ativo. Se o resultado criar um cartão de Versão, selecione Preview para abri-lo no Visualizador de App e testá-lo antes de publicar ou solicitar outra alteração.

Ativar ou desativar o Modo Equipe

O botão de alternância do Modo Equipe fica no menu + ao lado do campo de entrada do Chat. Quando o botão está desativado, Alex cuida da solicitação. Quando está ativado, o Chat pode usar Mike e os Agentes especialistas disponíveis.

Antes de alternar: Você não pode mudar o Modo Equipe enquanto a Pesquisa Profunda ou o Atoms Cloud estiver ativo. A Pesquisa Profunda usa apenas Iris, então a lista normal de Group Members não fica disponível. Use os Agentes mostrados no Chat atual. Se o Modo Equipe estiver fixado como ativado e Alex for exibido, mencione Alex diretamente para uma tarefa de engenharia. Para usar as opções padrão do Modo Equipe, saia do fluxo de trabalho dedicado e abra um Chat normal do projeto.

  1. Abra o Chat do projeto.
  2. Selecione + ao lado da caixa de mensagem.
  3. No menu, ative o Modo Equipe para o fluxo de trabalho em equipe. Desative-o quando quiser que Alex cuide da solicitação.
  4. Feche o menu, escreva a solicitação e envie-a.

Se você digitar @ enquanto o Modo Equipe estiver desativado, o Chat mostrará Switch to team mode to mention Agent. Selecione Team para ativar o Modo Equipe e abrir Group Members, ou selecione Engineer para fechar o seletor e continuar trabalhando com Alex sem uma menção.

Ativar ou desativar o Modo Equipe

Ativar ou desativar o Modo Equipe

Deixe Mike coordenar o trabalho

Quando o Modo Equipe estiver ativado e Mike estiver disponível em Group Members, envie uma mensagem sem uma menção com @ quando quiser que Mike decida quais Agentes devem cuidar do trabalho. Esta é a opção mais simples para um resultado que abrange várias etapas. Se a Pesquisa Profunda estiver ativa, use Iris em vez disso.

  1. Certifique-se de que Mike esteja disponível. Ative o Modo Equipe quando o botão estiver disponível. Se o botão estiver bloqueado, use este fluxo de trabalho apenas quando Mike aparecer em Group Members.
  2. Descreva o resultado final, o estado atual do projeto, os limites importantes e como você avaliará o resultado.
  3. Envie a solicitação sem uma menção com @ para que Mike possa coordená-la. Para falar com ele explicitamente, digite @ e selecione Mike em Group Members.
  4. Acompanhe o Working Process e as mensagens do Agente. Responda a uma pergunta quando ela aparecer. Se um cartão de Plano estiver pronto, selecione Approve para continuar ou abra o menu de seta dele e selecione Decline quando o plano precisar de revisão.

Esse tipo de solicitação dá a Mike informações suficientes para planejar o trabalho sem exigir que você atribua cada etapa por conta própria.

Mencione um Agente diretamente

Mencione um Agente quando você souber quem deve receber uma tarefa focada.

  1. Em um projeto normal, selecione + ao lado do campo de entrada do Chat e ative o Modo Equipe. Se um fluxo de trabalho dedicado bloquear o modo, pule esta etapa e use apenas os Agentes mostrados no Chat atual.
  2. Digite @ na caixa de mensagem.
  3. Em Group Members, selecione o Agente.
  4. Após a menção, explique a tarefa, o contexto importante, o que deve permanecer inalterado e o resultado que você espera.
  5. Envie a mensagem.
Selecione um Agente em Group Members

Selecione um Agente em Group Members

Group Members normalmente inclui Alex, Bob, David, Emma e Mike. Sarah e Adrian aparecem em projetos shadcn/ui ou Atoms Cloud compatíveis. Quando a Pesquisa Profunda está ativada, o seletor de menção mostra apenas Iris. Use a lista mostrada no seu Chat como fonte da verdade.

Agente Função Use este Agente quando
Mike Líder da Equipe A tarefa precisa de planejamento, delegação ou coordenação entre vários Agentes.
Emma Product Manager Você precisa esclarecer usuários, prioridades, escopo, fluxos de trabalho ou trade-offs de funcionalidades.
Bob Architect Você precisa de ajuda com a estrutura do sistema, modelos de dados, integrações ou restrições técnicas.
Alex Engineer Você quer criar, alterar, corrigir ou testar a implementação do projeto.
David Data Analyst Você quer analisar dados, arquivos, métricas ou tendências.
Iris Pesquisadora Profunda Você precisa de pesquisa técnica, de mercado, concorrência ou público baseada em evidências.
Sarah Especialista em SEO Você quer planejar e melhorar conteúdo de SEO para um projeto web compatível.
Adrian Especialista em Ads Você quer preparar ou analisar Google Ads para um projeto web publicado e compatível.

Você não pode mencionar um Agente que não esteja mostrado em Group Members. Peça para Mike coordenar com a equipe disponível ou use o fluxo de trabalho dedicado que habilita o especialista de que você precisa.

Trabalhe com mais de um Agente

Você pode mencionar mais de um Agente na mesma mensagem do Modo Equipe. Use isso para tarefas independentes que não possam sobrescrever umas às outras e indique claramente qual parte cada Agente deve cuidar.

Separe cada atribuição com clareza e informe se o Agente pode alterar o projeto ou se deve apenas revisá-lo.

Para trabalhos dependentes, não envie todas as etapas para vários Agentes ao mesmo tempo. Peça para Mike coordenar a ordem e inclua o ponto em que você precisa aprovar o trabalho.

Use apenas os Agentes necessários para o resultado e depois revise Credits used após a conclusão do trabalho.

Acompanhe tarefas, aprovações e transferências

Acompanhe o trabalho no Chat do projeto. Working Process mostra etapas ativas dos Agentes, cartões de pergunta aguardam suas respostas, cartões de Plano aguardam aprovação e um cartão de Versão aparece quando o projeto produz uma versão que você pode visualizar.

O que você vê O que isso significa O que fazer
Working Processmostra um Agente como ativo A etapa atual ainda está em execução. Aguarde o resultado. Se Queue estiver habilitado, você pode digitar a próxima instrução e pressionar Return para colocá-la na fila sem interromper o trabalho ativo.
Um cartão de pergunta Mike precisa de informações antes que o fluxo de trabalho possa continuar. Responda a cada pergunta, useNextquando houver outra página e depois selecioneSubmit.
Um cartão de Plano O plano proposto está pronto para revisão e a execução ainda não começou. SelecioneApprovepara continuar. Para solicitar uma revisão, abra a seta ao lado de Approve e selecioneDecline.
A resposta final de um Agente Esse Agente concluiu a etapa atribuída a ele. Verifique oWorking Processe as mensagens posteriores antes de considerar a solicitação inteira como concluída.
Outro Agente começa a trabalhar O trabalho foi transferido para outro especialista. Acompanhe as mensagens do novo Agente e responda se ele pedir informações ou aprovação.
Um cartão de Versão O projeto produziu uma versão que pode ser revisada. Para a versão mais recente, selecionePreview. Para uma versão histórica, selecioneLoad previewprimeiro e depoisView Preview.

Uma resposta escrita, um Plano ou um resumo de pesquisa não confirma por si só que o projeto foi alterado. Quando a solicitação incluir implementação, procure o cartão de Versão resultante, selecione Preview e teste toda a jornada do usuário no Visualizador de App.

Envie um acompanhamento útil

Um acompanhamento útil informa ao Agente o que mudou, o que deve permanecer igual e como verificar o resultado.

Enquanto um Agente estiver trabalhando, digite a próxima instrução no campo de entrada do Chat. Quando o campo mostrar Press Return to queue the message, pressione Return. A mensagem é adicionada ao painel Queue acima do campo de entrada e fica aguardando sem interromper o trabalho ativo.

O painel Queue aparece automaticamente depois que a primeira mensagem é colocada na fila. Expanda-o se estiver recolhido. Arraste as mensagens para reordená-las; use Send now, Edit ou Remove em uma mensagem individual. Uma mensagem na fila com anexo não pode ser editada. O cabeçalho de Queue também oferece Clear queue, Pause processing queued messages e Resume processing queued messages.

Se Queue não estiver disponível, aguarde a tarefa atual terminar antes de enviar o acompanhamento. Não envie a mesma instrução repetidamente, porque solicitações duplicadas podem criar trabalho conflitante.

Revise um acompanhamento enfileirado

Revise um acompanhamento enfileirado

Recupere-se quando o trabalho travar ou seguir na direção errada

Comece pela etapa 1 e avance na lista apenas se a etapa anterior não resolver o problema.

  1. Verifique o status atual. Leia as mensagens mais recentes do Agente e o Working Process. Procure um Agente que ainda esteja ativo, uma pergunta ou Plano aguardando sua ação, ou um acompanhamento aguardando em Queue.
  2. Corrija a direção. Envie uma correção clara. Descreva o resultado pretendido, a menor mudança necessária e o que deve permanecer inalterado. Mencione o Agente que deve cuidar disso quando necessário.
  3. Interrompa o trabalho ativo apenas quando necessário. Selecione o controle quadrado de Parar à direita do campo de entrada do Chat. A dica de ferramenta dele diz Click if you want to stop all tasks. Na confirmação, selecione Yes, I'm Sure. Isso interrompe toda tarefa ativa naquele Chat, e a resposta interrompida é marcada como Response stopped.
  4. Restaure uma versão conhecida como boa. Se uma alteração concluída piorou o projeto, selecione Versions no cabeçalho do projeto. Escolha a última versão conhecida como boa. Se necessário, selecione Load preview e depois View Preview. Na visualização da versão, selecione Restore to this version. Antes de confirmar:
    • Se Sync database aparecer, revise com cuidado. Ele vem selecionado por padrão. Deixe-o selecionado se quiser restaurar o banco de dados com a versão; desmarque-o se quiser manter o banco de dados atual.
    • Selecione Restore para confirmar. O projeto retorna à versão selecionada. Versões posteriores continuam disponíveis em Versions e podem ser reaplicadas se necessário.
  5. Relate um problema com o Atoms. Se o próprio Atoms não estiver se comportando como esperado, abra ... na mensagem mais recente do Agente relevante e selecione Feedback. O ID do chat atual e o ID da mensagem são anexados automaticamente. Descreva as etapas exatas, o que você esperava, o que aconteceu em vez disso e inclua uma captura de tela clara quando for útil.

Antes de parar ou restaurar. Não use nenhuma dessas ações apenas porque uma tarefa está demorando mais do que o esperado. Interromper pode descartar o progresso ativo. Restaurar altera o estado atual do projeto e também pode alterar o banco de dados quando Sync database estiver selecionado.

Interromper todas as tarefas ativas

Interromper todas as tarefas ativas

Revise o resultado, os Créditos e as informações sensíveis

Antes de publicar, atualizar ou confiar no resultado, verifique se:

  • Cada etapa solicitada está concluída, incluindo qualquer transferência para outro Agente.
  • A versão final abre corretamente no Visualizador de App.
  • A principal jornada do usuário funciona do começo ao fim.
  • O Agente manteve as informações, funcionalidades e o design que você pediu para não alterar.
  • Nenhuma informação privada, credencial ou conteúdo apenas interno aparece no resultado.

Revise os Créditos usados

Na última mensagem do Agente em um turno concluído, abra .... O menu mostra Worked for; ele mostra Credits used depois que o turno termina e o uso fica disponível. Para verificar o saldo do espaço de trabalho, abra o menu do seu perfil e selecione Plans no desktop ou Plans and credits no mobile. No painel Plans and credits, revise Credits remaining.

Revise Credits used após cada turno concluído e revise o plano e o escopo antes de aprovar uma grande quantidade de trabalho.

Revise Worked for e Credits used

Revise Worked for e Credits used

Não cole senhas, chaves de API, tokens de autenticação, detalhes de pagamento ou informações pessoais ou confidenciais desnecessárias no Chat.

FAQ

O que devo fazer se o Atoms recusar uma solicitação porque ela pode ser prejudicial?

O Atoms pode recusar uma solicitação ou pedir esclarecimentos quando o resultado solicitado puder ser inseguro. Não tente ocultar, disfarçar ou dividir uma solicitação prejudicial para contornar essa resposta.

  1. Se o seu objetivo for legítimo, explique a finalidade segura, quem autorizou o trabalho e o que o resultado não deve fazer.
  2. Remova dados pessoais reais, credenciais, informações confidenciais e instruções que possam prejudicar outra pessoa ou sistema.
  3. Peça uma explicação defensiva, checklist de segurança ou exemplo inofensivo em vez de instruções que permitam uso indevido.
  4. Revise a solicitação revisada antes de enviá-la e mantenha-a limitada às informações necessárias para a tarefa segura.

Se uma solicitação claramente legítima e inofensiva ainda for recusada, entre em contato com o Atoms Support com o Chat Link e uma cópia da solicitação com dados sensíveis removidos. Explique o uso pretendido, mas não inclua informações sensíveis nem peça ao Support para contornar um controle de segurança.

Esta página foi útil?

Artigos relacionados