Plánování

Otevřete Nastavení → Automatizace, kde naplánovanou práci vytvoříte, upravíte, pozastavíte, obnovíte nebo hned spustíte. V chatu použijte CronAdd pro opakovanou úlohu, ScheduleWakeup pro jednorázové pokračování a CronList nebo CronRemove pro správu úloh.

Naplánovaná práce běží s oprávněními svého vlastníka. Držte prompty i kontroly v tomto rozsahu. Kontrola v shellu, která běží na hostiteli, potřebuje úlohu vlastněnou adminem nebo úlohu instance; kontrola uvnitř spravovaného projektu běží v tomto projektu.

Zvolte osobní nebo instanční rozsah

CronAdd vyžaduje výslovný scope:

Administrátor není automaticky vlastníkem instance. Pro úlohu, která patří vám, použijte personal. Osobní úlohy obvykle hlásí výsledek v samostatné konverzaci pojmenované podle úlohy; opakovaná úloha vytvořená v přímém chatu na platformě může hlásit tam. Úloha ve sdílené místnosti své výsledky do místnosti neposílá. Cílový kanál, pětipolový cron výraz a kontrola v shellu na hostiteli vyžadují oprávnění administrátora: CronAdd je u osobní úlohy nabízí jen vlastníkovi instance, administrátor je může nastavit u své vlastní úlohy v Nastavení → Automatizace a kontrola v shellu u osobní úlohy běží jen dokud je její vlastník administrátorem, což se ověřuje před každým spuštěním. Kontrola ve spravovaném projektu běží uvnitř tohoto projektu a plány spravovaného projektu musí být osobní. Osobní úlohy jiných účtů jsou soukromé; administrátoři vidí úlohy instance a své vlastní osobní úlohy.

Vytvořte opakovanou úlohu

Použijte CronAdd s názvem, plánem, promptem a conversationSessionId z CronConversations. ID konverzace zařazuje úlohu do seznamu konverzací; neurčuje její oprávnění, kontext ani místo doručení. Webová stránka zařazení vyřídí za vás.

Nové úlohy čekají na nejbližší naplánovaný čas, místo aby se spustily hned po uložení. Hodnotou enabled: false vytvoříte úlohu pozastavenou. V Nastavení → Automatizace můžete stávající úlohu také pozastavit nebo znovu zapnout, aniž byste ji smazali.

Zvolte interval, denní nebo týdenní čas, případně pětipolový cron výraz:

every 15m
daily 07:30
weekly sun 20:00
0 9 * * 1-5

Intervaly používají minuty nebo hodiny. Každý osobní účet může ve výchozím nastavení mít až 20 úloh a tento limit platí i pro vlastníka instance. Každý účet kromě vlastníka instance má ve výchozím nastavení nastavitelný minimální interval 15 minut. CronAdd přijme instanční rozsah jen od vlastníka instance; v Nastavení → Automatizace může administrátor nastavit úloze Vlastník na Všichni, čímž z ní udělá úlohu instance. Pětipolové cron výrazy, kontroly v shellu na hostiteli a cílové kanály vyžadují oprávnění administrátora, proto je CronAdd u nové osobní úlohy nabízí jen vlastníkovi instance. Běžné osobní úlohy používají intervalový, denní nebo týdenní plán. Pětipolový výraz používá minutu, hodinu, den v měsíci, měsíc a den v týdnu, jako 0 9 * * 1-5 pro pracovní dny v 09:00. Provozovatel může limity pro jednotlivé účty změnit v nastavení pluginu cronjob.

Příklady

Pro osobní denní přehled zvolte v CronConversations vhodnou konverzaci a předejte její ID:

CronAdd({
  name: "morning-summary",
  scope: "personal",
  schedule: "daily 07:30",
  conversationSessionId: "<conversation-id>",
  prompt: "Summarize yesterday's completed work and today's calendar."
})

Pro jednu kontrolu po nasazení:

ScheduleWakeup({
  name: "verify-deploy",
  when: "in 5m",
  prompt: "Check whether the deployment finished successfully and report the outcome."
})

Nastavte časové pásmo a rozumějte zmeškaným spuštěním

Denní a týdenní plány, pětipolové cron plány, okna aktivních hodin i probuzení typu at HH:MM používají časové pásmo nastavené pro asistenta. Časové pásmo nastavte v Nastavení → Pluginy → runtime-context pomocí názvu IANA, například Europe/Prague. Nastavení platí pro celou instanci i pro datum a čas, které Elowen vidí. Pokud je prázdné, použije se časové pásmo serveru. Intervaly jako every 15m jsou doby trvání a na časovém pásmu nezávisí.

Po výpadku se denní nebo týdenní úloha spustí opožděně ještě v den, na který připadá, pokud služba ten den znovu běží. Týdenní úloha se za zcela zmeškaný den v týdnu nespustí. Pětipolová cron úloha dohoní jen poslední zmeškaný výskyt v nastaveném okně, ve výchozím nastavení 24 hodin; okno lze nastavit od jedné hodiny do sedmi dnů. Interval nahromaděná spuštění nedohání; spustí se jednou, až přijde jeho čas. Pokud změna času zopakuje určitý čas na hodinách, odpovídající cron slot se spustí jen jednou. Čas přeskočený jarní změnou se nespustí.

Omezte úlohu nebo zvolte, kam mají výsledky chodit

Volitelná pole pro opakované úlohy:

• hours: povolí spuštění v okně celých hodin, například 5-21. Fungují i okna přes půlnoc, například 22-5.
• model: zvolí model jako provider/model; jinak se použije výchozí model serveru.
• plain: true: vynechá ve výsledku hlavičku s názvem úlohy.
• notifyChannelId: odešle výsledky do kanálu nebo vlákna. U nové osobní úlohy ho může nastavit jen vlastník instance. Výslovné místo doručení má přednost před běžným doručením.

Spuštění, které sdílí obrázky, je doručí spolu s výsledkem. Pokud spuštění nemá jiný výstup, odešlou se jen obrázky.

Sestavovač plánu nabízí intervalový, denní, týdenní a pokročilý cron režim. Časy se zobrazují v nastaveném časovém pásmu plánovače.

Spusťte kontrolu před promptem

Opakovaná úloha může obsahovat příkaz check. Elowen ho spustí před promptem. Pokud selže nebo nic nevypíše, úloha se přeskočí bez tahu modelu. Pokud něco vypíše, jeho výstup se přiloží k promptu.

check: "new-emails --since-last-run"

Kontrola v shellu na hostiteli vyžaduje úlohu instance nebo dostatečně oprávněného vlastníka osobní úlohy. Výchozí časový limit je 60 sekund a je nastavitelný. Kontroly běží s oprávněními spuštění své úlohy, proto používejte jen příkazy, kterým důvěřujete, a držte výstup krátký.

Naplánujte jednorázové probuzení

Probuzení použijte, když chcete, aby Elowen něco zkontrolovala jednou. Příklady jsou in 30s, in 20m, in 2h nebo at 18:30. Prodleva v sekundách musí být nejméně pět sekund; prodleva v minutách nebo hodinách nejméně jedna minuta. Požadovaný čas na hodinách používá nastavené časové pásmo; čas až pět minut v minulosti se spustí krátce poté, starší čas znamená příští výskyt.

Probuzení se po spuštění samo odstraní a neúspěšný tah probuzení se neopakuje tak jako u opakované úlohy. Probuzení vytvořené ve Vaší vlastní konverzaci Elowen nebo v přímém chatu 1:1 na platformě naváže na tuto konverzaci a vrátí do ní výsledek. Probuzení vytvořené ve sdílené místnosti výsledek do místnosti neposílá; použije běžné doručení oznámení. Nepoužívejte opakovaná probuzení k průběžnému dotazování příkazu na pozadí ani delegovaného úkolu; ty dají vědět, až skončí.

Najděte, pozastavte nebo odeberte úlohu

CronList zobrazuje úlohy, ke kterým máte přístup, jejich poslední spuštění a výsledek. Čekající jednorázová probuzení se tam objevují až do spuštění. ID z CronList použijte s CronRemove k trvalému smazání úlohy. Opakovanou úlohu pozastavte v Nastavení → Automatizace, pokud ji možná budete chtít znovu. Stejná stránka umí zařadit okamžité spuštění opakované úlohy (Spustit teď) a na kartě Historie ukazuje minulá spuštění. Karta Kalendář zobrazuje nadcházející spuštění v týdenním pohledu s kartami dnů.

Pokud spuštění selže nebo jeho výsledek nelze doručit, vlastník úlohy dostane upozornění a podrobnosti najde na kartě Historie.

Další: Komunikační kanály