Uma vaga de agente é a unidade de paralelismo. Uma vaga executa uma tarefa por vez. A quantidade de vagas disponíveis determina quantas tarefas podem estar em andamento ao mesmo tempo.
O primeiro equívoco que todos cometem
As vagas não tornam uma tarefa mais rápida.
A duração de uma tarefa é definida pelo tamanho da alteração e pelo tempo que seu processo de compilação e suite de testes levam. Adquirir uma segunda vaga não reduz esse tempo pela metade. Ela permite que uma segunda tarefa seja executada ao lado da primeira.
Se uma tarefa estiver lenta, verifique a suite de testes e o escopo da alteração. Se sua fila estiver longa, analise as vagas.
Como funcionam as filas de trabalho
Uma tarefa que você cria entra em PENDING e aguarda uma vaga livre. Quando uma vaga se libera,
a tarefa passa para IN_PROGRESS.
Com uma vaga e cinco tarefas, elas são executadas uma de cada vez, em ordem. Com cinco vagas e cinco tarefas independentes, todas as cinco rodam simultaneamente — desde que o trabalho seja realmente independente. Um plano cujas fases dependem umas das outras será executado em série, independentemente do número de vagas livres, pois a terceira etapa não pode começar antes que a segunda seja concluída.
Prioridade
As tarefas possuem uma prioridade que vai de P0 (maior) até P3. Quando houver mais tarefas em espera
do que vagas disponíveis, a prioridade decide quem será executada primeiro.
A prioridade organiza a fila. Ela não aumenta a capacidade — se tudo estiver P0, nada será executado.
Quanto custa uma vaga
As vagas são o principal eixo do modelo de precificação:
- Gratuito — uma vaga de baixa prioridade, um projeto, horas de agente limitadas por mês, e um limite para o tempo máximo de execução de uma única tarefa.
- Profissional — uma vaga padrão inclusa; vagas adicionais são cobradas mensalmente por vaga. Projetos e membros ilimitados.
- Empresarial — vagas contratadas com compromisso mínimo, além de processamento prioritário. Em visualização privada.
O uso de modelos é cobrado separadamente das vagas — veja Créditos de modelo. Uma vaga garante um espaço para executar rabalho; os tokens consumidos pelo trabalho constituem uma categoria à parte.
Dimensionando sua capacidade
Comece com uma vaga e observe a fila por uma semana.
Adicione vagas quando as tarefas ficarem constantemente paradas em PENDING enquanto você aguarda. Não
adicione vagas porque tarefas individuais parecem lentas — esse é um problema diferente que requer
uma solução distinta.
Horas de agente
Nos planos com permissão de horas de agente, o tempo é contabilizado enquanto um agente está ativamente
trabalhando em uma tarefa — não enquanto a tarefa permanece em PENDING. O trabalho em fila é gratuito;
o trabalho em execução é o que consome essa permissão.