> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Escrever boas tarefas

> Dicas práticas para passar tarefas ao agente: defina o objetivo e o critério de conclusão, forneça contexto, divida tarefas grandes, escolha as permissões certas, automatize trabalhos repetitivos e peça ao agente para abrir um PR.

Quando a sua tarefa é clara, o agente erra menos o caminho e para menos vezes para perguntar a você. As dicas abaixo se aplicam à maioria das sessões.

## Defina o objetivo, o escopo e o critério de conclusão

Diga ao agente o que alcançar, onde fazer as alterações e como saber que o trabalho está concluído. Compare:

* "Corrija a página de login."
* "Corrija os campos de entrada desalinhados na página de login no Safari. Altere apenas os estilos da página de login e não mexa nas outras páginas. Quando terminar, execute os testes existentes e adicione um teste que cubra o Safari."

A segunda versão informa o objetivo, os limites e como verificar o resultado. O agente não precisa adivinhar e sabe quando parar e devolver o trabalho a você.

## Forneça arquivos e links relevantes

* **Escolha o projeto certo primeiro** para que o agente trabalhe no código e no ambiente corretos.
* Cite na tarefa os arquivos, as pastas, as mensagens de erro ou os links de documentação relevantes.
* Para problemas de interface, anexe uma captura de tela ou use **Take a screenshot** na caixa de entrada. Envie logs, arquivos de design e materiais semelhantes como anexos. Consulte [Iniciar uma sessão](https://docs.aihubmix.com/pt/cloud/sessions/start-a-session.md).
* Salve com antecedência nos segredos e nas variáveis de ambiente do projeto os segredos de que o agente vai precisar, para que ele não tenha que parar e pedi-los a você. Consulte [Projetos e configuração do ambiente](https://docs.aihubmix.com/pt/cloud/environments/projects.md).

## Divida tarefas grandes

Uma sessão costuma funcionar melhor quando se concentra em uma única coisa. Divida um pedido grande em várias sessões, por exemplo, peça ao agente que pesquise as opções primeiro e, depois, inicie a implementação com base no que ele encontrou.

* Quando partes de uma tarefa são independentes, diga quais partes podem ser executadas em paralelo. Em tarefas complexas, o agente pode iniciar [subagentes](https://docs.aihubmix.com/pt/cloud/sessions/subagents.md) para trabalhar nelas ao mesmo tempo e combinar os resultados automaticamente quando todos terminarem.
* Para tentar outra abordagem, use **Fork** para bifurcar uma nova sessão a partir de uma resposta. A sessão original não é afetada.
* Quando o agente sai do rumo, você não precisa esperar que ele termine. Use **Steer** para corrigi-lo imediatamente ou edite uma mensagem anterior e execute-a novamente. Consulte [Trabalhar com o agente](https://docs.aihubmix.com/pt/cloud/sessions/work-with-agent.md).

## Escolha as permissões certas

Novas sessões usam **Full access** por padrão, então o agente não pergunta a você sobre cada etapa. Isso é adequado para tarefas que você quer que ele conclua sozinho no servidor na nuvem. Sessões no servidor na nuvem nunca acessam o seu computador.

Mude para **Ask for approval** ou **Approve for me** nestes casos:

* A sessão é executada no seu próprio computador e envolve arquivos importantes ou configurações do sistema.
* O projeto tem segredos que você não quer que o agente use livremente. Com Full access, o agente pode ler todos os segredos do projeto.
* A tarefa se conecta a serviços ou sites externos, e você quer confirmar antes que ele aja.

## Use tarefas agendadas para trabalhos repetitivos

Para trabalhos que precisam acontecer regularmente, como "Verifique atualizações de dependências todos os dias úteis às 9h", diga ao agente em linguagem natural em uma sessão. Ele cria um rascunho de tarefa agendada, que só entra em vigor depois que você clica em **Create**. Para acompanhamentos ligados à sessão atual, como "Verifique a implantação de novo daqui a 30 minutos", peça ao agente que defina um temporizador de sessão. As tarefas agendadas são executadas no servidor na nuvem e continuam em execução quando o seu computador está desligado. Consulte [Tarefas agendadas](https://docs.aihubmix.com/pt/cloud/automation/scheduled-tasks.md).

## Peça ao agente para abrir um PR

Quando as alterações estiverem prontas, peça ao agente na sessão para fazer commit, push ou criar um PR, por exemplo "Crie um PR quando os testes passarem, com um título que descreva a correção." O comportamento padrão vem do comportamento de entrega nas configurações do projeto: criar um PR, enviar uma branch por push ou fazer o commit seguindo um prompt que você escrever. Para projetos enviados sem repositório remoto vinculado, as alterações são entregues como um patch. Para revisar alterações e entregar resultados, consulte [Revisar e entregar resultados](https://docs.aihubmix.com/pt/cloud/sessions/review-and-deliver.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.