# ワークフロー

登録 Agent を工程に置いたワークフローを 1 つ作り、最初の案件を開始して、確認工程を通して完了させるまでの手順です。

## はじめに

**マーケットプレイス版では、プロジェクトの画面で Agent を作りません。** 工程に置くのは、管理者が管理コンソールで登録し、認定した Agent です。始める前に、次がそろっていることを確かめてください。

| 必要なもの                                 | 用意する人    | 手順                                                                                                                                                                                         |
| ------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| ワークフローで使う登録 Agent が 2 つ、**認定済み**であること | 管理者      | [設定ガイド](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) |
| その 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/build/guide/settings-guide.md)                                                                                   |

プロジェクトを作ると、ワークフローには 3 つの工程が最初から用意されます。このクイックスタートでは、その 3 つの工程で動かします。**認定済みの登録 Agent を 2 つ**使います（工程1 と工程3 に 1 つずつ）。

| 工程      | 種類          | ここでやること                          |
| ------- | ----------- | -------------------------------- |
| **工程1** | Agent を置く工程 | 登録 Agent が仕事をする                  |
| **工程2** | 確認工程        | 自分が成果物を見て、次に進めるかを決める             |
| **工程3** | Agent を置く工程 | 登録 Agent が仕上げる（工程1 とは別の登録 Agent） |

**パソコンの画面で、ブラウザーの幅を広くして進めてください。** 編集画面が左・中央・右の 3 つに分かれて並ぶ幅で書いています。

## Step 1: プロジェクトを作る

1. 左の「**プロジェクト**」を開き、上部の「**プロジェクト**」を選んで「**新規プロジェクト**」を押します
2. 「どのように作りますか」で「**自分で作る**」を選び、種別が「**ワークフロー**」になっていることを確かめます（マーケットプレイス版では、初めからワークフローが選ばれています）
3. 名前を入れて「**作成**」を押します

作成すると、そのまま**編集画面**が開きます。左に「編集ツール」と一覧、中央に工程の図（「編集キャンバス」）、右に選んだものの設定（「プロパティ」）が並びます。

**作っただけでは何も動きません。** 動くのは、このあと案件を開始したときです。

## Step 2: 工程に登録 Agent を置く

1. 左の「**編集ツール**」で「**Agent を追加**」を押します。一覧が登録 Agent の一覧に切り替わります
2. 置きたい Agent を選びます。右に「Agent の内容」が出て、名前の横に「**認定済み**」と出ていることを確かめます
3. 「**工程に配置する**」の「**1. 工程1**」を押します。「**Agent を配置しました**」と出ます
4. 同じようにして、「**工程3**」にもう 1 つの Agent を置きます

**登録 Agent を初めて置いたときは、その場でプロジェクトに保存されます。** 下書きには載りません。定義の変更に承認が要る環境では、初めての配置も承認待ちのバージョンになり、承認されるまで実行には使われません。

> **同じ Agent をほかの工程にも置くとき**
>
> すでに置いた Agent をほかの工程にも置く操作は、下書きに載ります。その工程の工程の設定も下書きに入り、Step 5 で一緒に反映します。

一覧に Agent が無い、または「利用不可 (未認定)」と出るときは、管理者に契約と認定の登録を頼んでください（[エージェントガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md#%E7%BD%AE%E3%81%91%E3%82%8B-agent)）。

## Step 3: 工程の設定を入れる

1. 中央の図で、「**工程1**」に置いた Agent を押します。右の見出しが「**工程の Agent**」になります
2. 「**基本設定**」の「**工程の設定**」で、必要な**設定値**と**連携先**を入れます。空欄の項目は、Agent の標準値で動きます
3. 入れた値は下書きに入ります。Step 5 で反映すると、プロジェクトに入ります
4. 「**工程3**」の Agent も同じようにします。工程3 の Agent が入力ファイルを受け取る契約なら、「**入力ファイルの受け渡し**」で、工程1 の Agent の出力を選びます

**前の工程の出力は、自動では次の工程に渡りません。** 渡したいときは、4 のように「入力ファイルの受け渡し」でつなぎます。

「参照・ツール」を開くと、契約の要約（外部への効果・実行上限・ファイル・出力）を確かめられます。

## Step 4: 確認担当者に自分を選ぶ

1. 中央の図で「**工程2**」を選びます
2. 右の「**確認の設定**」＞「**基本設定**」＞「**確認担当者**」で、自分の名前を選びます
3. 「**確認方法**」が「**担当者の判断を待つ**」になっていることを確かめます

**確認担当者を選ばないと、案件を開始できません。**

**マーケットプレイス版では、期限を過ぎても確認は自動で決まりません。** 自分が決めるまで、案件は先へ進みません（[確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md#%E6%9C%9F%E9%99%90%E3%81%A7%E3%81%AF%E6%B1%BA%E3%81%BE%E3%82%89%E3%81%AA%E3%81%84)）。

## Step 5: 検証して反映する

1. 編集画面の上部の「**設定を検証**」を押し、3 つの工程がどれも「**設定 OK**」になっていることを確かめて閉じます
2. 「**変更を反映**」を押し、「反映する変更を見直す」で「**反映する**」を押します

**反映するまで、工程の構成・工程の設定・確認の設定の変更はプロジェクトに入りません。** Step 2 の時点で保存されているのは、Agent の初めての配置だけです。

## Step 6: 案件を開始する

1. 「**プロジェクトに戻る**」でプロジェクトの画面に戻ります
2. 上部の「**案件を開始**」を押します
3. 開いた画面に、配置ごとに「1. 工程1 — （Agent 名）」のように並びます。Step 3 で入れた値が入っていることを確かめ、**指示ファイル**があれば中身を入れます
4. 「**開始する**」を押します。「案件を開始しました」と出ます

Agent が動き始めるまで、数分かかることがあります。

## Step 7: 確認して進める

1. 「**ワークフロー履歴**」タブを開き、行の「**案件の詳細**」を押します。案件の画面が開きます
2. 「**進行**」タブで、工程1 が終わり、確認待ちになるのを待ちます。確認待ちになると「**確認を開く**」が出ます
3. 「**確認を開く**」を押します（左の「**受信トレイ**」＞「**確認依頼**」から開いても同じです）
4. 「**確認する成果物**」と「**次に実行する Agent**」を確かめ、「**次の工程へ進める**」を押します

進めると、工程3 の Agent が動きます。

**直したいところがあれば、進める前に直せます。** 案件の画面の「**設定・ファイル**」で、成果物を「編集して新しいバージョンにする」と、次の工程に渡すバージョンが編集元だったときは、確認の内容も新しいバージョンに置き換わります（[案件ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/case-guide.md#%E7%A2%BA%E8%AA%8D%E5%BE%85%E3%81%A1%E3%81%A7%E7%9B%B4%E3%81%97%E3%81%A6%E3%81%8B%E3%82%89%E9%80%B2%E3%82%81%E3%82%8B)）。

## Step 8: 結果を見る

1. 案件の画面の「**進行**」で、工程3 が終わったことを確かめます。「**設定・ファイル**」の「**成果物とファイル**」で、Agent の出力を開けます
2. プロジェクトの画面の「**実行履歴**」タブを開き、見たい行の実行日時を選ぶと、その実行の**実行記録**が開きます。「実行情報」の「実行時の設定」の「**実行環境のイメージ**」に、動いたイメージの digest が出ます

**実行記録の結果の「完了」は、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/case-guide.md) — 設定と成果物のバージョン、中断
- [確認ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/review-guide.md) — 外部条件待ち（GitLabのMRのマージで進める）
- [起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md) — 時間トリガーと外部 API で始めるときの注意
