# Project

プロジェクトは、Agent と工程を束ねて業務を進める機能です。マーケットプレイス版では、**管理者が登録した Agent**（登録 Agent）を工程に置いて動かします。ワークフローでは、実行 1 件を**案件**として、設定と成果物をバージョンで持ち、人が判断する工程で確かめてから先へ進めます。

**考え方は SaaS 版と同じです。** このセクションは、マーケットプレイス版の事実で、仕組み・クイックスタート・ガイド・リファレンスの順に読み切れるようにしています。SaaS 版との違いは [SaaS 版との対応リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/differences-ref.md)で確かめてください。

[クイックスタート](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/workflow.md)

### [小さく動かして確かめる](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/workflow.md)

[登録 Agent を置いて、最初の案件を通す。](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/workflow.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/workflow.md)

[ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md)

### [登録 Agent を使う](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md)

[置ける条件、工程の設定、Agent に渡るもの。](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md)

[リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/differences-ref.md)

### [SaaS 版との違いを引く](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/differences-ref.md)

[SaaS 版の各ページを、どう読み替えるか。](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/differences-ref.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/differences-ref.md)

[仕組み](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/project-and-steps.md)

### [仕組みを理解する](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/project-and-steps.md)

[工程・確認・記録の考え方を先に押さえる。](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/project-and-steps.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/project-and-steps.md)

## 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 版と同じです（[プロジェクトの構成](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project.md#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E6%A7%8B%E6%88%90)）。

## 2 つの型

型はプロジェクトを作るときに選びます。マーケットプレイス版の既定は**ワークフロー**です。

|              | サイクル                                             | ワークフロー                                               |
| ------------ | ------------------------------------------------ | ---------------------------------------------------- |
| **始まり方**     | 置いた登録 Agent ごとに周期を決めて、その周期で動く。Webhook で動かすこともできる | 手動（案件を開始）で始める。決めた時刻や外部 API から始めることもできる               |
| **進み方**      | 登録 Agent どうしは待ち合わせない。それぞれが自分の周期で動く               | 1 件の実行（案件）が工程を順に進む。前の工程が終わってから次の工程に移る。条件分岐で通るレーンを選べる |
| **終わり方**     | 終わらない。止めるまで動き続ける                                 | 1 件ごとに終わる（完了・却下・失敗・中断）                               |
| **工程に置けるもの** | 会話で使う登録 Agent（契約・認定は要りません）。確認工程は置けません            | 認定済みの登録 Agent。確認工程・条件分岐を置けます                         |
| **向く仕事の例**   | 決まった間隔で状態を点検し、異常があれば知らせる                         | 書類を 1 件受けて、処理し、担当者の確認を通して仕上げる                        |

## 使い方の順序

1管理者

### Agent を登録する

マーケットプレイスのAIエージェントで登録し、ワークフローで使うなら契約と認定を入れる。

2運用

### 通信を許可する

Agent が外部を使うなら、宛先を許可する。

3Project

### 工程に置く

登録 Agent を置き、工程の設定を入れる。

4Project

### 案件を進める

案件を開始し、確認工程でバージョンを見て進める。

5Project

### 記録を見る

実行記録と指標で、直すところを選ぶ。

それぞれの段階で読む場所です。

- **Agent を登録する** — [設定ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/settings-guide.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%A7%E4%BD%BF%E3%81%86)（管理者）、[ワークフローガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/develop/guide/workflow-guide.md)（Agent の開発者）
- **通信を許可する** — [実行ルールと通信ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/control-guide.md#%E5%A4%96%E3%81%B8%E3%81%AE%E9%80%9A%E4%BF%A1%E3%82%92%E7%B5%9E%E3%82%8B)
- **工程に置く** — [エージェントガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md)、業務の分け方は[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/design-guide.md#%E6%A5%AD%E5%8B%99%E3%81%A8%E3%81%97%E3%81%A6%E6%B1%BA%E3%82%81%E3%82%8B%E3%81%93%E3%81%A8)
- **案件を進める** — [案件ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/case-guide.md)、[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md)、[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md)
- **記録を見る** — [記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md)

## 画面の場所

プロジェクトを開くとタブが並びます。「ワークフロー履歴」はワークフローだけなので、ワークフローでは 5 つ、サイクルでは 4 つです（組織の運用の役割だけで開いた人には、設定のタブは出ません）。編集の画面は、タブではなく、上部の「**編集**」のボタンで開きます（オーナーだけに出ます）。**「ライブラリ」のタブは出ません。**

| タブ           | 見るもの                                                                                                                                                                                                                                                                                                                                          |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **概要**       | 上から、「プロジェクトの概要」（目的・工程・Agent の設定から AI が書いた説明か、プロジェクトの説明。どちらも無いときは出ない）、期間を選んだ「この業務の実行結果」（実行結果の文と指標）、工程に置いた登録 Agent の関係の図（右の列で、工程ごとの「基本情報」・「数値」・「最新の成果物」〈組織の運用の役割だけで開いた人には出ない〉を切り替える）、サイクルでは Agent ごとの直近 24 時間の帯、一番下に「プロジェクト情報」（1 行の要約。「すべて表示」で全部を開く）。完遂を計測しない実行（「実行終了 (完遂は未計測)」）は、凡例に別に出ます                                                      |
| **実行履歴**     | 実行の一覧。1 件を開くと実行記録。プロジェクト内の操作の記録（記録 (証跡)）もここにあります                                                                                                                                                                                                                                                                                              |
| **ワークフロー履歴** | 案件の直近の一覧。終わったものも並びます。「案件の詳細」から案件の画面へ進みます                                                                                                                                                                                                                                                                                                      |
| **対応待ち**     | 人の手が要るものの一覧。確認待ち・期限超過・外部待ち・失敗・差し戻し待ち・巡回の失敗・締め切り超過（実行）・停滞の 8 種類です（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E5%AF%BE%E5%BF%9C%E5%BE%85%E3%81%A1%E3%81%A7%E4%BA%BA%E3%81%AE%E6%89%8B%E3%81%8C%E8%A6%81%E3%82%8B%E3%82%82%E3%81%AE%E3%82%92%E7%89%87%E4%BB%98%E3%81%91%E3%82%8B)） |
| **設定**       | 基本情報・トリガーと通知・連携先(MCP, A2A)・メンバー・実行ルール。ワークフローでは「外部公開（A2A・MCP）」も並びます                                                                                                                                                                                                                                                                            |

マーケットプレイス版では、次が違います。

| 場所                 | 違い                                                                                                                                                                                                                                                                                              |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| プロジェクトの一覧の上部       | 「Agent」のタブがありません（ホーム・プロジェクト・自動実行・全体集計）                                                                                                                                                                                                                                                          |
| 編集画面の「Agent を追加」   | 登録 Agent の一覧に切り替わります                                                                                                                                                                                                                                                                            |
| プロジェクトの画面の上部       | 登録 Agent を置いたワークフローでは、「今すぐ実行」の代わりに「**案件を開始**」                                                                                                                                                                                                                                                   |
| ワークフロー履歴・実行記録      | 「**案件の詳細**」から案件の画面（進行・設定・ファイル・記録）へ                                                                                                                                                                                                                                                              |
| 設定 ＞ トリガーと通知       | メールで起動がありません                                                                                                                                                                                                                                                                                    |
| 設定 ＞ 連携先           | 「**外部条件待ちのWebhook秘密鍵**」があります（ワークフロー）                                                                                                                                                                                                                                                            |
| 設定 ＞ 外部公開（A2A・MCP） | ワークフローでは、オーナーが公開すると、管理者が受け口を開けた環境で、外部の Agent（A2A）や MCP のクライアントから依頼文を付けて案件を始められます（[MCP](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/mcp-ref.md#published)・[A2A](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/a2a-ref.md)） |

**プロジェクトは、外部 API からも使えます。** サービスアカウントのトークン（[システム連携 API リファレンス](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/api-reference.md)）と、外部ツールでログインした利用者のトークン（[ユーザー API リファレンス（プロジェクト）](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/reference/user-api-reference-projects.md)）で呼べます。

## AI クライアントから使う

Claude Code・Codex に AGENTIC STAR のプラグインを入れると、話しかけるだけでプロジェクトを使えます。たとえば、次のように頼めます。

- 「登録 Agent の『契約書チェック』を使って、届いた契約書を確かめ、私が確認してから終わるワークフローを作って」
- 「最近うまくいかなかった実行の理由を調べて、誰が直せばよいか教えて」
- 「今朝の私の確認依頼を、中身を見て片付けて」
- 「直近 30 日の成功率を、プロジェクトごとに教えて」

プラグインの入れ方とつなぎ方は、[AI クライアント接続ガイド（MCP） — プラグインで入れる](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/api/guide/ai-client-guide.md#plugin) を参照してください。AI が行える操作は、つないだアカウントやサービスアカウントにできることの範囲です。

## 仕組み

画面を見ても分からないことを、ここに集めています。設定を始める前に読んでください。

- [**プロジェクトと工程**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/project-and-steps.md) — 工程は登録 Agent を置く場所。前の工程の出力は、ファイルをつないだときだけ渡る
- [**サイクルとワークフロー**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/cycle-and-workflow.md) — ワークフローは案件として終わり、サイクルは配置ごとに動き続ける
- [**誰が何を決められるか**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/roles.md) — オーナーでも、指名されていなければ確認を決められない。案件の設定を直せるのはオーナーだけ
- [**人の確認**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/human-review.md) — 確認工程は案件を進めるかを決める工程。期限では決まらない
- [**どこまで任せるか**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/delegation.md) — 実行ルールは起動の前の照合。実行中の操作は基盤では止めない
- [**記録と指標**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/concepts/records-and-metrics.md) — 実行記録は成績表ではない。「完遂は未計測」は成功でも失敗でもない

## クイックスタート

[1 件ずつ仕上げる](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/workflow.md)

### [ワークフロー](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/workflow.md)

[登録 Agent を工程に置き、最初の案件を開始して、確認を通すまで。](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/workflow.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/workflow.md)

[動かし続ける](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/cycle.md)

### [サイクル](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/cycle.md)

[会話で使う登録 Agent を周期で巡回させ、結果を見て止めるまで。](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/cycle.md)

[→](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/quickstart/cycle.md)

## ガイド

- [**設計ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/design-guide.md) — 業務として何を決め、どう分け、工程に何をどこまで任せるか
- [**エージェントガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md) — 置ける Agent、工程の設定と環境変数、Agent に渡るもの
- [**案件ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/case-guide.md) — 案件の開始、設定と成果物のバージョン、中断
- [**確認ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md) — 期限で決まらないこと、外部条件待ち
- [**起動ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md) — 始め方の違い、サイクルの巡回と Webhook、うまくいかなかったとき
- [**実行ルールと通信ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/control-guide.md) — 実行ルールが効く範囲、外への通信の絞り方
- [**連携ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/connection-guide.md) — 何につなぎ、どこへ知らせるか
- [**記録ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md) — 対応待ち、実行環境のイメージ、未計測の結果、起動できなかった理由

## リファレンス

- [**SaaS 版との対応リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/differences-ref.md) — SaaS 版の各ページ・節の読み替え
- [**設定値リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/settings-ref.md) — マーケットプレイス版で決まっている値
- [**実行結果リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/results-ref.md) — 表示される結果の意味と、Agentの完遂率の式
- [**記録リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/events-ref.md) — 記録に加わる出来事と、エクスポートに出る項目
- [**用語リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/glossary.md) — マーケットプレイス版にだけ出てくる言葉
- [**ロールリファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/reference/roles-ref.md) — 役割ごとに、できること
