ComandeskHelp Inicio

Arranque Desde Cero

Objetivo

Poner OPS en marcha con un orden seguro. Esta guia sirve para alguien que entra al sistema y necesita saber que mirar primero antes de crear tareas, activar automatizaciones o pedir ejecucion IA.

La meta no es tocar todos los paneles. La meta es confirmar que el entorno esta preparado para trabajar sin generar tareas huerfanas, automatizaciones duplicadas o ejecuciones con credenciales incorrectas.

Antes de empezar

Necesitas tener:

  • usuario con acceso al workspace correcto;
  • rol suficiente para crear o editar trabajo;
  • una idea clara del proyecto o area que vas a gestionar;
  • si vas a usar IA, al menos una credencial/runtime previsto;
  • si vas a cerrar trabajo, criterio de verificacion y tiempo estimado o real.

Si solo vas a revisar, puedes entrar con permisos mas limitados. Si vas a activar dispatch o recurrentes, necesitas entender primero credenciales y runtimes.

Paso 1: confirmar workspace activo

Mira el selector o contexto de workspace.

Por que importa:

  • El workspace define que proyectos, credenciales, usuarios y tareas ves.
  • Una tarea creada en el workspace equivocado queda fuera de la trazabilidad correcta.
  • En un futuro con mas usuarios, este sera el primer limite de seguridad.

Como comprobarlo:

  • El nombre del workspace coincide con el cliente, producto o entorno esperado.
  • Los proyectos que ves tienen sentido para ese workspace.
  • Las credenciales visibles corresponden a ese entorno.

Si no estas seguro, no crees tareas todavia. Cambia al workspace correcto o revisa Gestion -> Workspaces.

Paso 2: revisar cuenta y rol

Ve a Cuenta -> Mi cuenta.

Por que importa:

  • El rol determina si puedes operar, administrar, crear credenciales o ejecutar automatizaciones.
  • Si algo no aparece en la UI, puede ser un problema de permisos y no un bug.
  • Para pruebas con otras personas, el rol debe estar ajustado antes de pedir feedback.

Comprobaciones:

  • El usuario es el esperado.
  • El rol permite lo que necesitas hacer.
  • Si hay preferencias de idioma, tema o asistente, estan en un estado comodo para trabajar.

Paso 3: revisar proyectos existentes

Ve a Producto -> Proyectos/Docs.

Por que importa:

  • El proyecto es donde se acumulan tareas, horas y contexto.
  • Sin proyecto, luego no puedes saber cuanto tiempo consumio una iniciativa.
  • Para trabajar de forma ordenada, cada tarea importante debe apuntar a un proyecto.

Comprobaciones:

  • Hay al menos un proyecto activo.
  • El proyecto tiene nombre claro.
  • Si el proyecto ya existe, no crees otro duplicado.
  • Si el proyecto esta obsoleto, conviene desactivarlo en vez de borrar historia.

Paso 4: revisar credenciales antes de usar IA

Ve a Automatizacion -> Credenciales.

Por que importa:

  • Una tarea IA puede estar perfectamente descrita y aun asi fallar si la credencial no existe o no aplica.
  • Cambiar de proveedor para "salir del paso" rompe predictibilidad.
  • El runtime debe ejecutar con el proveedor pactado, no con fallback silencioso.

Comprobaciones:

  • La credencial necesaria existe.
  • Esta activa.
  • Su uso corresponde al objetivo: agente, proveedor, despliegue o servidor.
  • No hay secretos copiados en comentarios, tareas o documentacion.

Si hay dudas, no actives dispatch todavia. Primero ejecuta Runtime check.

Paso 5: revisar perfiles/subagentes y skills

Ve a Automatizacion -> Subagentes y Automatizacion -> Skills.

Por que importa:

  • Un perfil define el rol operativo, no solo el modelo.
  • Un skill define como debe trabajar el agente en una tarea concreta.
  • Con muchos perfiles y skills, la lista debe usarse con criterio para no crear ruido.

Comprobaciones:

  • El perfil que vas a usar esta activo.
  • La categoria y descripcion encajan con la tarea.
  • Los skills requeridos no se solapan de forma confusa.
  • Si un perfil o skill fue importado, esta auditado o al menos marcado como pendiente de revision.

Paso 6: crear o revisar el plan

Antes de llenar el sistema de tareas, revisa si hay plan.

Por que importa:

  • El plan convierte una intencion grande en fases y criterios.
  • Sin plan, es facil crear tareas inconexas.
  • El plan ayuda a decidir que se bloquea, que se ejecuta y que pasa a review.

Un plan minimo debe decir:

  • objetivo;
  • alcance;
  • fases;
  • riesgos;
  • entregables;
  • criterios de aceptacion;
  • decisiones pendientes.

Paso 7: crear tareas con criterio

Una tarea buena tiene:

  • titulo accionable;
  • proyecto;
  • estado inicial correcto;
  • responsable o perfil;
  • instrucciones suficientes;
  • criterio de terminado;
  • si aplica, tiempo registrado al cerrarse.

Por que importa:

  • Dispatch solo puede ejecutar bien lo que esta bien definido.
  • Una tarea sin criterio genera conversaciones largas y reintentos.
  • Una tarea cerrada sin tiempo distorsiona el resumen de proyecto.

Paso 8: comprobar dispatch y runtime

Antes de poner tareas en queued, ejecuta Runtime check.

Por que importa:

  • Dispatch debe estar activo solo cuando quieres procesar cola.
  • Un worker no disponible puede dejar tareas en dispatching.
  • El runtime y la credencial deben coincidir con el modelo o proveedor de la tarea.

Senales correctas:

  • No hay blockers inesperados.
  • El runtime esperado aparece disponible.
  • Las tareas IA tienen perfil/modelo compatible.
  • Las tareas sensibles tienen bloqueo o revision humana.

Paso 9: operar el dia

Usa cola, Kanban o asistente segun el tipo de trabajo.

Orden recomendado diario:

  1. Revisar waiting y bloqueadas.
  2. Revisar review.
  3. Revisar tareas recurrentes lanzadas.
  4. Ejecutar o mover tareas next.
  5. Registrar tiempo al cerrar.
  6. Actualizar documentacion si el sistema cambio.

Checklist final de arranque

Antes de decir "ya puedo trabajar", confirma:

  • workspace correcto;
  • usuario y rol correctos;
  • proyecto activo;
  • credenciales necesarias;
  • runtime check sin sorpresas;
  • perfiles y skills identificados;
  • plan o proxima fase clara;
  • tareas con criterio de terminado;
  • dispatch en el estado esperado.

Errores comunes

  • Crear tareas antes de elegir proyecto.
  • Activar dispatch sin comprobar runtime.
  • Usar un modelo distinto al pactado porque "parece disponible".
  • Crear recurrentes antes de probar una ejecucion manual.
  • Cerrar tareas IA sin revisar evidencia.
  • No registrar tiempo porque "era una tarea pequena".

Resultado esperado

Al terminar esta guia deberias poder explicar:

  • que workspace estas usando;
  • que proyecto estas gestionando;
  • que trabajo toca ahora;
  • que puede ejecutar IA y que no;
  • que queda pendiente de decision humana.