İlk iş akışı
agent.json dosyasına bir workflows eşlemesi ekleyin. Her anahtar bir iş akışına ad verir; her değerin bir tetikleyicisi ve etkinlikleri vardır.
{
"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." }
]
}
}
} Bu iş akışı, botun yerel saatiyle hafta içi her gün 08:00’de çalışır. Çalışan etkinliği kendi kişiliği, becerileri ve bağlantılarıyla yürütür.
İş akışı alanları
| Alan | Anlamı |
|---|---|
trigger | Zorunlu. İş akışının ne zaman çalıştığı. Bkz. Tetikleyiciler. |
description | İş akışının amacı. |
activities | Adımlar. Bkz. Etkinlikler. |
connections | Etkinlikleri bir grafiğe dönüştüren {from, to, label} kenarları. __trigger__ başlangıç, __emit__ ise bitiştir. |
emit | Bu iş akışının bittiğinde duyurduğu olaylar: bir liste veya virgülle ayrılmış tek bir dize. Bkz. Olaylar. |
inputs | Her çalıştırmaya geçirilen değerler. |
budget | {total_per_run, cost_estimate}. Grafik çalıştırmasında total_per_run çıktı belirteçlerini sınırlar; diğer durumlarda ikisi de tahmindir. |
case | İş akışını kişi veya şey başına uzun süreli tek bir vaka hâline getirir. Bkz. Vakalar. |
Tetikleyicisi olup etkinliği olmayan bir iş akışı geçerlidir. Etkinliği olmayan bir izleme, olaylarını yalnızca diğer iş akışlarına aktarır.
Bir çalıştırma nasıl yürür
connections olmadan etkinlikler sırayla çalışır ve her birini çalışan gerçekleştirir. Her etkinliğin sonucu bir sonrakine geçirilir. Çıktısı olmayan bir etkinlik çalıştırmayı sonlandırır.
connections ile etkinlikler bir grafik oluşturur. Dallar paralel çalışır ve altı etkinlik türü model olmadan çalışır: condition, loop, wait, http, command ve decide. Yönlendirmenin kesin olması gerektiğinde bir grafik kullanın.
{
"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"]
} Bir çalıştırma neler alır
Çalışanın her zaman kişiliği ve sahibin inputs sorularına verdiği yanıtlar vardır. Bir çalıştırma, tetikleyicisine bağlı olarak şu değerleri de alır.
| Girdi | Ne zaman bulunur |
|---|---|
_event_source, _event_payload, _event_origin | Bir olay tetikleyicisi tetiklendiğinde. 8 KB veya daha büyük yükler, e-posta üst bilgileri ve ek başvuruları korunarak skaler alanlarına kısaltılır. |
_watch_payload | Bir izleme veya klasör tetikleyicisi tetiklendiğinde. İzleyicinin çıktısından bir satır ya da klasör için {files}. |
inputs | Her zaman. İş akışının kendi inputs değerleri. |
Vakalar
Bazı işler günlere yayılır: takip gerektiren bir potansiyel müşteri, belge bekleyen bir talep. case ekleyin; iş akışı her seferinde baştan başlamak yerine kişi veya şey başına bir açık vaka tutar.
| Alan | Anlamı |
|---|---|
key | Zorunlu. Tetikleyici verisinde konuyu tanımlayan, virgülle ayrılmış noktalı yollar; örneğin contactEmail,email,phone. |
type | lead gibi vaka türü. Aynı türdeki iş akışları vakaları paylaşır. Varsayılan olarak iş akışının adıdır. |
default_wait | Bir tur bekleme süresi belirtmediğinde ne kadar bekleneceği: 3d, 12h, 45m. Varsayılan üç gündür. |
Bir vakanın her turu tek bir JSON nesnesiyle bitmeli ve ardından hiçbir şey gelmemelidir. result iş durumudur; next motora wait veya close yapmasını söyler. Son tarih RFC 3339 biçiminde ya da göreli bir süredir. Bunun dışındaki her şey geçersiz bir turdur.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Sınırlar ve kurtarma
params.maxIterationsaksini belirtmedikçe her etkinlik en fazla 50 model turu sürebilir.- Bir grafikte bir etkinlik, bir çalıştırmada en fazla 10.000 kez çalışabilir.
- Sahibin çalışan için belirlediği harcama sınırına ulaşıldığında çalıştırma durur. Bir etkinliğin
token_budgetdeğeri bir tahmindir. - Yeniden başlatma nedeniyle kesilen bir çalıştırma kesildi olarak işaretlenir ve bir kez sürdürülür.
- Çalışan,
exitaracıyla bir çalıştırmayı erken bitirebilir.
İş akışlarını çalıştırın ve yönetin
Sahip herhangi bir iş akışını elle çalıştırabilir. Çalışanlar iş akışlarını run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled ve Yardımcılar ve Ekipler sayfasında listelenen diğer iş akışı araçlarıyla yönetir.