Project
プロジェクトは、Agent と工程を束ねて業務を進める機能です。マーケットプレイス版では、管理者が登録した Agent(登録 Agent)を工程に置いて動かします。ワークフローでは、実行 1 件を案件として、設定と成果物をバージョンで持ち、人が判断する工程で確かめてから先へ進めます。
考え方は SaaS 版と同じです。 このセクションは、マーケットプレイス版の事実で、仕組み・クイックスタート・ガイド・リファレンスの順に読み切れるようにしています。SaaS 版との違いは SaaS 版との対応リファレンスで確かめてください。
小さく動かして確かめる
登録 Agent を置いて、最初の案件を通す。
→登録 Agent を使う
置ける条件、工程の設定、Agent に渡るもの。
→SaaS 版との違いを引く
SaaS 版の各ページを、どう読み替えるか。
→仕組みを理解する
工程・確認・記録の考え方を先に押さえる。
→SaaS 版との主な違い
| SaaS 版 | マーケットプレイス版 | |
|---|---|---|
| 工程に置く Agent | 利用者がプロジェクトで作る(ゴール (指示)・ガードレール・Playbook・Skill) | 管理者が管理コンソールで登録したコンテナの Agent。プロジェクトでは作らず、中身も変えない |
| ワークフローに置ける条件 | ゴール (指示) があること | 管理者が契約を登録し、認定済みであること |
| 工程ごとに変えるもの | (Agent を直す) | 工程の設定(設定値・連携先・入力ファイルの受け渡し)/環境変数(サイクル) |
| 工程の間の受け渡し | 前の工程の出力が次の工程に渡る | ファイルをつないだときだけ渡る |
| ワークフローの実行 | 「今すぐ実行」 | 「案件を開始」。設定と成果物をバージョンで持つ |
| ワークフローの形 | レーンで分かれ、同時に実行できる | 直列。並列のレーンと「同時に実行」はありません。条件分岐で、前の工程の結果によって進むレーンを選べます(判定対象に「質問で判定」はありません) |
| 確認方法 | 担当者の判断を待つ/期限後に自動で進める | 担当者の判断を待つ/外部条件待ち(GitLabのMRのマージ)。期限では決まらない |
| 始め方 | 手動・時間・外部 API・メール | 手動・時間・外部 API(メールは無い) |
| AI で作る・改善案の相談 | ある | ない |
| プロジェクトの記憶 | ある | ない |
| 実行ルール | 基本ルールと禁止操作が実行に効く | 基本ルールで起動の可否を決める(ワークフロー)。外への通信は NetworkPolicy と管理コンソールの「禁止URL」で絞る |
プロジェクトの構成
プロジェクトには工程があり、工程には登録 Agent を置きます。登録 Agent が何をするかは、コンテナのイメージ(ワークフローでは、管理者が登録した契約も)で決まります。人が判断する工程では、Agent は動きません。確認担当者が、案件の成果物と設定を見て決めます。
| 言葉 | 意味 |
|---|---|
| 登録 Agent | 管理者が管理コンソールの「マーケットプレイスのAIエージェント」で登録した Agent。SDK で作ったコンテナのイメージで動く |
| 契約 | 登録 Agent が受け取る設定値・ファイル・成果物・接続先と、外部への効果・実行上限の取り決め。ワークフローで使う Agent にだけある |
| 認定 | 契約に、試験で確かめた SDK 版・adapter 版・image digest・試験結果・使える実行ルールがそろっていること。認定済みの Agent だけをワークフローに置ける |
| 工程の設定 | ワークフローの配置ごとに、契約の範囲で決める設定値・連携先・入力ファイルの受け渡し |
| 案件 | 登録 Agent を置いたワークフローの実行 1 件。設定と成果物をバージョンで持つ |
| 外部条件待ち | 外部サービスの状態(GitLabのMRのマージ)で次の工程へ進める確認方法 |
ほかの言葉(工程・配置・確認工程・実行記録・実行ルール・共通の記録先)は SaaS 版と同じです(プロジェクトの構成)。
2 つの型
型はプロジェクトを作るときに選びます。マーケットプレイス版の既定はワークフローです。
| サイクル | ワークフロー | |
|---|---|---|
| 始まり方 | 置いた登録 Agent ごとに周期を決めて、その周期で動く。Webhook で動かすこともできる | 手動(案件を開始)で始める。決めた時刻や外部 API から始めることもできる |
| 進み方 | 登録 Agent どうしは待ち合わせない。それぞれが自分の周期で動く | 1 件の実行(案件)が工程を順に進む。前の工程が終わってから次の工程に移る。条件分岐で通るレーンを選べる |
| 終わり方 | 終わらない。止めるまで動き続ける | 1 件ごとに終わる(完了・却下・失敗・中断) |
| 工程に置けるもの | 会話で使う登録 Agent(契約・認定は要りません)。確認工程は置けません | 認定済みの登録 Agent。確認工程・条件分岐を置けます |
| 向く仕事の例 | 決まった間隔で状態を点検し、異常があれば知らせる | 書類を 1 件受けて、処理し、担当者の確認を通して仕上げる |
使い方の順序
Agent を登録する
マーケットプレイスのAIエージェントで登録し、ワークフローで使うなら契約と認定を入れる。
通信を許可する
Agent が外部を使うなら、宛先を許可する。
工程に置く
登録 Agent を置き、工程の設定を入れる。
案件を進める
案件を開始し、確認工程でバージョンを見て進める。
記録を見る
実行記録と指標で、直すところを選ぶ。
それぞれの段階で読む場所です。
- Agent を登録する — 設定ガイド(管理者)、ワークフローガイド(Agent の開発者)
- 通信を許可する — 実行ルールと通信ガイド
- 工程に置く — エージェントガイド、業務の分け方は設計ガイド
- 案件を進める — 案件ガイド、確認ガイド、起動ガイド
- 記録を見る — 記録ガイド
画面の場所
プロジェクトを開くとタブが並びます。「ワークフロー履歴」はワークフローだけなので、ワークフローでは 5 つ、サイクルでは 4 つです(組織の運用の役割だけで開いた人には、設定のタブは出ません)。編集の画面は、タブではなく、上部の「編集」のボタンで開きます(オーナーだけに出ます)。「ライブラリ」のタブは出ません。
| タブ | 見るもの |
|---|---|
| 概要 | 上から、「プロジェクトの概要」(目的・工程・Agent の設定から AI が書いた説明か、プロジェクトの説明。どちらも無いときは出ない)、期間を選んだ「この業務の実行結果」(実行結果の文と指標)、工程に置いた登録 Agent の関係の図(右の列で、工程ごとの「基本情報」・「数値」・「最新の成果物」〈組織の運用の役割だけで開いた人には出ない〉を切り替える)、サイクルでは Agent ごとの直近 24 時間の帯、一番下に「プロジェクト情報」(1 行の要約。「すべて表示」で全部を開く)。完遂を計測しない実行(「実行終了 (完遂は未計測)」)は、凡例に別に出ます |
| 実行履歴 | 実行の一覧。1 件を開くと実行記録。プロジェクト内の操作の記録(記録 (証跡))もここにあります |
| ワークフロー履歴 | 案件の直近の一覧。終わったものも並びます。「案件の詳細」から案件の画面へ進みます |
| 対応待ち | 人の手が要るものの一覧。確認待ち・期限超過・外部待ち・失敗・差し戻し待ち・巡回の失敗・締め切り超過(実行)・停滞の 8 種類です(記録ガイド) |
| 設定 | 基本情報・トリガーと通知・連携先(MCP, A2A)・メンバー・実行ルール。ワークフローでは「外部公開(A2A・MCP)」も並びます |
マーケットプレイス版では、次が違います。
| 場所 | 違い |
|---|---|
| プロジェクトの一覧の上部 | 「Agent」のタブがありません(ホーム・プロジェクト・自動実行・全体集計) |
| 編集画面の「Agent を追加」 | 登録 Agent の一覧に切り替わります |
| プロジェクトの画面の上部 | 登録 Agent を置いたワークフローでは、「今すぐ実行」の代わりに「案件を開始」 |
| ワークフロー履歴・実行記録 | 「案件の詳細」から案件の画面(進行・設定・ファイル・記録)へ |
| 設定 > トリガーと通知 | メールで起動がありません |
| 設定 > 連携先 | 「外部条件待ちのWebhook秘密鍵」があります(ワークフロー) |
| 設定 > 外部公開(A2A・MCP) | ワークフローでは、オーナーが公開すると、管理者が受け口を開けた環境で、外部の Agent(A2A)や MCP のクライアントから依頼文を付けて案件を始められます(MCP・A2A) |
プロジェクトは、外部 API からも使えます。 サービスアカウントのトークン(システム連携 API リファレンス)と、外部ツールでログインした利用者のトークン(ユーザー API リファレンス(プロジェクト))で呼べます。
AI クライアントから使う
Claude Code・Codex に AGENTIC STAR のプラグインを入れると、話しかけるだけでプロジェクトを使えます。たとえば、次のように頼めます。
- 「登録 Agent の『契約書チェック』を使って、届いた契約書を確かめ、私が確認してから終わるワークフローを作って」
- 「最近うまくいかなかった実行の理由を調べて、誰が直せばよいか教えて」
- 「今朝の私の確認依頼を、中身を見て片付けて」
- 「直近 30 日の成功率を、プロジェクトごとに教えて」
プラグインの入れ方とつなぎ方は、AI クライアント接続ガイド(MCP) — プラグインで入れる を参照してください。AI が行える操作は、つないだアカウントやサービスアカウントにできることの範囲です。
仕組み
画面を見ても分からないことを、ここに集めています。設定を始める前に読んでください。
- プロジェクトと工程 — 工程は登録 Agent を置く場所。前の工程の出力は、ファイルをつないだときだけ渡る
- サイクルとワークフロー — ワークフローは案件として終わり、サイクルは配置ごとに動き続ける
- 誰が何を決められるか — オーナーでも、指名されていなければ確認を決められない。案件の設定を直せるのはオーナーだけ
- 人の確認 — 確認工程は案件を進めるかを決める工程。期限では決まらない
- どこまで任せるか — 実行ルールは起動の前の照合。実行中の操作は基盤では止めない
- 記録と指標 — 実行記録は成績表ではない。「完遂は未計測」は成功でも失敗でもない
クイックスタート
ガイド
- 設計ガイド — 業務として何を決め、どう分け、工程に何をどこまで任せるか
- エージェントガイド — 置ける Agent、工程の設定と環境変数、Agent に渡るもの
- 案件ガイド — 案件の開始、設定と成果物のバージョン、中断
- 確認ガイド — 期限で決まらないこと、外部条件待ち
- 起動ガイド — 始め方の違い、サイクルの巡回と Webhook、うまくいかなかったとき
- 実行ルールと通信ガイド — 実行ルールが効く範囲、外への通信の絞り方
- 連携ガイド — 何につなぎ、どこへ知らせるか
- 記録ガイド — 対応待ち、実行環境のイメージ、未計測の結果、起動できなかった理由
リファレンス
- SaaS 版との対応リファレンス — SaaS 版の各ページ・節の読み替え
- 設定値リファレンス — マーケットプレイス版で決まっている値
- 実行結果リファレンス — 表示される結果の意味と、Agentの完遂率の式
- 記録リファレンス — 記録に加わる出来事と、エクスポートに出る項目
- 用語リファレンス — マーケットプレイス版にだけ出てくる言葉
- ロールリファレンス — 役割ごとに、できること