NeboAI
NeboAI
Zacznij

Przepływy pracy

Przepływ pracy to praca, którą pracownik wykonuje bez proszenia: poranne podsumowanie, odpowiedź na każdą nową wiadomość, cotygodniowy raport. Każdy przepływ pracy łączy wyzwalacz z czynnościami, które wykonuje pracownik. Przepływy pracy znajdują się w pliku agent.json pracownika, więc przenoszą się razem z rolą.

Pierwszy przepływ pracy

Dodaj mapę workflows do agent.json. Każdy klucz to nazwa przepływu pracy; każda wartość ma wyzwalacz i czynności.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Ten przepływ pracy uruchamia się o 08:00 w dni robocze, według czasu lokalnego bota. Pracownik wykonuje czynność ze swoją własną personą, umiejętnościami i połączeniami.

Pola przepływu pracy

PoleZnaczenie
triggerWymagane. Kiedy przepływ pracy się uruchamia. Zobacz Wyzwalacze.
descriptionDo czego służy przepływ pracy.
activitiesKroki. Zobacz Czynności.
connectionsKrawędzie {from, to, label}, które zamieniają czynności w graf. __trigger__ to początek, a __emit__ koniec.
emitZdarzenia, które ten przepływ pracy ogłasza po zakończeniu: lista lub jeden ciąg rozdzielany przecinkami. Zobacz Zdarzenia.
inputsWartości przekazywane do każdego uruchomienia.
budget{total_per_run, cost_estimate}. W uruchomieniu grafu total_per_run ogranicza tokeny wyjściowe; w pozostałych przypadkach obie wartości są szacunkami.
caseSprawia, że przepływ pracy jest jedną długotrwałą sprawą na osobę lub rzecz. Zobacz Sprawy.

Przepływ pracy z wyzwalaczem i bez czynności jest poprawny. Obserwacja bez czynności tylko przekazuje swoje zdarzenia innym przepływom pracy.

Jak przebiega uruchomienie

Bez connections czynności wykonują się po kolei, a pracownik wykonuje każdą z nich. Wynik każdej czynności jest przekazywany do następnej. Czynność bez danych wyjściowych kończy uruchomienie.

Z connections czynności tworzą graf. Gałęzie działają równolegle, a sześć typów czynności działa bez modelu: condition, loop, wait, http, command i decide. Użyj grafu, gdy kierowanie musi być dokładne.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

Co otrzymuje uruchomienie

Pracownik zawsze ma swoją personę i odpowiedzi właściciela na pytania z inputs. Uruchomienie otrzymuje też te wartości, zależnie od wyzwalacza.

Dane wejścioweObecne, gdy
_event_source, _event_payload, _event_originUruchomił się wyzwalacz zdarzenia. Dane o rozmiarze 8 KB lub większym są skracane do pól skalarnych, z zachowaniem nagłówków e-maili i odwołań do załączników.
_watch_payloadUruchomił się wyzwalacz obserwacji lub folderu. Jeden wiersz danych wyjściowych obserwatora albo {files} dla folderu.
inputsZawsze. Własne wartości inputs przepływu pracy.

Sprawy

Niektóre prace trwają wiele dni: potencjalny klient wymagający kontaktów, prośba czekająca na dokumenty. Dodaj case, a przepływ pracy będzie utrzymywać jedną otwartą sprawę na osobę lub rzecz, zamiast za każdym razem zaczynać od nowa.

PoleZnaczenie
keyWymagane. Rozdzielane przecinkami ścieżki z kropkami w danych wyzwalacza, które identyfikują podmiot, np. contactEmail,email,phone.
typeRodzaj sprawy, np. lead. Przepływy pracy z tym samym typem współdzielą sprawy. Domyślnie nazwa przepływu pracy.
default_waitJak długo czekać, gdy tura nie określa oczekiwania: 3d, 12h, 45m. Domyślnie trzy dni.

Każda tura sprawy musi kończyć się jednym obiektem JSON i niczym po nim. result to stan biznesowy; next mówi silnikowi, czy ma czekać (wait), czy zamknąć sprawę (close). Termin to RFC 3339 lub okres względny. Wszystko inne to nieprawidłowa tura.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Limity i odzyskiwanie

  • Każda czynność może zająć maksymalnie 50 tur modelu, chyba że params.maxIterations stanowi inaczej.
  • W grafie jedna czynność może uruchomić się maksymalnie 10 000 razy w jednym uruchomieniu.
  • Limit wydatków ustawiony przez właściciela dla pracownika zatrzymuje uruchomienie po jego osiągnięciu. token_budget czynności jest szacunkiem.
  • Uruchomienie przerwane przez restart jest oznaczane jako przerwane i wznawiane jeden raz.
  • Pracownik może zakończyć uruchomienie wcześniej za pomocą narzędzia exit.

Uruchamianie przepływów pracy i zarządzanie nimi

Właściciel może ręcznie uruchomić dowolny przepływ pracy. Pracownicy zarządzają przepływami pracy za pomocą run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled i innych narzędzi przepływów pracy wymienionych na stronie Pomocnicy i zespoły.