Configurar as tarefas de agente

Ativar a funcionalidade

As tarefas de agente ativam-se por projeto, não por conta. Abre o projeto, vai a Definições, depois ao separador Agente, e assinala Ativar tarefas do agente. Isso arranca um poller dentro de cada instância de staging e de desenvolvimento do projeto, pronto a recolher trabalho.

Precisas da permissão de definições do projeto para veres e alterares este separador. Se não o conseguires abrir, fala com quem administra o teu espaço de trabalho.

Escolher uma CLI

Em CLI do agente, escolhe que CLI de programação planeia e executa as tarefas deste projeto:

• Claude Code
• Gemini CLI
• Codex CLI

Cada uma inicia sessão com a sua própria credencial e corre na tua própria conta junto desse fornecedor. O CICDoo não revende acesso a modelos; o agente usa a subscrição ou a chave que forneces, e as execuções contam para a tua quota aí.

Podes mudar de CLI mais tarde. Uma credencial já guardada mantém a sua máscara, por isso mudar para outra e voltar atrás não volta a pedir o segredo.

Ligar a tua conta

A forma de ligação depende da CLI, e essa diferença determina quem paga.

Claude Code

Executa claude setup-token na tua máquina, o que exige uma subscrição Claude, e cola o token em Token do Claude Code. É o único modo que o Claude Code oferece aqui.

Gemini CLI e Codex CLI

Ambas podem funcionar de duas formas, escolhidas em Como o agente inicia sessão:

• A tua própria subscrição. Inicia sessão na CLI na tua máquina e cola depois todo o conteúdo do ficheiro de sessão em cache: ~/.gemini/oauth_creds.json para o Gemini, ~/.codex/auth.json para o Codex. O agente renova-o à medida que corre e devolve a cópia renovada, por isso não deverás ter de repetir isto.
• Chave de API, faturada por token. Cria uma chave no Google AI Studio ou no painel da plataforma da OpenAI e cola-a aqui. As execuções são faturadas nessa chave pelo fornecedor.

Uma licença paga do Gemini Code Assist precisa também do id do projeto Google Cloud. Deixa esse campo vazio se usares uma conta Google pessoal.

Lê isto antes de colares uma credencial

A credencial é guardada na plataforma e enviada para os contentores da tua instância para o agente se poder autenticar. Qualquer pessoa com acesso a shell ou ao IDE desses contentores consegue lê-la.

Um ficheiro de sessão é algo mais poderoso de entregar do que uma chave de API. É a sessão da tua conta, não uma credencial com âmbito limitado: não pode ser revogado isoladamente e é o que a CLI usaria se alguém a executasse à mão dentro do contentor. Os fornecedores também orientam estes planos para uso interativo, e a OpenAI recomenda uma chave de API para fluxos automatizados, por isso confirma os termos do teu plano antes de apontares um agente a uma subscrição pessoal.

Se isso for um problema na tua configuração, usa o modo de chave de API onde o fornecedor o disponibilize: uma chave pode ter âmbito limitado e ser revogada isoladamente.

Definições opcionais

• Modelo. Um alias de modelo ou o nome completo do modelo para a CLI que escolheste. Deixa vazio para usar o predefinido.
• Executar planos automaticamente. As novas tarefas deste projeto saltam o passo de revisão: um plano bem-sucedido é aprovado automaticamente e depois implementado e enviado sem que ninguém o leia primeiro. Um plano que o agente reporte como bloqueado continua a esperar por ti, tal como todos os planos na instância de produção. Podes alterar isto por tarefa, e defini-lo exige a permissão de aprovação de planos.

Competências: ensinar-lhe as tuas convenções

A secção Competências no mesmo separador é onde registas as convenções da casa que o agente deve seguir: como dás nomes às coisas, como escreves vistas, como testas.

Carrega um ficheiro Markdown, ou um .zip de uma pasta de competência com um SKILL.md lá dentro. Escolhes que competências uma tarefa usa quando a crias, e uma competência pode ser marcada como sempre ativa para que todas as tarefas a recebam. As competências ficam no bucket de armazenamento do teu próprio projeto e são instaladas no contentor para as tarefas que as usam.

Esta é a forma mais barata de melhorar os resultados. Um agente que conhece a estrutura dos teus módulos e a tua convenção de testes produz planos que tens de corrigir menos vezes.

Próximos passos

Para saberes o que é uma tarefa de agente e as regras à volta da produção, consulta O que são as tarefas de agente. Para criares e reveres a tua primeira, consulta Executar uma tarefa e rever o resultado.

Se ficares bloqueado, abre um ticket de suporte a partir da página Tickets ou do widget de chat.