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 en ejecutarse. Contratar una segunda ranura no reduce ese tiempo a la mitad. Permite que una segunda tarea se ejecute junto con la primera.

Si una tarea es lenta, revisa tu 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 libere, la tarea pasa a IN_PROGRESS.

Con una sola ranura y cinco tareas, se ejecutarán una tras otra en orden. Con cinco ranuras y cinco tareas independientes, las cinco se ejecutarán 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 disponibles, ya que la tercera fase no puede iniciarse antes de que exista la segunda.

2 slots de agente

Limitación de velocidad para el API público

Exportar facturas como CSV

Un tercer slot ejecutaría una tarea más al mismo tiempo. Eso no haría que estas dos terminaran antes.

Cola · PENDIENTE

  1. P0El proceso de pago falla con tarjetas guardadasSiguiente
  2. P1Filtros de búsqueda
  3. P2Actualización semanal de dependencias
  4. P3Eliminar banderas de funcionalidad obsoletas
Con dos slots, se ejecutan dos tareas. El resto esperan en PENDIENTE, siguiendo prioridad descendente, y el siguiente slot libre toma la primera de la cola.

Prioridad

Las tareas tienen una prioridad desde P0 (la más alta) 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 la misma P0, nada se ejecutará.

Coste de una ranura

Las ranuras constituyen el eje principal del modelo de precios:

  • Gratis — una ranura de baja prioridad, un proyecto con 1 GB de almacenamiento, el propietario como único miembro, con límites de horas de agente diarias y mensuales, y un tope en la duración máxima de una tarea.
  • Profesional — incluye una ranura estándar; las ranuras adicionales se facturan por ranura y mes. Proyectos y miembros ilimitados.
  • Empresa — ranuras bajo contrato 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 ese trabajo son un concepto aparte.

Dimensionar tu capacidad

Empieza con una sola 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 algunas tareas 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 esa asignación.

El plan Gratis incluye una asignación diaria de 2 horas de agente además de la mensual. El día se refiere al día calendario UTC, y Mission Control muestra el tiempo de agente utilizado hoy en comparación con ese límite bajo Cuota diaria.