Plánovanie

Otvorte Nastavenia → Automatizácia, kde naplánovanú prácu vytvoríte, upravíte, pozastavíte, obnovíte alebo hneď spustíte. V chate použite CronAdd na opakovanú úlohu, ScheduleWakeup na jednorazové pokračovanie a CronList alebo CronRemove na správu úloh.

Naplánovaná práca beží s oprávneniami svojho vlastníka. Držte prompty aj kontroly v tomto rozsahu. Kontrola v shelli, ktorá beží na hostiteľovi, potrebuje úlohu vlastnenú adminom alebo úlohu inštancie; kontrola vnútri spravovaného projektu beží v tomto projekte.

Zvoľte osobný alebo inštančný rozsah

CronAdd vyžaduje výslovný scope:

Administrátor nie je automaticky vlastníkom inštancie. Pre úlohu, ktorá patrí vám, použite personal. Osobné úlohy zvyčajne hlásia výsledok v samostatnej konverzácii pomenovanej podľa úlohy; opakovaná úloha vytvorená v priamom chate na platforme môže hlásiť tam. Úloha v zdieľanej miestnosti svoje výsledky do miestnosti neposiela. Cieľový kanál, päťpoľový cron výraz a kontrola v shelli na hostiteľovi vyžadujú oprávnenie administrátora: CronAdd ich pri osobnej úlohe ponúka iba vlastníkovi inštancie, administrátor ich môže nastaviť pri svojej vlastnej úlohe v Nastavenia → Automatizácia a kontrola v shelli pri osobnej úlohe beží iba dovtedy, kým je jej vlastník administrátorom, čo sa overuje pred každým spustením. Kontrola v spravovanom projekte beží vnútri tohto projektu a plány spravovaného projektu musia byť osobné. Osobné úlohy iných účtov sú súkromné; administrátori vidia úlohy inštancie a svoje vlastné osobné úlohy.

Vytvorte opakovanú úlohu

Použite CronAdd s názvom, plánom, promptom a conversationSessionId z CronConversations. ID konverzácie zaraďuje úlohu do zoznamu konverzácií; neurčuje jej oprávnenia, kontext ani miesto doručenia. Webová stránka zaradenie vybaví za vás.

Nové úlohy čakajú na najbližší naplánovaný čas, namiesto toho, aby sa spustili hneď po uložení. Hodnotou enabled: false vytvoríte úlohu pozastavenú. V Nastavenia → Automatizácia môžete existujúcu úlohu aj pozastaviť alebo znova zapnúť bez toho, aby ste ju vymazali.

Zvoľte interval, denný alebo týždenný čas, prípadne päťpoľový cron výraz:

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

Intervaly používajú minúty alebo hodiny. Každý osobný účet môže v predvolenom nastavení mať až 20 úloh a tento limit platí aj pre vlastníka inštancie. Každý účet okrem vlastníka inštancie má v predvolenom nastavení nastaviteľný minimálny interval 15 minút. CronAdd prijme inštančný rozsah iba od vlastníka inštancie; v Nastavenia → Automatizácia môže administrátor nastaviť úlohe Vlastník na Všetci, čím z nej urobí úlohu inštancie. Päťpoľové cron výrazy, kontroly v shelli na hostiteľovi a cieľové kanály vyžadujú oprávnenie administrátora, preto ich CronAdd pri novej osobnej úlohe ponúka iba vlastníkovi inštancie. Bežné osobné úlohy používajú intervalový, denný alebo týždenný plán. Päťpoľový výraz používa minútu, hodinu, deň v mesiaci, mesiac a deň v týždni, ako 0 9 * * 1-5 pre pracovné dni o 09:00. Prevádzkovateľ môže limity pre jednotlivé účty zmeniť v nastaveniach pluginu cronjob.

Príklady

Pre osobný denný prehľad zvoľte v CronConversations vhodnú konverzáciu a odovzdajte 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."
})

Pre jednu kontrolu po nasadení:

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

Nastavte časové pásmo a rozumejte zmeškaným spusteniam

Denné a týždenné plány, päťpoľové cron plány, okná aktívnych hodín aj prebudenia typu at HH:MM používajú časové pásmo nastavené pre asistenta. Časové pásmo nastavte v Nastavenia → Pluginy → runtime-context pomocou názvu IANA, napríklad Europe/Prague. Nastavenie platí pre celú inštanciu aj pre dátum a čas, ktoré Elowen vidí. Ak je prázdne, použije sa časové pásmo servera. Intervaly ako every 15m sú trvania a na časovom pásme nezávisia.

Po výpadku sa denná alebo týždenná úloha spustí oneskorene ešte v deň, na ktorý pripadá, ak služba v ten deň znova beží. Týždenná úloha sa za úplne zmeškaný deň v týždni nespustí. Päťpoľová cron úloha dobehne iba posledný zmeškaný výskyt v nastavenom okne, v predvolenom nastavení 24 hodín; okno možno nastaviť od jednej hodiny do siedmich dní. Interval nahromadené spustenia nedobehne; spustí sa raz, keď príde jeho čas. Ak zmena času zopakuje určitý čas na hodinách, zodpovedajúci cron slot sa spustí iba raz. Čas preskočený jarnou zmenou sa nespustí.

Obmedzte úlohu alebo zvoľte, kam majú výsledky chodiť

Voliteľné polia pre opakované úlohy:

• hours: povolí spustenie v okne celých hodín, napríklad 5-21. Fungujú aj okná cez polnoc, napríklad 22-5.
• model: zvolí model ako provider/model; inak sa použije predvolený model servera.
• plain: true: vynechá vo výsledku hlavičku s názvom úlohy.
• notifyChannelId: odošle výsledky do kanála alebo vlákna. Pri novej osobnej úlohe ho môže nastaviť iba vlastník inštancie. Výslovné miesto doručenia má prednosť pred bežným doručením.

Spustenie, ktoré zdieľa obrázky, ich doručí spolu s výsledkom. Ak spustenie nemá iný výstup, odošlú sa iba obrázky.

Zostavovač plánu ponúka intervalový, denný, týždenný a pokročilý cron režim. Časy sa zobrazujú v nastavenom časovom pásme plánovača.

Spustite kontrolu pred promptom

Opakovaná úloha môže obsahovať príkaz check. Elowen ho spustí pred promptom. Ak zlyhá alebo nič nevypíše, úloha sa preskočí bez ťahu modelu. Ak niečo vypíše, jeho výstup sa priloží k promptu.

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

Kontrola v shelli na hostiteľovi vyžaduje úlohu inštancie alebo dostatočne oprávneného vlastníka osobnej úlohy. Predvolený časový limit je 60 sekúnd a je nastaviteľný. Kontroly bežia s oprávneniami spustenia svojej úlohy, preto používajte iba príkazy, ktorým dôverujete, a držte výstup krátky.

Naplánujte jednorazové prebudenie

Prebudenie použite, keď chcete, aby Elowen niečo skontrolovala raz. Príklady sú in 30s, in 20m, in 2h alebo at 18:30. Odklad v sekundách musí byť najmenej päť sekúnd; odklad v minútach alebo hodinách najmenej jedna minúta. Požadovaný čas na hodinách používa nastavené časové pásmo; čas až päť minút v minulosti sa spustí krátko potom, starší čas znamená najbližší výskyt.

Prebudenie sa po spustení samo odstráni a neúspešný ťah prebudenia sa neopakuje tak ako pri opakovanej úlohe. Prebudenie vytvorené vo Vašej vlastnej konverzácii Elowen alebo v priamom chate 1:1 na platforme nadviaže na túto konverzáciu a vráti do nej výsledok. Prebudenie vytvorené v zdieľanej miestnosti výsledok do miestnosti neposiela; použije bežné doručenie oznámení. Nepoužívajte opakované prebudenia na priebežné dopytovanie príkazu na pozadí ani delegovanej úlohy; tie dajú vedieť, keď skončia.

Nájdite, pozastavte alebo odoberte úlohu

CronList zobrazuje úlohy, ku ktorým máte prístup, ich posledné spustenie a výsledok. Čakajúce jednorazové prebudenia sa tam objavujú až do spustenia. ID z CronList použite s CronRemove na trvalé vymazanie úlohy. Opakovanú úlohu pozastavte v Nastavenia → Automatizácia, ak ju možno budete chcieť znova. Tá istá stránka dokáže zaradiť okamžité spustenie opakovanej úlohy (Spustiť teraz) a na karte História zobrazuje minulé spustenia. Karta Kalendár zobrazuje najbližšie spustenia v týždennom pohľade s kartami dní.

Ak spustenie zlyhá alebo jeho výsledok nemožno doručiť, vlastník úlohy dostane upozornenie a podrobnosti nájde na karte História.

Ďalej: Komunikačné kanály