Documentación

Capacidad y ranuras de agentes

Las ranuras de agente definen cuánto trabajo se ejecuta simultáneamente, no la velocidad a la que finaliza una tarea concreta.

Una ranura de agente es la unidad de paralelismo. Una ranura ejecuta una tarea a la vez. El número de ranuras disponibles determina cuántas tareas pueden estar en curso al mismo tiempo.

Lo que todos malinterpretan al principio

Las ranuras no aceleran una tarea.

La duración de una tarea viene determinada por el tamaño del cambio y el tiempo que tardan tu proceso de compilación y tu suite de pruebas. Contratar una segunda ranura no reduce ese tiempo a la mitad. Permite que una segunda tarea se ejecute junto a la primera.

Si una tarea es lenta, revisa la suite de pruebas y el alcance del cambio. Si tu cola está larga, analiza las ranuras.

Cómo funcionan las colas de trabajo

La tarea que creas entra en PENDING y espera a que haya una ranura libre. Cuando esta se libera, la tarea pasa a IN_PROGRESS.

Con una ranura y cinco tareas, se ejecutan una tras otra en orden. Con cinco ranuras y cinco tareas independientes, las cinco se ejecutan a la vez, siempre que el trabajo sea realmente independiente. Un plan cuyas fases dependen unas de otras se ejecutará en serie independientemente del número de ranuras libres, ya que el paso tres no puede iniciarse antes de que exista el paso dos.

Prioridad

Las tareas tienen una prioridad desde P0 (máxima) hasta P3. Cuando hay más tareas en espera que ranuras disponibles, la prioridad decide quién empieza primero.

La prioridad ordena la cola. No añade capacidad: si todo tiene P0, nada se ejecuta.

Coste de una ranura

Las ranuras son el eje principal del modelo de precios:

  • Gratis — una ranura de baja prioridad, un proyecto, horas de agente mensuales limitadas, y un límite en el tiempo que puede durar una tarea concreta.
  • Profesional — incluye una ranura estándar; las ranuras adicionales se cobran por ranura y mes. Proyectos y miembros ilimitados.
  • Empresa — ranuras contratadas con un compromiso mínimo, además de procesamiento prioritario. En vista previa privada.

El uso de modelos se factura por separado de las ranuras: consulta Créditos de modelo. Una ranura te proporciona un lugar para ejecutar el trabajo; los tokens que consume dicho trabajo constituyen una categoría aparte.

Dimensionar tu capacidad

Empieza con una ranura y observa la cola durante una semana.

Añade ranuras cuando las tareas permanezcan constantemente en PENDING mientras esperas. No añadas ranuras porque las tareas individuales parezcan lentas; ese es un problema distinto que requiere otra solución.

Horas de agente

En los planes con asignación de horas de agente, el tiempo se cuenta mientras un agente trabaja activamente en una tarea, no mientras la tarea permanece en PENDING. El trabajo en cola es gratuito; el trabajo en ejecución es lo que consume la asignación.