Repetir trabajo con rutinas

Crea, gestiona y ejecuta rutinas en Cartographer para guardar flujos de trabajo de tareas reutilizables y ejecutarlos con un solo clic.

Las rutinas son flujos de trabajo reutilizables que puedes ejecutar con un solo clic. Capturan patrones de trabajo que realizas repetidamente, lo que te permite automatizar tareas comunes sin tener que reconstruirlas cada vez. Se encuentran en la sección Rutinas de la barra lateral, junto con una entrada de Rutinas programadas para las que has programado.

Cartographer viene con un conjunto de rutinas predefinidas listas para usar, junto con cualquiera que crees tú mismo.

¿Qué es una rutina?

Una rutina es una habilidad que se ha marcado como invocable por el usuario: mismo empaquetado, misma publicación, una propiedad adicional. Las rutinas bien diseñadas suelen tener:

• Una descripción clara del desencadenador que explique cuándo usarlos
• Entradas (parámetros) que varían en cada ejecución
• Una salida coherente (documento, informe, actualización, etc.)

Cada rutina es una habilidad; no todas las habilidades son una rutina: la diferencia es que hay una propiedad adicional. Esta es la razón por la que la barra lateral tiene una lista de Rutinas para las invocables, mientras que Complementos e integraciones → Habilidades enumera todo lo que el agente puede utilizar, invocable o no. Consulta Referencia de habilidades.

Piensa en las rutinas como tu biblioteca de automatización personal: flujos de trabajo que diseñas una vez y ejecutas cuando sea necesario.

Cuándo crear una rutina

Crea una rutina cuando te encuentres:

• Solicitar al Cartographer el mismo tipo de tarea semanalmente (p. ej., "Preparar mi resumen del lunes por la mañana")
• Seguir un proceso coherente con datos variables (p. ej., "Generar un informe de estado de este proyecto de Jira")
• Compartir un flujo de trabajo con compañeros de equipo que necesitan realizar la misma tarea
• Querer programar la automatización para que se ejecute en momentos específicos

Crear una rutina

Selecciona Nueva rutina en la sección Rutinas de la barra lateral y elige uno de los cuatro métodos:

Método	Lo que hace
Crear a partir de solicitud	Describa una tarea y dejar que el agente cree la rutina
Crear a partir de habilidad	Comience desde una plantilla de habilidad existente
Crear a partir de grabación	Convertir un flujo de trabajo grabado en una rutina
Grabar un nuevo flujo de trabajo	Grabe su pantalla para capturar un nuevo flujo de trabajo

La grabación de un flujo de trabajo también está disponible desde Grabaciones en Configuración: consulta Configuración de grabaciones y Grabar tus tareas.

En el fondo, una rutina es un archivo SKILL.md: para los usuarios que se sienten cómodos con Markdown y la configuración del sistema de archivos, editarlo directamente es otra forma de dar forma a una rutina. Una estructura de ejemplo:

---
name: my-routine
friendly_name: Weekly Sales Report
version: 1.0.0
description: "Generates a weekly sales summary from spreadsheet data"
icon: FaChartBar
color: "3B82F6"
trigger: "When you need a summary of weekly sales performance"
inputs:
  - name: week_ending
    type: date
    description: "The last day of the week to report on"
  - name: data_file
    type: file
    description: "Path to the sales data spreadsheet"
output:
  type: file
  description: "PowerPoint presentation with sales charts"
---

## Steps

1. Read the sales data from {data_file}
2. Filter for the week ending {week_ending}
3. Calculate total sales, top products, and regional breakdown
4. Create a PowerPoint with:
   - Title slide: "Weekly Sales Report - {week_ending}"
   - Summary slide with key metrics
   - Chart slide showing product performance
   - Regional breakdown table
5. Save as "Sales_Report_{week_ending}.pptx" on the Desktop

Ejecutar una rutina

• Selecciona una rutina de la lista de rutinas en la barra lateral. Esto rellena automáticamente el cuadro de chat con el comando de la / rutina: enviarlo a ejecución.
• Escribe / en el cuadro de chat para abrir un menú de rutinas y comandos disponibles, y selecciona uno para autocompletarlo de la misma manera.
• Haz referencia a la rutina por su nombre en una conversación, por ejemplo: Run the Weekly Sales Report for last week using the file in ~/Documents/Sales/. Cartographer reconoce el nombre de la rutina y lo ejecuta con los parámetros especificados.

Gestionar rutinas

Abre el menú de opciones junto a una rutina en la lista de rutinas para estas acciones:

Acción	Lo que hace
Favorito	Anclar la rutina para que sea más fácil de encontrar
Ver archivo	Vea lo que hace la rutina y cómo utilizarla
Programación	Configura una ejecución recurrente o única: consulta Programar una rutina
Cambiar nombre	Cambiar el nombre para mostrar de la rutina
Mover al proyecto	Mover la rutina a un proyecto diferente
Eliminar	Eliminar la rutina

Para editar una rutina, edita su archivo SKILL.md asociado directamente — consulta Avanzado: almacenamiento de rutinas.

Programar una rutina

Selecciona Programar junto a una rutina o Programar rutina en la lista de rutinas y configura:

Campo	Descripción
Rutina	Qué rutina ejecutar
Programar rutina	Fecha y hora de la ejecución
Periodicidad	Frecuencia de repetición: el valor predeterminado es Ninguno (una vez)
Mode	Primer plano (utiliza aplicaciones, ratón y teclado) o Fondo
Modelo	Qué modelo ejecuta la rutina programada

Gestionar rutinas programadas

Ver y gestionar todas las rutinas programadas desde Rutinas programadas en la barra lateral: consulta las próximas ejecuciones, el estado de la última ejecución y el historial, y habilita, deshabilita, edita o elimina programaciones individuales.

Las rutinas programadas se ejecutan utilizando tus conexiones y permisos almacenados. Si la autenticación caduca, la rutina puede fallar hasta que te vuelvas a conectar.

Compartir una rutina

Dado que una rutina es una habilidad, compartirla con un compañero de equipo o publicarla de forma más amplia sigue el mismo flujo de publicación, revisión e instalación que cualquier otra habilidad. Consulta Compartir habilidades con tu equipo.

Mejores prácticas de rutina

Diseño para la claridad

• Nombre descriptivo: "Informe de ventas semanales" no "Informe 1"
• Escribir desencadenadores claros: explica cuándo alguien debe usar esta rutina
• Entradas de documentos: explica para qué sirve cada parámetro y el formato esperado
• Especificar salidas: describe lo que recibirá el usuario

Manejar la variabilidad

• Utilice parámetros de entrada para cualquier cosa que cambie (fechas, rutas de archivos, nombres)
• Proporcione valores predeterminados sensibles cuando sea posible
• Validar entradas en los pasos de la rutina (p. ej., "Comprueba que el archivo existe")
• Gestione las entradas que faltan con elegancia con un comportamiento alternativo

Prueba exhaustiva

• Ejecutar primero en modo guiado para detectar pasos inesperados
• Prueba con casos límite (archivos vacíos, fechas futuras, caracteres especiales)
• Verifique que las salidas coincidan con las expectativas antes de compartir
• Prueba en diferentes máquinas si se comparte con un equipo

Control de versión

• Duplicar antes de cambios importantes para preservar las versiones funcionales
• Documentar los cambios en la descripción de la rutina o un REGISTRO DE CAMBIOS
• Utilizar versiones semánticas en SKILL.md (1.0.0, 1.1.0, 2.0.0) — las versiones solo avanzan

Consideraciones de seguridad

• No codifiques las credenciales en los pasos de rutina: usa conexiones
• Tenga cuidado con las rutas de archivo : utilice rutas relativas o parámetros de entrada
• Revise los permisos antes de compartir: asegúrese de que los destinatarios tengan acceso a los sistemas necesarios
• Desinfecte las entradas que van en los comandos de shell o las URL

Avanzado: almacenamiento de rutinas

Las rutinas se almacenan como archivos SKILL.md en la carpeta LocalSkills/:

LocalSkills/
├── my-routine/
│   └── SKILL.md
└── another-routine/
    └── SKILL.md

Consulta Ubicaciones de archivos de configuración para saber dónde reside esta carpeta. Puedes hacer una copia de seguridad de tus rutinas copiándolas o sincronizarlas en todas las máquinas a través del almacenamiento en la nube. Ten cuidado con las rutas absolutas en las rutinas si lo haces, ya que pueden no funcionar en una máquina diferente.

Próximos pasos

• Referencia de habilidades : cómo se relaciona una rutina con una habilidad
• Compartir habilidades con tu equipo : publicar, instalar y revisar habilidades y rutinas
• Grabar tus tareas : graba un flujo de trabajo para convertirlo en una rutina o una habilidad de conocimiento