プロジェクトと工程
「工程」という言葉から、処理が順に流れていく段を思い浮かべるかもしれません。プロジェクトで登録 Agent を置く工程は違います。
このページでは、工程が何なのか、登録 Agent がどう置かれるのか、工程の間で何が受け渡されるのかを説明します。設定の手順はエージェントガイドにあります。
プロジェクトは、業務の進め方をまとめた単位
プロジェクトは、1 つの業務を進めるためのまとまりです。中に工程を並べ、仕事をさせたい工程に登録 Agent を置きます。
まとまるのは工程と Agent だけではありません。どこまで任せるか(実行ルール)、誰が参加するか、どの連携先を使うかも、プロジェクトの単位で決まります。記録も、プロジェクトごとにたまります。
工程は登録 Agent の置き場
工程は、登録 Agent を置く場所です。工程そのものは何もしません。置かれた登録 Agent が、コンテナのイメージ(ワークフローでは、管理者が登録した契約も)で決まった仕事をします。ただし、ワークフローには Agent が動かない工程が 2 つあります。人が判断する「確認工程」と、前の工程の結果で進むレーンを選ぶ「条件分岐」の工程です。マーケットプレイス版には、選んだ宛先へ送る「外部の自動化」の工程はありません。
工程を並べた順番が、そのまま処理の順番になるとは限りません。ワークフローは工程の順に進みます(条件分岐の工程では、選ばれたレーンだけを通ります)。サイクルでは、工程に置いた Agent ごとに巡回の周期を決め、それぞれの周期で動きます。どちらになるかは型で決まります(サイクルとワークフロー)。
Agent と工程は 1 対 1 ではない
登録 Agent は工程の一部ではありません。管理者が登録した独立のもので、同じ登録 Agent を複数の工程に置けます。
登録 Agent を工程に置いたもの 1 つ 1 つを配置と呼びます。工程の設定も、サイクルの巡回の周期も、この配置の単位です。同じ Agent を 2 つの工程に置けば配置は 2 つあり、それぞれ別の設定値や連携先を持てます。
同じ工程に複数置いたときの動き
ワークフローでは、同じ工程の Agent が配置順に 1 体ずつ動きます。「同時に実行」はありません。サイクルでは待ち合わせがなく、同じ工程の配置どうしも、それぞれの周期や Webhook で動きます。
ワークフローでは、前の工程の出力は、自動では次の工程に渡りません。 渡るのは、工程の設定の「入力ファイルの受け渡し」でつないだファイルだけです。工程をまたいで受け渡したい出力は、必ずつないでください(エージェントガイド)。サイクルでは、工程の間で出力は渡りません。
人が判断する工程では Agent は動かない
確認工程では、Agent は動きません。確認工程はワークフローのもので、サイクルには置けません。確認担当者が案件の成果物と設定を見て、次の工程へ進める・差し戻す・却下するのいずれかを選びます。Agent が何かをする工程ではなく、判断のための工程です。確認の種類を「手作業」にすると、AI は実行せず、人が作業してから進める工程にもなります。
確認工程の置き場所と、確認担当者の決め方は確認ガイドで扱います。
Agent の動き方は、イメージと契約で決まる
マーケットプレイス版には、Playbook も Skill もありません。ゴール(指示)やガードレールを付けることもありません。登録 Agent が何をするかは、コンテナのイメージ(ワークフローでは、管理者が登録した契約も)で決まります。 プロジェクトから Agent に、指示の文章は渡りません。プロジェクトで決めるのは、どの工程に置くかと、工程ごとの設定だけです。
この帰属は、あとから効いてきます。工程の設定を変えても Agent のイメージは変わりません。Agent のする仕事を変えたいときは、Agent の開発者がイメージを作り直します(ワークフローに置く Agent は、管理者が認定し直します)(エージェントガイド)。同じ登録 Agent を使う別のプロジェクトにも、その変更は、次に始まる案件から効きます(すでに始まっている案件は、始まったときの内容のままです)。
プロジェクトの記憶は無い
マーケットプレイス版には、プロジェクトの記憶も、会社の記憶もありません。実行のあとの実行に、決定や条件が自動で引き継がれることはありません。工程の間で受け渡すのは、ファイルです。 次の実行に残したいものは、Agent の出力と契約で決めてください。
次に読むもの
- サイクルとワークフロー — 工程の順番が意味を持つ型と、持たない型
- エージェントガイド — 登録 Agent を置く、工程の設定を入れる
- 確認ガイド — 確認工程をどこに置き、誰が決めるか