NeboAI
NeboAI
はじめる

アクティビティ

アクティビティとは、ワークフローの1つの手順です。ほとんどのアクティビティは社員が実行します。あなたが意図を伝えれば、社員がスキルと接続を使って仕事をこなします。6つの種類はモデルを使わずに実行されるので、振り分けとタイミングは厳密に保たれます。

フィールド

{
  "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とデータのパスで使われます。
typecustom社員の手順、または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パス。真と評価される値に解決されれば真。
containspath 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" } }
種類必須動作
waitparams.durations、m、hで指定した期間だけ一時停止します。指定時刻まで待つ機能はありません。イベントで再開するには、そのイベントで2つ目のワークフローを起動してください。
httpparams.urlリクエストを送ります。method、headers、bodyは任意です。
commandparams.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。
score2〜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は実行の開始時に、型付きの各アクティビティの必須パラメーターを確認し、存在しないアクティビティを指す分岐を拒否します。