Өрістер
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | Өріс | Әдепкі | Мағынасы |
|---|---|---|
id | міндетті | Жұмыс процесі ішінде бірегей. connections және деректер жолдарында пайдаланылады. |
type | custom | Қызметкер қадамы немесе condition, loop, wait, http, command, decide түрлерінің бірі. |
intent | жоқ | Қызметкер не нәрсеге қол жеткізуі керек. Қызметкер қадамына intent немесе steps қажет. |
steps | [] | Бір сөйлем жеткіліксіз болғандағы реттелген нұсқаулар. |
label | жоқ | Иесіне көрсетілетін атау. |
skills | [] | Пайдаланылатын дағдылар. Мұнда көрсетілген маркетплейс дағдылары қызметкермен бірге орнатылады. |
tools | [] | Орнатылған болса, қадам пайдалана алатын жалғыз құралдар. |
requires_tools | [] | Қадам орындалды деп есептелуі үшін сәтті орындалуы тиіс құралдар. |
cmds | [] | Қадам үшін аталған плагин командалары. |
mcps | [] | Қадам үшін аталған MCP серверлері. |
model | жоқ | Осы қадамға арналған модель идентификаторы. |
params | жоқ | Типтелген әрекеттерге арналған параметрлер және қызметкер қадамдарына арналған maxIterations. |
min_iterations | жоқ | Қадам аяқталмас бұрын модель кезектерінің ең аз саны. |
token_budget | жоқ | {max}. Болжам. |
on_error | {retry: 1, fallback: notify_owner} | Қайталау әрекеттері, содан кейін балама жоспар. Қайталаулардан кейінгі кез келген сәтсіздік іске қосуды аяқтайды. |
Қызметкер қадамдары
Қызметкер қадамы қызметкердің кезегі ретінде орындалады: оның персонасы, жадысы және қосылымдары қолданылады, және ол 50 модель кезегіне дейін немесе params.maxIterations мәніне дейін пайдалана алады. Алдыңғы қадамдардың нәтижелері [Activity 'id' result] блоктары ретінде беріледі. Жұмыс процесін emit тізімімен аяқтайтын қадамға сол оқиғалармен emit_event шақыру тапсырылады. Іске қосуды аяқтау үшін exit құралы әрқашан қолжетімді.
Деректер контексі
Типтелген әрекеттер мәндерді бір объектіден нүктелі жол арқылы оқиды: inputs іске қосудың кіріс мәндерін, nodes.<id> аяқталған әр әрекеттің шығысын (JSON болса, JSON ретінде талданады), ал item цикл ішіндегі ағымдағы элементті қамтиды. Жай жол алдымен inputs, содан кейін nodes ішінен іздейді.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression міндетті. Оның шығыс байланыстары True және False деп белгіленеді. params.mode оның қалай оқылатынын таңдайды:
| Режим | Өрнек |
|---|---|
expression | Әдепкі. ==, !=, >=, <=, > немесе < бар path op value, екі жағы да сан болса, сан ретінде салыстырылады; немесе жай жол, оның мәні ақиқат болса, true. |
exists | Жол; ол ақиқат мәнге айналса, true болады. |
contains | path contains text немесе алдыңғы шығыспен салыстырылатын жай мәтін. |
regex | Алдыңғы шығыспен салыстырылатын үлгі. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source — тізімнің жолы. Each item деп белгіленген байланыс денеге апарады, ол item орнатылған күйде әр элемент үшін бір рет орындалады; Done деп белгіленгені барлық элементтен кейін орындалады. concurrency орнатпасаңыз, итерациялар бірге басталады. maxIterations және batchSize да қабылданады.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait, http және command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | Түрі | Міндетті | Әрекеті |
|---|---|---|
wait | params.duration | s, m немесе h түріндегі аралыққа кідіреді. «Белгілі бір сәтке дейін күту» жоқ; оқиға бойынша жалғастыру үшін соған екінші жұмыс процесін іске қосыңыз. |
http | params.url | Сұрауды жібереді. method, headers және body міндетті емес. |
command | params.command | Shell командасын іске қосады. Оның stdout шығысы — әрекеттің шығысы. |
decide
Decide әрекеті осы уақытқа дейінгі жұмыс туралы типтелген сұрақтар қойып, condition бағыттай алатын құрылымдық жауаптарды жазады.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | Сұрақ түрі | criteria | Жауап |
|---|---|---|
choice | Нұсқадан сипаттамаға сәйкестік объектісі, 2-ден 255-ке дейін нұсқа. | choice, confidence және probabilities. |
score | 2-ден 10-ға дейінгі реттелген деңгейлер тізімі. | 0-ден (бірінші деңгей) жоғары қарай score және confidence. |
noul | Жоқ. | noul, тұжырымның дұрыс болу ықтималдығы. |
Жауап бойынша condition арқылы бағыттаңыз, мысалы, nodes.triage.urgency.score >= 1.5. params.default шешім қабылдау мүмкін болмағанда әр сұраққа қауіпсіз жауап береді; әдепкі жауаптың сенімділігі 0. Әдепкі мәні жоқ сұрақ жауапсыз қалады, сондықтан оған қойылған шарттар False қырымен жүреді.
Қателер
on_error.retry сәтсіз әрекеттің неше рет қайталанатынын белгілейді; әдепкі мәні — 1. Соңғы қайталаудан кейін іске қосу аяқталады, ал әдепкі fallback мәні notify_owner болғанда иесіне хабарланады. Nebo іске қосу басталғанда әр типтелген әрекеттің міндетті параметрлерін тексереді және белгісіз әрекетке нұсқайтын тармақты қабылдамайды.