# Project

プロジェクトは、Agent と工程を束ねて業務を進める機能です。工程ごとに、どこまで Agent に任せるかを決められます。**ワークフローでは**人が判断する工程を置けば、そこで一度止めて確認できます。実行した内容は、あとから 1 件ずつたどれます。

**業務への組み込みを考えるなら**[設計ガイドの「業務として決めること」](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/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/saas/project/guide/record-guide.md#%E5%AE%9F%E7%B8%BE%E3%81%8B%E3%82%89%E8%A6%8B%E7%9B%B4%E3%81%99)から読んでください。

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

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

[中で何が起きているかを先に押さえる。](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/project-and-steps.md)

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

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

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

[読んだことを手で試す。](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/quickstart/workflow.md)

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

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

### [業務に合わせて設定する](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md)

[どちらを選ぶべきか、判断の基準を示す。](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md)

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

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

### [迷ったときに参照する](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md)

[上限・既定値と、画面の言葉の対応。](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md)

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

## プロジェクトの構成

プロジェクトには工程があり、工程には Agent を置きます（Agent を置かない工程もあります。確認工程・外部の自動化・条件分岐）。Agent には、やることを書いたゴール（指示）と、やってはいけないことを書いたガードレールを持たせ、Playbook と Skill を付けます。人が判断する工程には Agent を置きません。確認担当者が、直前の工程の出力を見て決めます。1 件ごとの実行記録に、何をしたかが残ります。

| 言葉           | 意味                                                                                                      |
| ------------ | ------------------------------------------------------------------------------------------------------- |
| **プロジェクト**   | 工程と Agent をまとめる単位。タグで分類できる                                                                              |
| **工程**       | Agent を置く場所。1 つの工程に複数置ける。確認工程・外部の自動化・条件分岐には置かない                                                         |
| **Agent**    | 仕事をする担当。ゴール（指示）とガードレールで動き方を決め、Playbook と Skill を付ける。複数の工程やプロジェクトで使い回せる                                  |
| **Playbook** | Agent に最大 1 つ付けられる段取り。繰り返す作業の手順を、各ステップの目的・ガイダンス・成功条件で書く。手順は Agent が依頼に応じて調整する                           |
| **Skill**    | Agent に複数付けられる、個別の作業のやり方。やり方を書いた文書に、必要ならスクリプトなどのファイルを添えて登録する                                            |
| **配置**       | Agent を工程に置いた 1 つ 1 つ。同じ Agent を 2 つの工程に置けば、配置は 2 つ。サイクルでは周期もこの単位で決める                                   |
| **確認工程**     | 人が判断する工程。確認担当者が直前の工程の出力を見て、次の工程へ進める・差し戻す・却下するのいずれかを選ぶ（進めるときに出力を直すこともできる）。担当者に届く依頼は「確認依頼」                |
| **実行記録**     | 実行 1 件の詳細。依頼・根拠・実行したこと・確認・結果をたどれる。実行の一覧は「実行履歴」、プロジェクト内の操作の記録は「記録 (証跡)」                                  |
| **実行ルール**    | Agent にどの操作まで許すかを決める設定。テナント全体で決めた実行ルールを受け継ぎ、プロジェクトでは厳しくする方向にだけ変えられる                                     |
| **共通の記録先**   | プロジェクトの Agent どうしが共通に読み書きする連携先。連携先に「共通の記録先にする」を付けて指定する。付けただけでは読み書きは起きず、何をどう読み書きするかは各 Agent のゴール（指示）が決める |
| **接続の確認**    | 連携先に「接続時の確認」を設定したとき、Agent がその連携先を使う前に実行を止めて立てる確認依頼。承認すると起動し直す。ワークフローでもサイクルでも使える                         |

なお、Agent を作るときに **Claw** という言葉が出てきます。Claw は、会話に紐づけて決めた予定で実行する機能です。プロジェクトで使うものではなく、**Agent を作るときの複製元としてだけ出てきます**。複製されるのは内容だけで、時間などのトリガーは引き継がれません。

## 2 つの型

型はプロジェクトを作るときに選びます。**後から変えられません。**

|            | サイクル                                               | ワークフロー                                                                   |
| ---------- | -------------------------------------------------- | ------------------------------------------------------------------------ |
| **始まり方**   | 置いた Agent ごとに周期を決めて、その周期で動く。Webhook やメールで動かすこともできる | 手動で始める。決めた時刻や外部 API、メールから始めることもできる。決めた時刻に始めるときは、どの工程から始めるかを選べる           |
| **進み方**    | Agent どうしは待ち合わせない。それぞれが自分の周期で動く                    | 1 件の実行が工程を順に進む。前の工程が終わってから次の工程に移る。途中でレーンに分かれて同時に進めることも、条件で通るレーンを選ぶこともできる |
| **終わり方**   | 終わらない。止めるまで動き続ける                                   | 1 件ごとに終わる（完了・却下・失敗・中断）                                                   |
| **向く仕事の例** | 届いた依頼を受け取って一次対応する。決まった間隔で状態を点検し、異常があれば知らせる         | 申請を 1 件受けて、作業し、担当者の確認を通して仕上げる。月末に一度動かして、レポートを作って出す                       |

## 使い方の順序

1

### 業務を選ぶ

任せる範囲、業務としての終わり、結果の届け先を決める。

2

### つなぎ先を決める

このプロジェクトで使う外部サービスを追加して、認証する。

3

### 任せ方を決める

工程を並べ、Agent を置き、許す操作の範囲を決める。

4

### 確認しながら使う

ワークフローなら確認工程で人が判断して次に進める。

5

### 実績で見直す

実績を見て、直す場所と確認の置き方を見直す。

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

- **業務を選ぶ** — どこまで任せるか、何ができたら終わりか、プロジェクトをどこで分けるか、結果をどこへ届けるか（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/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/saas/project/guide/connection-guide.md)
- **任せ方を決める** — 型・工程・Agent（[設計ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md)）、許す操作（[実行ルールガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/control-guide.md)）、始め方（[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/trigger-guide.md)）
- **確認しながら使う** — 人の判断の置き方（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md)）、誰がどこを見るか（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/record-guide.md#%E3%81%A9%E3%81%93%E3%82%92%E8%A6%8B%E3%82%8B%E3%81%8B)）、人の手が要るものの片付け方（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/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)）、止め方（[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/trigger-guide.md#%E6%AD%A2%E3%82%81%E3%82%8B%E5%86%8D%E9%96%8B%E3%81%99%E3%82%8B)）
- **実績で見直す** — 実績を読み、直す場所を選び、試してから反映し、業務としての終わりに照らして比べる（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/record-guide.md#%E5%AE%9F%E7%B8%BE%E3%81%8B%E3%82%89%E8%A6%8B%E7%9B%B4%E3%81%99)）

## 画面の場所

プロジェクトを開くとタブが並びます。「ワークフロー履歴」はワークフローだけなので、ワークフローでは 6 つ、サイクルでは 5 つです。

| タブ           | 見るもの                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **概要**       | 上から、「プロジェクトの概要」（目的・工程・Agent の設定から AI が書いた、何をする業務かの説明。作れないときはプロジェクトの説明。どちらも無いときは出ない）、選んだ期間の「この業務の実行結果」（実行結果の文・指標（KPI）・日ごとの実行など）、工程と Agent の流れの図（「ワークフローの形」。右の列で、工程ごとの「基本情報」・「数値」・「最新の成果物」〈組織の運用の役割だけで開いた人には出ない〉を切り替える）、サイクルでは Agent ごとの直近 24 時間の帯、一番下に「プロジェクト情報」（1 行の要約。「すべて表示」で全部を開く）。進行中のワークフローの実行はワークフロー履歴で見る。目的・メンバーなどの基本情報と、起動・連携先(MCP, A2A)・登録Agent・人の確認・実行ルール・通知・記録と閲覧の設定は「プロジェクト情報」の「すべて表示」で開く |
| **実行履歴**     | 実行の一覧。1 件を開くと実行記録。プロジェクト内の操作の記録（記録 (証跡)）もここにある                                                                                                                                                                                                                                                                                                                                                        |
| **ワークフロー履歴** | ワークフローの直近の実行。終わったものも並ぶ                                                                                                                                                                                                                                                                                                                                                                                |
| **対応待ち**     | 人の手が要るものの一覧（確認待ち・期限超過・失敗・差し戻し待ち・巡回の失敗・実行の締め切り超過・停滞）。選んだ行をまとめて承認したり、期限を延ばしたりできる                                                                                                                                                                                                                                                                                                                        |
| **ライブラリ**    | プロジェクトで共有するファイル。バージョンが残り、工程の Agent に渡せる                                                                                                                                                                                                                                                                                                                                                               |
| **設定**       | 基本情報・トリガーと通知・連携先(MCP, A2A)・メンバー・実行ルール                                                                                                                                                                                                                                                                                                                                                                 |

工程と Agent の編集は、タブとは別のエディタ画面で行います。オーナーには、プロジェクトの画面の上部に「編集」が出ます。

画面の言葉を 1 文ずつ説明した「**用語集**」は、プロジェクトの一覧の「自分のプロジェクト」に 1 件も並ばないとき（検索語を入れているときを除きます）と、設定 タブの「基本情報」の見出しの横と、「ホーム」の説明の行の横から開けます。最初の進め方を並べた「**初めての流れ**」のカードは、同じく「自分のプロジェクト」に 1 件も並ばないときの一覧と、「ホーム」にプロジェクトが 1 件も無いときと、作成から 7 日以内で、選んでいる期間に実行が 1 件も無いプロジェクトの概要に出ます（閉じると、そのブラウザでは出ません）。

**プロジェクトは、外部 API からも使えます**（[外部 API のドキュメント](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/api/agent/reference/api-reference-projects.md)）。

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

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

- 「毎朝 9 時に、社内向けのお知らせの下書きを作り、私が確認してから終わるワークフローを作って」
- 「最近うまくいかなかった実行の理由を調べて、直して」
- 「今朝の私の確認依頼を、中身を見て片付けて」
- 「直近 30 日の成功率を、プロジェクトごとに教えて」

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

## 仕組み

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

- [**プロジェクトと工程**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/project-and-steps.md) — 工程は Agent を置く場所。確認工程には Agent を置かない。Playbook は段取り、Skill はやり方で、どちらも Agent に属する
- [**サイクルとワークフロー**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/cycle-and-workflow.md) — サイクルは配置ごとに独立して動く。型は後から変えられない
- [**誰が何を決められるか**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/roles.md) — 管理コンソールの役割とプロジェクトの役割は別。オーナーでも指名されていなければ（代理人でもなければ）確認を決定できない（Agent の結果から作られる確認依頼と接続の確認だけは、原則としてオーナー全員が担当者）
- [**人の確認**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/human-review.md) — 確認工程は業務を次に進めるかを決める工程。Agent の実行を止める仕組みではない
- [**どこまで任せるか**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/delegation.md) — 実行ルールは厳しくする方向にだけ使える。どこに効いて、どこからが利用者の責任か
- [**記録と指標**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/concepts/records-and-metrics.md) — 実行記録は 5 つの問いで読む。Agentの完遂率は業務の成果ではない

## クイックスタート

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

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

[工程を作り、確認担当者を決めて、最初のワークフローを実行するまで。](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/quickstart/workflow.md)

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

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

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

[Agent を工程に置き、動かす周期を決めて、最初の巡回を回すまで。](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/quickstart/cycle.md)

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

## ガイド

- [**設計ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/design-guide.md) — 業務として何を決め、どう分け、工程と Agent に何をどこまで任せるか
- [**実行ルールガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/control-guide.md) — Agent にどの操作まで許すか。全体の基本ルールをどう受け継ぎ、禁止操作をどう書くか
- [**確認ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/review-guide.md) — 誰が、どこで判断するか。担当者の決め方と、期限が来たときの扱い
- [**起動ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/trigger-guide.md) — いつ動かし、どう止めるか。決めた時刻、Agent ごとの周期、外部からの呼び出し、手動の使い分け
- [**連携ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/connection-guide.md) — 何につなぎ、どこへ知らせるか
- [**記録ガイド**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/guide/record-guide.md) — 結果をどう読み、実績からどこを見直すか

## リファレンス

- [**設定値リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/settings-ref.md) — 工程数・Skill 数・期限・時刻の書き方など、決まっている値の一覧
- [**実行結果リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/results-ref.md) — 表示される結果の意味と、Agentの完遂率の式
- [**記録リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/events-ref.md) — 記録に残る出来事、CSV の列、エクスポートに含まれるもの
- [**用語リファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/glossary.md) — 画面の言葉と、記録や設定に出てくる言葉の対応
- [**ロールリファレンス**](https://developers.fd.agenticstar.tm.softbank.jp/docs/saas/project/reference/roles-ref.md) — オーナー・運用担当・メンバー・組織の運用の役割・組織管理者・システム管理者ごとに、できること
