Trabalhando com Agentes
Use os Agentes do Atoms para planejar, criar, pesquisar, analisar e melhorar um projeto a partir do Chat. 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 o trabalho em equipe do Agente funciona
Com o Modo Equipe desativado, Alex lida com a solicitação. Ative o Modo Equipe quando o trabalho precisar que Mike coordene várias etapas ou quando você quiser mencionar um Gerente de Produto, Arquiteto, Analista de Dados ou outro especialista disponível.
No Modo Equipe, o trabalho pode passar de um Agente para outro. Acompanhe o Processo de Trabalho e as mensagens do Agente até que não haja mais trabalho ativo. Se o resultado criar um cartão de Versão, selecione Pré-visualizar 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 Modo Equipe fica no menu + ao lado do campo de entrada do Chat. Quando o botão está desativado, Alex lida com a solicitação. Quando está ativado, o Chat pode usar Mike e os Agentes especialistas disponíveis.
Antes de alternar: Você não pode alterar o Modo Equipe enquanto Pesquisa Profunda ou Atoms Cloud estiver ativo. A Pesquisa Profunda usa apenas Iris, então a lista normal de Membros do Grupo 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.
- Abra o Chat do projeto.
- Selecione + ao lado da caixa de mensagem.
- No menu, ative o Modo Equipe para o fluxo de trabalho em equipe. Desative-o quando quiser que Alex lide com a solicitação.
- Feche o menu, escreva a solicitação e envie-a.
Se você digitar @ enquanto o Modo Equipe estiver desativado, o Chat mostrará Mude para o modo equipe para mencionar um Agente. Selecione Equipe para ativar o Modo Equipe e abrir Membros do Grupo, ou selecione Engenheiro para fechar o seletor e continuar trabalhando com Alex sem uma menção.
Ativar ou desativar o Modo Equipe
Deixe Mike coordenar o trabalho
Quando o Modo Equipe estiver ativado e Mike estiver disponível em Membros do Grupo, envie uma mensagem sem uma menção com @ quando quiser que Mike decida quais Agentes devem lidar com o trabalho. Esta é a opção mais simples para um resultado que abrange várias etapas. Se a Pesquisa Profunda estiver ativa, use Iris no lugar.
- 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 Membros do Grupo.
- Descreva o resultado final, o estado atual do projeto, os limites importantes e como você avaliará o resultado.
- Envie a solicitação sem uma menção com @ para que Mike possa coordená-la. Para se dirigir a ele explicitamente, digite @ e selecione Mike em Membros do Grupo.
- Acompanhe o Processo de Trabalho e as mensagens do Agente. Responda a uma pergunta quando ela aparecer. Se um cartão de Plano estiver pronto, selecione Aprovar para continuar ou abra o menu de seta e selecione Recusar 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.
- Em um projeto normal, selecione + ao lado da 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.
- Digite @ na caixa de mensagem.
- Em Membros do Grupo, selecione o Agente.
- Após a menção, explique a tarefa, o contexto importante, o que deve permanecer inalterado e o resultado que você espera.
- Envie a mensagem.
Selecione um Agente em Membros do Grupo
Membros do Grupo normalmente inclui Alex, Bob, David, Emma e Mike. Sarah e Adrian aparecem em projetos compatíveis com shadcn/ui ou Atoms Cloud. 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.
| Agent | Função | Use este Agente quando |
|---|---|---|
| Mike | Líder de Equipe | A tarefa precisa de planejamento, delegação ou coordenação entre vários Agentes. |
| Emma | Gerente de Produto | Você precisa esclarecer usuários, prioridades, escopo, fluxos de trabalho ou trade-offs de funcionalidades. |
| Bob | Arquiteto | Você precisa de ajuda com estrutura do sistema, modelos de dados, integrações ou restrições técnicas. |
| Alex | Engenheiro | Você quer criar, alterar, corrigir ou testar a implementação do projeto. |
| David | Analista de Dados | Você quer analisar dados, arquivos, métricas ou tendências. |
| Iris | Pesquisadora de Pesquisa Profunda | Você precisa de pesquisa de mercado, concorrentes, público ou técnica 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 compatível. |
Você não pode mencionar um Agente que não esteja mostrado em Membros do Grupo. 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 em Modo Equipe. Use isso para tarefas independentes que não possam sobrescrever umas às outras e informe claramente de 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 trabalho dependente, 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ê deve aprovar o trabalho.
Use apenas os Agentes necessários para o resultado e depois revise Créditos usados após a conclusão do trabalho.
Acompanhe tarefas, aprovações e transferências
Acompanhe o trabalho no Chat do projeto. Processo de Trabalho 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 pré-visualizar.
| O que você vê | O que isso significa | O que fazer |
|---|---|---|
| Processo de Trabalho mostra um Agente como ativo | A etapa atual ainda está em execução. | Aguarde o resultado. Se a Fila estiver habilitada, 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, use Próximo quando houver outra página e depois selecione Enviar. |
| Um cartão de Plano | O plano proposto está pronto para revisão e a execução ainda não começou. | Selecione Aprovar para continuar. Para solicitar uma revisão, abra a seta ao lado de Aprovar e selecione Recusar. |
| A resposta final de um Agente | Esse Agente concluiu a etapa atribuída. | Verifique o Processo de Trabalho e as mensagens posteriores antes de considerar toda a solicitação 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 solicitar 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, selecione Pré-visualizar. Para uma versão histórica, selecione Carregar prévia primeiro e depois Ver Prévia. |
Uma resposta escrita, Plano ou 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 Pré-visualizar 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 na entrada do Chat. Quando a entrada mostrar Pressione Return para enfileirar a mensagem, pressione Return. A mensagem é adicionada ao painel Fila acima da entrada e aguarda sem interromper o trabalho ativo.
O painel Fila aparece automaticamente após a primeira mensagem ser enfileirada. Expanda-o se estiver recolhido. Arraste as mensagens para reordená-las; use Enviar agora, Editar ou Remover em uma mensagem individual. Uma mensagem enfileirada com anexo não pode ser editada. O cabeçalho da Fila também oferece Limpar fila, Pausar processamento de mensagens enfileiradas e Retomar processamento de mensagens enfileiradas.
Se Fila 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
Recupere-se quando o trabalho estiver travado ou seguindo na direção errada
Comece pela etapa 1 e avance na lista apenas se a etapa anterior não resolver o problema.
- Verifique o status atual. Leia as mensagens mais recentes do Agente e o Processo de Trabalho. Procure um Agente que ainda esteja ativo, uma pergunta ou Plano aguardando sua entrada, ou um acompanhamento aguardando na Fila.
- Corrija a direção. Envie uma correção clara. Descreva o resultado pretendido, a menor alteração necessária e o que deve permanecer inalterado. Mencione o Agente que deve lidar com isso quando necessário.
- Interrompa o trabalho ativo apenas quando necessário. Selecione o controle quadrado de Parar à direita da entrada do Chat. A dica de ferramenta diz Clique se quiser parar todas as tarefas. Na confirmação, selecione Sim, tenho certeza. Isso interrompe toda tarefa ativa naquele Chat, e a resposta interrompida é marcada como Resposta interrompida.
- Restaure uma versão conhecida como boa. Se uma alteração concluída piorou o projeto, selecione Versões no cabeçalho do projeto. Escolha a última versão conhecida como boa. Se necessário, selecione Carregar prévia e depois Ver Prévia. Na prévia da versão, selecione Restaurar para esta versão. Antes de confirmar:
- Se Sincronizar banco de dados aparecer, revise com cuidado. Ela vem selecionada por padrão. Deixe-a selecionada se quiser restaurar o banco de dados com a versão; desmarque-a se quiser manter o banco de dados atual.
- Selecione Restaurar para confirmar. O projeto retorna à versão selecionada. Versões posteriores permanecem disponíveis em Versões e podem ser reaplicadas se necessário.
- Relate um problema com o Atoms. Se o próprio Atoms não estiver se comportando como esperado, abra ... na mensagem relevante mais recente do Agente 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 Sincronizar banco de dados estiver selecionado.
Parar todas as tarefas ativas
Revise o resultado, Créditos e informações sensíveis
Antes de publicar, atualizar ou confiar no resultado, verifique se:
- Todas as etapas solicitadas foram concluídas, 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 Tempo trabalhado; ele mostra Créditos usados 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 Planos no desktop ou Planos e créditos no celular. No painel Planos e créditos, revise Créditos restantes.
Revise Créditos usados após cada turno concluído e revise o plano e o escopo antes de aprovar uma grande quantidade de trabalho.
Revise Tempo trabalhado e Créditos usados
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.
- Se o seu objetivo for legítimo, explique a finalidade segura, quem autorizou o trabalho e o que o resultado não deve fazer.
- Remova dados pessoais reais, credenciais, informações confidenciais e instruções que possam prejudicar outra pessoa ou sistema.
- Peça uma explicação defensiva, checklist de segurança ou exemplo inofensivo em vez de instruções que permitam uso indevido.
- 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 Atoms Support com o Link do Chat e uma cópia da solicitação com informações sensíveis removidas. Explique o uso pretendido, mas não inclua informações sensíveis nem peça ao Suporte para contornar um controle de segurança.