NeboAI
NeboAI
Бастау

Жұмыс үдерістері

Жұмыс процесі — қызметкер сұратпай-ақ атқаратын жұмыс: таңғы қорытынды, әр жаңа хабарламаға жауап, апталық есеп. Әр жұмыс процесі триггерді қызметкер орындайтын әрекеттермен жұптайды. Жұмыс процестері қызметкердің agent.json файлында сақталады, сондықтан рөлмен бірге жүреді.

Алғашқы жұмыс процесі

agent.json ішіне workflows картасын қосыңыз. Әр кілт жұмыс процесін атайды; әр мәнде триггер мен әрекеттер болады.

{
  "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." }
      ]
    }
  }
}

Бұл жұмыс процесі жұмыс күндері сағат 08:00-де боттың жергілікті уақытымен іске қосылады. Қызметкер әрекетті өз персонасымен, дағдыларымен және қосылымдарымен орындайды.

Жұмыс процесінің өрістері

ӨрісМағынасы
triggerМіндетті. Жұмыс процесінің қашан іске қосылатыны. «Триггерлер» бөлімін қараңыз.
descriptionЖұмыс процесінің не үшін арналғаны.
activitiesҚадамдар. «Әрекеттер» бөлімін қараңыз.
connectionsӘрекеттерді графқа айналдыратын {from, to, label} қырлары. __trigger__ — басы, __emit__ — соңы.
emitБұл жұмыс процесі аяқталғанда хабарлайтын оқиғалар: тізім немесе үтірмен бөлінген бір жол. «Оқиғалар» бөлімін қараңыз.
inputsӘр іске қосуға берілетін мәндер.
budget{total_per_run, cost_estimate}. Граф түріндегі іске қосуда total_per_run шығыс токендерін шектейді; әйтпесе екеуі де болжам.
caseЖұмыс процесін әр адамға немесе нысанға арналған бір ұзақ мерзімді іске айналдырады. «Істер» бөлімін қараңыз.

Триггері бар, бірақ әрекеттері жоқ жұмыс процесі жарамды. Әрекеттері жоқ watch өз оқиғаларын басқа жұмыс процестеріне жеткізіп қана отырады.

Іске қосу қалай орындалады

connections болмаса, әрекеттер ретімен орындалады және әрқайсысын қызметкер атқарады. Әр әрекеттің нәтижесі келесісіне беріледі. Шығысы жоқ әрекет іске қосуды аяқтайды.

connections болса, әрекеттер граф құрайды. Тармақтар қатар орындалады, ал алты әрекет түрі модельсіз жұмыс істейді: condition, loop, wait, http, command және decide. Бағыттау дәл болуы керек кезде графты пайдаланыңыз.

{
  "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"]
}

Іске қосу не алады

Қызметкерде әрқашан өз персонасы және иесінің оның inputs сұрақтарына берген жауаптары болады. Іске қосу триггеріне байланысты мына мәндерді де алады.

КірісҚашан болады
_event_source, _event_payload, _event_originОқиға триггері іске қосылды. 8 KB немесе одан үлкен деректер скаляр өрістеріне дейін қысқартылады, электрондық пошта тақырыптары мен тіркеме сілтемелері сақталады.
_watch_payloadWatch немесе қалта триггері іске қосылды. Бақылаушы шығысының бір жолы немесе қалта үшін {files}.
inputsӘрқашан. Жұмыс процесінің өз inputs мәндері.

Істер

Кейбір жұмыс бірнеше күнге созылады: қайта хабарласуды қажет ететін әлеуетті клиент, құжаттарды күтіп тұрған сұрау. case қосыңыз, сонда жұмыс процесі әр жолы жаңадан бастаудың орнына әр адамға немесе нысанға бір ашық іс жүргізеді.

ӨрісМағынасы
keyМіндетті. Субъектіні анықтайтын, триггер деректеріне апаратын үтірмен бөлінген нүктелі жолдар, мысалы, contactEmail,email,phone.
typelead сияқты іс түрі. Түрі бірдей жұмыс процестері істерді ортақ пайдаланады. Әдепкі мәні — жұмыс процесінің атауы.
default_waitКезек күтуді көрсетпегенде қанша күту керегі: 3d, 12h, 45m. Әдепкі мәні — үш күн.

Істің әр кезегі бір JSON объектісімен аяқталуы керек және одан кейін ештеңе болмауы тиіс. result — бизнес күйі; next қозғалтқышқа wait немесе close деп нұсқайды. Мерзім RFC 3339 немесе салыстырмалы аралық түрінде беріледі. Басқа кез келген нәрсе — жарамсыз кезек.

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

Шектеулер және қалпына келтіру

  • params.maxIterations басқаша көрсетпесе, әр әрекет 50 модель кезегіне дейін пайдалана алады.
  • Графта бір әрекет бір іске қосуда ең көбі 10 000 рет орындала алады.
  • Иесінің қызметкерге қойған шығын шегі жеткенде іске қосуды тоқтатады. Әрекеттің token_budget мәні — болжам.
  • Қайта іске қосу салдарынан үзілген іске қосу үзілді деп белгіленеді және бір рет жалғастырылады.
  • Қызметкер іске қосуды exit құралымен ертерек аяқтай алады.

Жұмыс процестерін іске қосу және басқару

Иесі кез келген жұмыс процесін қолмен іске қоса алады. Қызметкерлер жұмыс процестерін run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled және Көмекшілер мен командалар бетінде көрсетілген басқа жұмыс процесі құралдарымен басқарады.