Antes de começar
Este guia usa o exemplo do Twitter, twitter-starter, para construir um recurso: compartilhar um emoji gigante com texto embaixo. Você vai descrever o que quer diretamente ao agente, acompanhar o trabalho dele e revisar o resultado final. Você pode usar o mesmo fluxo de trabalho para outro recurso ou para um bug que queira corrigir.
- Instale o Panolayer, faça login e abra o exemplo Twitter Clone. Consulte Instalar e configurar o Panolayer se você ainda não abriu um repositório.
- Use o Panolayer Agent, que é integrado. Você também pode usar qualquer outro agente compatível, que precisa ser instalado antes do uso. Consulte Agentes compatíveis para configurar.
Você vai terminar com uma alteração revisada registrada no seu histórico Git local. Enviá-la para um remoto é um passo separado.
Inicie o Panolayer Agent
- Abra Meus Agentes na barra lateral.
- Clique no botão + ao lado de Monitorar Agentes para abrir o menu de agentes.
- Selecione Panolayer Agent para este passo a passo.
O menu inclui o Panolayer Agent e os agentes que você instalou. Você pode escolher qualquer um deles para corrigir um bug ou construir código.
O Panolayer Agent funciona como os agentes de código que você já usa. Peça a ele para construir um recurso, corrigir um bug ou responder a uma pergunta sobre seu código. Digite sua solicitação em Converse com seu código ou construa algo… e continue a conversa enquanto trabalha.
Começando a partir de uma issue? Em Issues, escolha Corrigir e selecione Panolayer Agent. O Panolayer leva o contexto da issue para a tarefa. Siga o passo a passo do primeiro bug para esse caminho.
Dê a ele uma tarefa com um resultado claro
Descreva o que está errado ou o que você quer construir, o que deve acontecer quando funcionar e qualquer coisa que o agente deva preservar. Cite um arquivo ou uma função quando você souber.
Para o exemplo do Twitter, use a mesma solicitação mostrada na captura de tela:
add a new feature where you can share a giant emoji with text underneath
Digite sua solicitação na caixa de mensagem e clique na seta de enviar.
O Panolayer Agent pode usar o mapa de código para encontrar as funções e relações relevantes enquanto trabalha. Você pode se referir ao comportamento que lhe importa mesmo quando não conhece todos os nomes de arquivo.
Se o agente fizer uma pergunta, responda na mesma conversa. Se precisar restringir a tarefa, declare o resultado específico que você quer.
Acompanhe o trabalho sem abrir mão do seu workspace
Quando o Panolayer Agent inicia uma execução de código, o progresso aparece na conversa. O trabalho de código acontece em um Git worktree isolado: um checkout separado onde o agente pode editar e testar o código enquanto seu workspace principal permanece disponível.
Acompanhe a tarefa na conversa
O cartão de execução mostra a tarefa e a atividade atual enquanto o agente constrói o recurso de emoji gigante. Você pode acompanhar o progresso e ver os arquivos e comandos que ele está usando enquanto trabalha.
Abra a execução para ver mais detalhes
Escolha Abrir no lado direito do cartão para ver a atividade da execução. Em Stream, selecione uma atividade para inspecionar o comando e sua saída no painel à direita. Use Voltar ao agente para retornar à conversa.
Veja quando a execução termina
Quando o trabalho termina, o cartão é atualizado para Execução do subagente concluída. O banner Concluído resume as verificações e o número de arquivos alterados. Você ainda pode escolher Abrir para inspecionar a execução concluída.
Você pode continuar trabalhando e voltar à execução depois. Use Monitor Agents para ter uma visão geral quando houver mais de um agente trabalhando. Vários agentes podem trabalhar no mesmo repositório em worktrees separados; revise como as mudanças se encaixam antes de mesclá-las.
Mantenha um acompanhamento vinculado à sua tarefa. Use a referência de execução mostrada na sua conversa ao enviar um acompanhamento, para ficar claro a qual tarefa você se refere.
Revise o resultado da verificação
Revise o código alterado junto com o resultado da verificação antes de mesclar. Consulte Revisar mudanças e commit para o guia completo de revisão das mudanças de um agente.
Quando o agente solicita um merge, leia o resumo da verificação: Regras aprovadas, Execuções de verificação e Arquivos alterados. Revise quaisquer novas falhas separadamente dos problemas que já existiam.
Nesta execução, o resumo mostra 110 de 121 regras aprovadas, 1 execução de verificação e 16 arquivos alterados. Ele identifica 11 falhas pré-existentes separadamente e não relata novas falhas, avisos ou regras não verificadas. Seus totais vão depender da sua tarefa.
Abra Detalhes para investigar o resultado mais a fundo. Consulte Entender um resultado de verificação para os campos de resumo e os status.
Verifique o comportamento no app em execução quando a tarefa exigir. Para este exemplo, tente criar um post com um emoji gigante e texto embaixo e depois confirme que posts de texto comuns continuam funcionando como esperado.
Merge when you’re ready
You decide what moves from the agent’s worktree into your branch. Choose Not now to keep reviewing. Once you’re satisfied with the changes and results, confirm the target branch and choose Merge into main for the Twitter sample.
The Merged into main confirmation shows a commit ID. This workflow records the change in local Git history, so you don’t need to commit that same change again.
Open Changes and find the commit in History. Check for unexpected uncommitted edits. If your repository has a remote and you want to share the commit, use Git → Push.
You’ve given an agent a task, followed its work, reviewed the result, and decided what reaches your branch.