Documentação

Capacidade e slots de agentes

As vagas de agente definem quanto trabalho pode ser executado simultaneamente — não a velocidade de conclusão de uma única tarefa.

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 equívoco mais comum que todos cometem no início

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 necessário para compilar e executar os testes. Adquirir uma segunda vaga não reduz esse tempo pela metade. Ela permite que uma segunda tarefa seja executada junto com a primeira.

Se uma tarefa estiver lenta, verifique o conjunto de testes e o escopo da alteração. Se a 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 ao mesmo tempo — desde que o trabalho seja realmente independente. Um plano cujas fases dependem umas das outras será processado em série, independentemente do número de vagas livres, pois a terceira etapa não pode começar antes que a segunda esteja pronta.

2 slots de agente

Limitação de taxa para o API público

Exportar faturas como CSV

Um terceiro slot executaria mais uma tarefa ao mesmo tempo. Isso não faria essas duas terminarem mais rápido.

Fila · PENDING

  1. P0Checkout falha para cartões salvosPróximo
  2. P1Filtros de busca
  3. P2Atualização semanal de dependências
  4. P3Remover flags de recurso obsoletos
Com dois slots, duas tarefas são executadas. O restante aguarda em PENDING, com prioridade mais alta primeiro, e o próximo slot livre pega a tarefa do topo da fila.

Prioridade

As tarefas possuem uma prioridade definida de P0 (maior) até P3. Quando houver mais tarefas em espera do que vagas disponíveis, a prioridade decide quem será atendida primeiro.

A prioridade organiza a fila. Ela não aumenta a capacidade — se tudo estiver P0, nada será processado.

O custo de uma vaga

As vagas constituem o principal eixo do modelo de precificação:

  • Gratuito — uma vaga de baixa prioridade, um projeto com 1 GB de armazenamento, o proprietário como único membro, limite de horas de agente por dia e por mês, além de um limite para a duração máxima de uma única tarefa.
  • Profissional — uma vaga padrão incluída; 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 oo trabalho; os tokens consumidos pelo trabalho constituem uma categoria à parte.

Dimensionando sua capacidade

Comece com uma vaga e observe a fila durante uma semana.

Adicione vagas quando as tarefas ficarem constantemente paradas em PENDING enquanto você aguarda. Não adicione vagas apenas 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 a permissão.

O plano Gratuito oferece uma permissão diária de 2 horas de agente, além da permissão mensal. O dia refere-se ao dia calendário UTC, e Mission Control exibe o tempo de agente utilizado hoje em relação a esse limite em Cota diária.