フィールド
{
"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 | [] | 1文では足りないときの、順序付きの指示。 |
label | なし | オーナーに表示される名前。 |
skills | [] | 使うスキル。ここに記載したマーケットプレイスのスキルは、社員と一緒にインストールされます。 |
tools | [] | 設定した場合、その手順で使えるのはこのツールだけになります。 |
requires_tools | [] | 手順が完了したと見なされるために成功する必要があるツール。 |
cmds | [] | この手順用に指定したプラグインのコマンド。 |
mcps | [] | この手順用に指定したMCPサーバー。 |
model | なし | この手順で使うモデルのID。 |
params | なし | 型付きのアクティビティのパラメーター、および社員の手順のmaxIterations。 |
min_iterations | なし | 手順を終えられるようになるまでの最小のモデルのターン数。 |
token_budget | なし | {max}。見積もりです。 |
on_error | {retry: 1, fallback: notify_owner} | 再試行、次にフォールバック。再試行の後に失敗すると、実行は終了します。 |
社員の手順
社員の手順は、社員の1ターンとして実行されます。ペルソナ、メモリ、接続が適用され、最大50回のモデルのターン、またはparams.maxIterationsまで使えます。それまでの手順の結果は[Activity 'id' result]ブロックとして渡されます。emitリストでワークフローを締めくくる手順には、そのイベントでemit_eventを呼び出すよう指示されます。実行を終えるためのexitツールは常に利用できます。
データのコンテキスト
型付きのアクティビティは、1つのオブジェクトからドット記法のパスで値を読み取ります。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で、両辺が数値なら数値として比較します。またはパスのみで、その値が真と評価されれば真。 |
exists | パス。真と評価される値に解決されれば真。 |
contains | path contains text、または直前の出力と照合するテキストのみ。 |
regex | 直前の出力と照合するパターン。 |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.sourceはリストのパスです。Each itemというラベルの接続は本体につながり、本体はitemを設定して項目ごとに1回実行されます。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で指定した期間だけ一時停止します。指定時刻まで待つ機能はありません。イベントで再開するには、そのイベントで2つ目のワークフローを起動してください。 |
http | params.url | リクエストを送ります。method、headers、bodyは任意です。 |
command | params.command | シェルコマンドを実行します。その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: その記述が成り立つ確率。 |
nodes.triage.urgency.score >= 1.5のように、conditionで答えに応じて振り分けます。params.defaultは、判定ができないときの各質問の安全な答えを指定します。デフォルトが使われた答えの確信度は0です。デフォルトのない質問には答えが付かないので、それに対するconditionはFalseのエッジを通ります。
エラー
on_error.retryは、失敗したアクティビティを再試行する回数を設定します。デフォルトは1です。最後の再試行の後に実行は終了し、デフォルトのfallbackであるnotify_ownerの場合はオーナーに知らされます。Neboは実行の開始時に、型付きの各アクティビティの必須パラメーターを確認し、存在しないアクティビティを指す分岐を拒否します。