Documentação / O agente

Pedir uma tarefa

Como trabalhar com o agente do início ao fim sem perder o controle.

Escreva o que você precisa como diria a um colega. O agente propõe, o IDE controla e você autoriza.

Antes de começar

  • Abra o projeto e aguarde o fim da indexação (a barra superior do editor indica). Você pode escrever enquanto isso.
  • Conecte uma IA: sua assinatura ou uma API key. Veja Conectar uma IA.
  • Mostre o chat com Ctrl+Alt+I se ele estiver oculto. A partir do editor, Ctrl+L leva o foco ao chat.

1. Descreva o resultado

Diga o que você quer e como saberá que está certo.

Em vez de… Escreva…
“Corrija o login” “O login falha com usuários que têm acento no e-mail. Corrija e adicione um teste que cubra isso.”
“Faça um endpoint” “Adicione GET /api/orders/{id} que retorne 404 se não existir. Siga o estilo de ProductController.”

Você pode anexar arquivos com o clipe e mencionar código. O código colado é reconhecido com sua linguagem.

O agente sempre responde no idioma em que você escreve.

2. Responda às perguntas

Se faltar algo, o agente pergunta durante a análise, tudo de uma vez, em cartões Perguntas da Yuli:

  • Cada pergunta traz sua opção Recomendada.
  • Outra resposta… permite escrever a sua.
  • Yuli decide delega essa pergunta; Decida tudo você escolhe a recomendada em todas.
  • Teclado: 1–9 escolhe, Enter avança, ← volta.

3. Acompanhe o plano

As tarefas de vários arquivos se tornam uma missão com um plano de passos verificáveis e progresso ao vivo. A barra da missão, acima do chat, mostra a fase atual: Fase n de 8. Veja Missões e fases.

Enquanto trabalha, o workboard mostra o que ele faz a cada momento: Analisando, Investigando, Editando, Verificando…

Você pode continuar escrevendo: suas mensagens ficam na fila e você pode perguntar “como está indo?”.

4. Autorize o que tem efeitos

Quando o agente precisa executar um comando ou fazer algo com consequências, aparece o cartão Autorização necessária:

  • Autorizar ou Executar aprova; Rejeitar descarta.
  • Sempre neste chat evita que ele pergunte de novo sobre essa mesma ação na conversa.
  • Ctrl+Alt+Enter autoriza tudo o que estiver pendente.

5. Revise as alterações

Nenhuma alteração chega ao disco sem revisão. Cada proposta chega como um cartão com seu diff. Abra todas em Alterações da IA com Ctrl+Alt+R. Veja Revisar alterações.

6. Receba a entrega

Ao terminar, o agente:

  1. Mede o código que tocou contra a versão anterior e dá uma única linha com o veredicto.
  2. Compila, testa e inicia o aplicativo.
  3. Resume o que foi feito, o que foi verificado, as decisões e o que ficou pendente.

Desfazer

  • Alt+Shift+Z desfaz a última coisa que o agente aplicou.
  • Ctrl+Alt+Shift+Z desfaz a última tarefa completa, com todos os seus arquivos.
  • ↺ Desfazer tarefa no resumo do turno faz o mesmo, com pré-visualização.

O que o agente nunca faz sem você pedir

  • Commit, push, merge ou criar branches.
  • Escrever em um banco de dados.
  • Ler .env, chaves ou credenciais.

Veja Sandbox e permissões.

Mais formas de trabalhar

Se você quer… Use
Que ele trabalhe sozinho até terminar Modo autônomo
Dividir um trabalho grande entre vários agentes Equipe de agentes
Delegar algo longo sem mexer na sua cópia de trabalho Tarefas em segundo plano (Alt+Shift+B)
Desenhar uma tela Web Studio