Routinen
Routinen führen Mate nach Zeitplan oder bei Datensatzänderungen aus, mit den Credits des Eigentümers, Limits, Laufstatus und Freigaben.
Eine Routine ist eine gespeicherte Anweisung plus ein Auslöser. Greift der Auslöser, öffnet Customermates eine neue Assistenten-Unterhaltung, sendet Ihre Anweisung und lässt Mate selbstständig arbeiten. Routinen gibt es nur in Customermates Cloud, weil sie gehostete KI-Credits aus dem Monatskontingent des Eigentümers verbrauchen.
Wer Routinen sieht, richtet sich nach der Zeile Routinen der jeweiligen Rolle unter Rollen: Lesen mit Alle zeigt jede Routine im Workspace, Zugewiesen nur die eigenen, und Keine blendet Routinen aus. Anlegen erfordert Erstellen, eigene Routinen bearbeiten Bearbeiten. Alle, die eine Routine sehen, sehen die Zusammenfassungen ihrer Läufe; das vollständige Transkript bleibt bei der Person, unter deren Identität der Lauf ausgeführt wurde.
Wie lege ich eine Routine oder Automatisierung an?
Öffnen Sie Routinen und klicken Sie auf Hinzufügen. Geben Sie Name und Anweisungen ein, wählen Sie einen Auslöser und klicken Sie auf Speichern. Die Routine wird Aktiv gespeichert, sofern Sie sie nicht vorher auf Pausiert stellen. Sie können auch Mate bitten, eine anzulegen; Mate speichert sie pausiert, außer Sie bitten darum, dass sie aktiv ist. Bestehende Routinen finden Sie, indem Sie unter Filter suchen oder filtern, und unter Darstellung wechseln Sie zwischen Tabelle und Board.
Woraus besteht eine Routine?
- Name: erforderlich, bis zu 120 Zeichen.
- Anweisungen: was Mate bei jedem Lauf erhält, bis zu 5.000 Zeichen. Schreiben Sie sie so, wie Sie im Chat fragen würden.
- Auslöser: Nach Zeitplan oder Wenn sich etwas ändert für ein oder mehrere Ereignisse, etwa einen aktualisierten Deal.
Wer eine Routine anlegt, wird ihr Eigentümer. Nur der Eigentümer kann Anweisungen oder Auslöser ändern, die Routine zwischen Aktiv und Pausiert umschalten oder Auslöser testen verwenden, denn jeder Lauf nutzt Identität, Zugriff und KI-Credits des Eigentümers. Andere sehen die Routine schreibgeschützt.
Mitglieder mit der Rolle Admin können jede Routine pausieren (Routine pausieren) oder löschen, die Routine einer anderen Person aber nicht bearbeiten, testen oder ausführen. Löschen erfordert auch bei der eigenen Routine Admin, verschiebt die Routine in den Papierkorb, wo sie bis zur Wiederherstellung nicht läuft, und wird abgelehnt, solange ein Lauf läuft (Warte, bis der aktive Lauf beendet ist, bevor du diese Routine löschst.). Erst das endgültige Löschen aus dem Papierkorb entfernt auch ihren Laufverlauf. Wird ein Eigentümer unter Mitglieder auf Inaktiv gesetzt, pausieren seine Routinen sofort, wartende oder laufende Läufe enden als Blockiert, und die Routinen bleiben pausiert und schreibgeschützt, bis ein Admin sie löscht oder der Eigentümer wieder aktiv ist und sie erneut einschaltet.
Wie viele Routinen enthält mein Tarif?
Jeder Nutzer hat ein eigenes Kontingent: Starter enthält 1 Routine pro Nutzer, Pro 5 und Business sowie Enterprise unbegrenzt. Eine Routine zu pausieren gibt keinen Platz frei; sie in den Papierkorb zu verschieben gibt ihren Platz sofort frei. Am Limit wird eine neue Routine mit einem Hinweis auf ein Upgrade unter Abrechnung abgelehnt, und eine Routine, die Sie aus dem Papierkorb wiederherstellen, bleibt dort mit dem Hinweis, dass ihr Eigentümer bereits alle Routinen seines Tarifs nutzt; verschieben Sie zuerst eine andere Routine dieses Eigentümers in den Papierkorb. Über REST und MCP führt das Ergebnis der Wiederherstellung sie unter blocked mit dem Grund routineLimitReached und dem limit des Tarifs. Das Limit wird nur beim Anlegen und Wiederherstellen geprüft, deshalb bleiben Routinen über dem Limit eines kleineren Tarifs nach einem Downgrade erhalten. Die Credits, aus denen die Läufe schöpfen, stehen unter Tarife und Credits.
Welche Limits gelten, etwa für Läufe pro Stunde und Credits pro Lauf?
| Limit | Wert | Am Limit |
|---|---|---|
| Läufe pro Routine und Stunde | 4 | Ein passendes Ereignis wird ohne Eintrag verworfen; ein fälliger geplanter Lauf oder ein Lauf über Auslöser testen wird als Übersprungen erfasst |
| Credits pro Lauf | 10 | Der Lauf stoppt und wird als Teilweise erfasst |
| Aufeinanderfolgende fehlgeschlagene Läufe | 3 | Die Routine pausiert sich selbst und zeigt den Grund; der Eigentümer schaltet sie wieder ein, sobald die Ursache behoben ist |
| Kürzestes Zeitplan-Intervall | 15 Minuten | Ein häufigerer Zeitplan wird beim Speichern abgelehnt |
| Laufverlauf | 90 Tage | Ältere Läufe werden entfernt |
| Ereignis-Debounce | Standard 300 Sekunden, 0 bis 86.400, nur über Mate, MCP oder die REST-API einstellbar | Weitere passende Ereignisse innerhalb des Fensters nach einem Laufstart werden ignoriert |
Übersprungene Läufe zählen nicht gegen die Stundenobergrenze.
Jeder Routinelauf beginnt mit den grundlegenden CRM-Werkzeugen und lädt weitere Werkzeuggruppen bei Bedarf. So belegen ungenutzte Werkzeugbeschreibungen keinen Modellkontext. Überschreitet der Kontext auch nach der Komprimierung das Anbieterbudget, endet der Lauf; im Verlauf steht der konkrete Grund zur Kontextgrenze.
Zeitpläne: Wie plane ich eine Routine für jeden Morgen oder jeden Montag?
Öffnen Sie in Routinen eine Routine oder klicken Sie auf Hinzufügen, und wählen Sie unter Wiederholung Alle 15 Minuten, Alle 30 Minuten, Stündlich, Täglich, Wöchentlich oder Monatlich, dazu wo nötig den Wochentag, den Tag im Monat (1 bis 28) oder die Uhrzeit in Fünf-Minuten-Schritten. Standard ist täglich um 09:00. Ab Stündlich steht der Zeitplan darunter ausgeschrieben, gefolgt von Zeiten werden in … angezeigt mit der Zeitzone, die aus dem Browser stammt, in dem die Routine erstellt wurde (UTC, wenn unbekannt).
Einen Zeitplan, der zu keinem Muster passt, etwa nur werktags, und eine andere Zeitzone können Sie nur über Mate, einen MCP-Client oder die REST-API festlegen; der Dialog zeigt dann Diese Routine nutzt einen eigenen Zeitplan mit Zu einem Muster wechseln. Der Planer prüft alle fünf Minuten, ein Lauf kann also einige Minuten später starten, und ein Lauf, der nach zwei Minuten noch wartet, wird erneut ausgelöst.
Wie funktionieren Ereignis-Auslöser, etwa um eine Routine zu starten, wenn sich ein Deal ändert?
Wählen Sie unter Ereignisse ein oder mehrere Ereignisse: jedes Datensatz- und Messaging-Ereignis, das ein Webhook abonnieren kann, außer Datensatz endgültig gelöscht, E-Mail gelöscht und Chat gelöscht. Änderungen in der App, in einem Mate-Chat, über die API oder über MCP lösen Routinen aus; Änderungen eines Routinenlaufs nie, Routinen können sich also weder verketten noch in einer Schleife laufen.
Zwei optionale Controls verhindern, dass eine Routine Credits für Fälle ausgibt, die Sie nicht interessieren:
- Geänderte Felder (nur Aktualisierungs-Ereignisse): Die Routine läuft nur, wenn sich eines dieser Felder tatsächlich geändert hat. Ohne gewähltes Aktualisierungs-Ereignis ist das Control ausgeblendet.
- Datensatzfilter: Nur passende Datensätze zählen. Erstellungen und Änderungen werden am gespeicherten Ergebnis geprüft, Löschungen am vollständigen Datensatz unmittelbar vor der Entfernung, einschließlich seiner Beziehungen.
Lassen Sie beide leer, um bei jedem passenden Ereignis zu laufen. Ein Ereignis startet nur für einen Datensatz oder eine Unterhaltung, die der Eigentümer sehen kann, einen Lauf; mit Lesezugriff Zugewiesen lösen die Datensätze anderer die Routine also nie aus. Ein Ereignis wird außerdem ohne Eintrag übersprungen, wenn bereits ein Lauf der Routine wartet oder läuft, innerhalb des Debounce-Fensters oder über der Stundenobergrenze. Beim Start des Laufs werden Zugriff des Eigentümers und Filter erneut geprüft.
Mate erfährt vor Ihren Anweisungen, was passiert ist: das Ereignis, die Art des Datensatzes und seine ID, bei einer Aktualisierung die geänderten Felder und bei einem Posteingangs-Ereignis den Thread. Den Datensatz kann Mate von dort aus lesen, die vorherigen Werte erhält es nicht.
Was bedeuten die Läufe und ihre Status?
Öffnen Sie eine Routine, um ihre Läufe zu sehen, die neuesten zuerst: auf einem breiten Bildschirm neben der Konfiguration, auf einem schmalen hinter dem Umschalter Details und Läufe. Ein Klick auf einen Lauf öffnet Details zum Lauf: Ausgeführt als mit dem Namen des Eigentümers, die verbrauchten Credits (genaue Anbieterkosten auf eine Nachkommastelle), der Auslöser (Datensatz, Geänderte Felder, Unterhaltung) und, wenn der Lauf vorzeitig gestoppt hat, der Grund. Nur die Person, unter deren Identität er lief, kann das vollständige Transkript öffnen und nach Ende des Laufs darunter antworten, um die Unterhaltung mit Mate fortzusetzen; das verbraucht ihre Credits.
| Status | Bedeutung |
|---|---|
| In Warteschlange | Wartet auf den Planer |
| Läuft | Mate arbeitet |
| Erfolgreich | Der Lauf hat seine Anweisung abgeschlossen |
| Teilweise | Vorzeitig gestoppt, etwa an der Obergrenze von 10 Credits oder weil eine Richtlinie eine Aktion abgelehnt hat |
| Fehlgeschlagen | Endete mit einem Fehler oder ohne verwertbares Ergebnis |
| Übersprungen | Wartete, ist aber nicht gestartet: Die Routine war pausiert, die Stundenobergrenze war erreicht, der Datensatz passte nicht mehr zu den Filtern oder zum Zugriff des Eigentümers, der Auslöser wurde geändert, der Lauf wurde gestoppt oder der Assistent war mit einem anderen Lauf beschäftigt |
| Blockiert | Mate konnte nicht starten, weil Customermates die KI-Arbeit pausiert hat, der Eigentümer keine Credits mehr hat oder inaktiv ist oder eine andere Startprüfung fehlschlug. Der Lauf enthält einen error-Grund wie platformPaused oder agentLimitReached. Workspace-Administratoren können eine Customermates-Pause nicht aufheben. Sie können eine einzelne Routine pausieren; dafür steht adminPaused. |
Ein Lauf, der an seiner Obergrenze von 10 Credits stoppt, nennt das in seiner Zusammenfassung und in Details zum Lauf; diese Obergrenze ist von den monatlichen Credits des Eigentümers getrennt. Der Lauf stoppt vor einer Modellrunde, wenn die bereits verbrauchten Credits plus das, was diese Runde höchstens kosten kann, reserviert wie unter Abrechnung einer Anfrage beschrieben, 10 überschreiten würden.
Auslöser testen startet sofort einen echten Lauf. Er steht dem Eigentümer einer aktiven geplanten Routine ohne ungespeicherte Änderungen zur Verfügung, verbraucht KI-Credits und kann Daten ändern. Manuelle Testläufe haben triggerKind: schedule, die Art der getesteten Routine. Der Test wird vor dem Einreihen abgelehnt, wenn KI-Arbeit pausiert ist, der Eigentümer inaktiv ist oder keine Credits mehr hat. Ereignis-Routinen brauchen ein echtes passendes Ereignis, deshalb ist er für sie deaktiviert.
Was eine Routine ohne Freigabe darf
Ein unbeaufsichtigter Lauf darf alles, was Mate in einem Chat ohne Freigabe tut: den Workspace lesen; Kontakte, Organisationen, Deals, Services, Aufgaben, Verknüpfungen und Wissensdatenbank-Seiten anlegen oder ändern; Entwürfe speichern und verwerfen; E-Mails und Chat-Nachrichten senden; den Posteingang triagieren; Felder, Widgets, Webhooks und Workspace-Einstellungen außer Listennamen ändern; Links zur Kanalverbindung erzeugen; Routinen anlegen, ändern, pausieren und ausführen sowie auf einem verbundenen Konto Kontaktanfragen senden und Sales-Navigator-Listen ändern.
Jede Aktion, die in einem Chat eine Freigabe verlangt, wird abgelehnt, weil niemand antworten kann: Datensätze, Wissensdatenbank-Seiten, Felder, Widgets, Webhooks oder Routinen löschen, Listen umbenennen, Mitglieder einladen, Rolle oder Status eines Mitglieds ändern, Webhook-Zustellungen erneut senden und Support-Anfragen senden. Der Lauf hält die Ablehnung fest; die vollständige Liste steht auf der Assistenten-Seite. Aktionen in der Oberfläche wie das Hervorheben stehen nicht zur Verfügung, weil kein Browser angebunden ist.
Kann der Eigentümer die Wissensdatenbank lesen und enthält sie Seiten, beginnt jeder Lauf mit einem kurzen Katalog ihrer Seiten; die Routine durchsucht und liest relevante Seiten und wendet ihre Fakten an, doch eine Anweisung auf einer Seite kann keine andere Arbeit starten und die Berechtigungen der Routine nicht erweitern. Halten Sie gemeinsame Fakten, Tonalität und Abläufe dort, statt sie in jeder Routine zu wiederholen. Seiten schreiben erfordert beim Eigentümer Erstellen oder Bearbeiten für die Wissensdatenbank.
Ein Lauf darf das öffentliche Web durchsuchen, höchstens 2 kostenpflichtige Suchen pro Lauf, wie unter Kann Mate im Web suchen? beschrieben. Ein Lauf kann im Web suchen oder Daten ändern, nie beides: Nach einer Suche mit Ergebnissen wird jeder Schreibvorgang abgelehnt, und nach einem gelungenen Schreibvorgang wird die Websuche entzogen. Wissensdatenbank und CRM-Daten bleiben lesbar. Suchen zählen zur Obergrenze von 10 Credits.
Wie verwaltet Mate Routinen?
In einem Chat kann Mate Routinen auflisten, den Laufverlauf lesen, Routinen anlegen, ändern und pausieren und sofort einen Lauf starten, ohne vorher zu fragen. Mate kann außerdem festlegen, was der Dialog nicht bietet: einen eigenen Zeitplan wie werktags um 09:00, die Zeitzone und das Ereignis-Debounce. Das Löschen einer Routine fragt nach Ihrer Freigabe und erfordert wie in der App die Rolle Admin.
Für Agents
Nutzen Sie manage_routines. Ein eigener Zeitplan ist ein fünfteiliger Cron-Ausdruck, etwa 0 9 * * 1-5. Laufstatus kommen als queued, running, succeeded, partial, failed, skipped und blocked zurück. Die Aktion pause erfordert die Rolle Admin, auch bei der eigenen Routine; ein Eigentümer ohne sie pausiert, indem er mit enabled: false aktualisiert. Ereignisnamen sind die Webhook-Ereignisnamen, ohne record.deletedPermanently, messaging.email.deleted und messaging.chat.deleted. Datensatzfilter stehen in recordTrigger.query.filters; eine Routine, die mehreren Listen folgt, nutzt stattdessen recordSources, bis zu 50 Quellen mit jeweils eigener query, eigenen changedFieldIds und events, und kann das nicht mit recordTrigger kombinieren. Die frühere Einstellung triggerFilters gibt es nicht mehr. Über REST liegen Routinen unter /api/v1/routines/: list, read, runs, create, update, pause, resume, run und delete. Jede Operation auf einer Routine nimmt deren id, und runs antwortet mit 404 für eine Routine, die nicht existiert oder zu einem anderen Workspace gehört.