Wiederholen der Arbeit mit Routinen

Erstellen, verwalten und führen Sie Routinen in Cartographer aus, um wiederverwendbare Aufgabenworkflows zu speichern und mit einem einzigen Klick auszuführen.

Routinen sind wiederverwendbare Workflows, die Sie mit einem einzigen Klick ausführen können. Sie erfassen Muster der Arbeit, die Sie wiederholt ausführen, sodass Sie gängige Aufgaben automatisieren können, ohne sie jedes Mal neu zu erstellen. Sie befinden sich im Abschnitt Routinen der Seitenleiste neben dem Eintrag Geplante Routinen für diejenigen, die Sie geplant haben.

Cartographer bietet eine Reihe vordefinierter Routinen, zusätzlich zu denen, die Sie selbst erstellen.

Was ist eine Routine?

Eine Routine ist eine Fähigkeit, die als durch Benutzer aufrufbar markiert wurde – dieselbe Verpackung, dieselbe Veröffentlichung, eine zusätzliche Eigenschaft. Gut gestaltete Routinen haben in der Regel Folgendes:

• Eine eindeutige Triggerbeschreibung , die erläutert, wann sie verwendet werden sollen
• Eingaben (Parameter), die bei jeder Ausführung variieren
• Eine konsistente Ausgabe (Dokument, Bericht, Aktualisierung usw.)

Jede Routine ist eine Fähigkeit; Nicht jede Fähigkeit ist eine Routine – der Unterschied besteht in dieser zusätzlichen Eigenschaft. Deshalb enthält die Seitenleiste eine Liste mit Routinen für die aufrufbaren, während „Add-ons und Integrationen → Fähigkeiten“ alles auflistet, worauf der Agent zurückgreifen kann, egal ob aufrufbar oder nicht. Siehe Fähigkeitsreferenz.

Stellen Sie sich Routinen als Ihre persönliche Automatisierungsbibliothek vor – Workflows, die Sie einmal entwerfen und bei Bedarf ausführen.

Der richtige Zeitpunkt für eine Routine

Erstellen Sie eine Routine, wenn Sie sich selbst finden:

• Ich frage den Cartographer für die gleiche Art von Aufgabe wöchentlich (z.B. "Bereite mein Montagmorgen-Briefing vor")
• Nach einem konsistenten Prozess mit unterschiedlichen Daten (z. B. „Statusbericht aus diesem Jira-Projekt generieren“)
• Freigeben eines Workflows für Teammitglieder , die die gleiche Aufgabe ausführen müssen
• Sie möchten die Automatisierung so planen, dass sie zu bestimmten Zeiten ausgeführt wird

Erstellen einer Routine

Wählen Sie Neue Routine im Abschnitt Routinen der Seitenleiste und wählen Sie eine von vier Methoden:

Method	Was es tut
Aus Prompt erstellen	Beschreiben Sie eine Aufgabe und lassen Sie den Agent die Routine erstellen.
Aus Fähigkeit erstellen	Mit einer vorhandenen Fähigkeitsvorlage beginnen
Aus Aufzeichnung erstellen	Einen aufgezeichneten Workflow in eine Routine verwandeln
Einen neuen Workflow aufzeichnen	Ihren Bildschirm aufzeichnen, um einen neuen Workflow zu erfassen

Das Aufzeichnen eines Workflows ist auch unter Aufzeichnungen in den Einstellungen verfügbar – siehe Aufzeichnungseinstellungen und Aufzeichnen Ihrer Aufgaben.

Unterm Strich ist eine Routine eine SKILL.md -Datei – für Benutzer, die mit Markdown und der Dateisystemkonfiguration vertraut sind, ist das direkte Bearbeiten eine weitere Möglichkeit, eine Routine zu erstellen. Eine Beispielstruktur:

---
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

Ausführen einer Routine

• Wählen Sie eine Routine aus der Liste Routinen in der Seitenleiste aus. Dadurch wird das Chatfeld automatisch mit dem Befehl / der Routine ausgefüllt – zur Ausführung senden.
• Geben Sie / in das Chatfeld ein, um ein Menü mit verfügbaren Routinen und Befehlen zu öffnen, und wählen Sie einen aus, um ihn auf die gleiche Weise automatisch auszufüllen.
• Verweisen Sie anhand des Namens in einer Konversation auf die Routine, z. B.: Run the Weekly Sales Report for last week using the file in ~/Documents/Sales/. Cartographer erkennt den Routinenamen und führt ihn mit Ihren angegebenen Parametern aus.

Verwalten von Routinen

Öffnen Sie das Optionsmenü neben einer Routine in der Liste Routinen für diese Aktionen:

Aktion	Was es tut
Favorite	Heften Sie die Routine an, damit sie leichter zu finden ist
Datei anzeigen	Sehen Sie sich an, was die Routine tut und wie sie verwendet wird
Zeitplan	Einrichten einer wiederkehrenden oder einmaligen Ausführung – siehe Planen einer Routine
Umbenennen	Ändern Sie den Anzeigenamen der Routine
Zu Projekt verschieben	Verschieben der Routine in ein anderes Projekt
Löschen	Entfernen Sie die Routine

Um eine Routine zu bearbeiten, bearbeiten Sie die zugehörige SKILL.md -Datei direkt – siehe Erweitert: Routinespeicher.

Planen einer Routine

Wählen Sie Zeitplan neben einer Routine oder Routine planen von der Liste Routinen aus und konfigurieren Sie:

Feld	Beschreibung
Routine	Welche Routine ausgeführt werden soll
Routine planen	Datum und Uhrzeit der Ausführung
Wiederholung	Wie oft sie wiederholt wird – Standardmäßig auf Keine (einmalig)
Mode	Vordergrund (verwendet Apps, Maus und Tastatur) oder Hintergrund
Modell	Welches Modell die geplante Routine ausführt

Verwalten geplanter Routinen

Anzeigen und Verwalten aller geplanten Routinen unter Geplante Routinen in der Seitenleiste: Sehen Sie sich bevorstehende Ausführungen, den Status und den Verlauf der letzten Ausführung an und aktivieren, deaktivieren, bearbeiten oder löschen Sie einzelne Zeitpläne.

Geplante Routinen werden mit Ihren gespeicherten Verbindungen und Berechtigungen ausgeführt. Wenn die Authentifizierung abläuft, kann die Routine fehlschlagen, bis Sie die Verbindung erneut herstellen.

Freigeben einer Routine

Da eine Routine eine Fähigkeit ist, folgt das Freigeben einer Routine mit einem Teammitglieder oder der Veröffentlichung im Allgemeinen dem gleichen Veröffentlichungs-, Überprüfungs- und Installationsablauf wie jede andere Fähigkeit – siehe Freigeben von Fähigkeiten mit Ihrem Team.

Routine Best Practices

Design für Klarheit

• Beschreibend.: „Wöchentlicher Verkaufsbericht“ und nicht „Bericht 1“
• Klare Trigger schreiben: Erklären Sie, wann jemand diese Routine verwenden soll
• Dokumenteingaben: Erklären Sie, wozu jeder Parameter dient und welches Format erwartet wird
• Ausgaben angeben: Beschreiben Sie, was der Benutzer erhält

Behandeln Sie die Variabilität

• Eingabeparameter für alles verwenden , was sich ändert (Daten, Dateipfade, Namen)
• Geben Sie nach Möglichkeit sinnvolle Standardeinstellungen an
• Validieren Sie Eingaben in den Routineschritten (z. B. „Überprüfen, ob eine Datei vorhanden ist“)
• Behandeln Sie fehlende Eingaben ordnungsgemäß mit einem Fallback-Verhalten

Testen Sie gründlich

• Führen Sie zuerst den geführten Modus aus , um unerwartete Schritte zu erkennen
• Testen Sie mit Randfällen (leere Dateien, zukünftige Datumsangaben, Sonderzeichen)
• Überprüfen Sie, ob die Ausgaben den Erwartungen entsprechen, bevor Sie sie freigeben
• Testen Sie auf verschiedenen Maschinen , wenn Sie sie mit einem Team teilen

Versionskontrolle

• Duplizieren vor größeren Änderungen zum Beibehalten von Arbeitsversionen
• Dokumentieren Sie Änderungen in der Routinebeschreibung oder einem Changelog
• Verwenden Sie die semantische Versionierung in Skill.md (1.0.0, 1.1.0, 2.0.0) – Versionen werden immer nur rückwärts

Sicherheitsüberlegungen

• Hardcodieren Sie keine Anmeldeinformationen in Routineschritten – verwenden Sie Verbindungen
• Seien Sie vorsichtig bei Dateipfaden – verwenden Sie relative Pfade oder Eingabeparameter
• Überprüfen Sie Berechtigungen vor dem Freigeben – stellen Sie sicher, dass die Empfänger Zugriff auf die erforderlichen Systeme haben
• Bereinigen Sie Eingaben , die in Shell-Befehle oder URLs gehen

Erweitert: Routinespeicher

Routinen werden als SKILL.md -Dateien im Ordner LocalSkills/ gespeichert:

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

Weitere Informationen dazu, wo sich dieser Ordner befindet, finden Sie unter Speicherorte der Einstellungsdatei . Sie können Ihre Routinen sichern, indem Sie sie kopieren oder sie über einen Cloud-Speicher zwischen Maschinen synchronisieren – achten Sie auf absolute Pfade in Routinen, wenn Sie dies tun, da sie möglicherweise nicht auf einer anderen Maschine funktionieren.

Nächste Schritte

• Fähigkeitsreferenz – Wie sich eine Routine auf eine Fähigkeit bezieht
• Freigeben von Fähigkeiten mit Ihrem Team – Veröffentlichen, Installieren und Überprüfen von Fähigkeiten und Routinen
• Aufzeichnen Ihrer Aufgaben – Zeichnen Sie einen Workflow auf, um ihn in eine Routine oder eine Wissensfähigkeit umzuwandeln