# サイクル

会話で使っている登録 Agent を工程に置き、決めた周期で巡回するのを確かめて、止めるまでの手順です。

## はじめに

サイクルの工程に置くのは、管理者が管理コンソールで登録し、有効にした Agent です（会話で使う Agent と同じもの）。**ワークフローと違い、契約や認定は要りません。** 始める前に、次を確かめてください。

| 確かめること                                               | 理由                                                                                                                                                                                                                                                                |
| ---------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 置きたい登録 Agent が、管理コンソールで有効になっている                      | 有効な Agent だけが一覧に並びます                                                                                                                                                                                                                                              |
| その Agent が、**処理のあとにプロセスを終了する作り**になっている               | 終了しないと、次の巡回がずっと見送られます（[はじめてのエージェント](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/develop/quickstart/quickstart-sdk.md#exit-after-run)）                                                                                                       |
| 秘密の環境変数を持つ Agent なら、管理者が「利用者に上書きさせない環境変数（NG）」を設定している | 利用者が送り先を差し替えられないようにするためです（[設定ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/build/guide/settings-guide.md)）                                                                                                                               |
| 自分が、管理者の機能の許可で「定期実行の作成」を許されている                       | 巡回を有効にするのに要ります（[起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md#%E8%87%AA%E5%8B%95%E3%81%AE%E8%B5%B7%E5%8B%95%E3%82%92%E4%BD%9C%E3%82%8B%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%99%E3%82%8B%E3%81%AB%E3%81%AF)） |

プロジェクトを作ると、サイクルには 2 つの工程が最初から用意されます。このクイックスタートでは、「工程1」に登録 Agent を 1 つ置き、使わない「工程2」は無効にします。**Agent を置いていない有効な工程があると、反映できません。**

**パソコンの画面で、ブラウザーの幅を広くして進めてください。**

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

1. 左の「**プロジェクト**」を開き、上部の「**プロジェクト**」を選んで「**新規プロジェクト**」を押します
2. 「どのように作りますか」で「**自分で作る**」を選び、種別で「**サイクル**」を選びます。**マーケットプレイス版では初めは「ワークフロー」が選ばれているので、切り替えてください**
3. 名前を入れて「**作成**」を押します

作成すると、そのまま**編集画面**が開きます。

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

1. 左の「**編集ツール**」で「**Agent を追加**」を押します。一覧が登録 Agent の一覧に切り替わります
2. 置きたい Agent を選び、右の「Agent の内容」の「**工程に配置する**」で「**1. 工程1**」を押します。「**Agent を配置しました**」と出ます

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

3. 中央の図で「**工程2**」を選び、右の「**工程の設定**」の「**詳細**」を開いて、「**有効**」をオフにします

## Step 3: 環境変数を入れる（必要なときだけ）

この工程で Agent に渡したい値があるときだけ、入れます。

1. 中央の図で、「工程1」に置いた Agent を押します。右の見出しが「**工程の Agent**」になります
2. 「**基本設定**」＞「**環境変数**」で、「**環境変数を追加**」を押して名前と値を入れます。Agent に登録済みの値を変えるときは、その行の「**上書きする**」を押します
3. 入れた値は下書きに入ります。Step 5 で反映すると、プロジェクトに入ります

管理者が変更を禁止した名前と、秘密として登録された名前は変えられません（[エージェントガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md#%E7%92%B0%E5%A2%83%E5%A4%89%E6%95%B0%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB)）。

## Step 4: 巡回の周期を決める

1. 右の「**工程の Agent**」＞「**起動条件**」＞「**巡回の周期**」で、「**巡回を有効にする**」をオンにします。「**周期**」の 15 分ごとになります

**周期を決めていない配置があると、反映できません。**

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

1. 編集画面の上部の「**設定を検証**」を押し、「**設定 OK**」になっていることを確かめて閉じます。「工程2：Agent を配置してください」と出たときは、Step 2 の 3 で工程2 を無効にしたかを確かめてください
2. 「**変更を反映**」を押し、「反映する変更を見直す」で「**反映する**」を押します

## Step 6: 最初の巡回を待つ

1. 「**プロジェクトに戻る**」でプロジェクトの画面に戻ります

**サイクルには「案件を開始」も「今すぐ実行」もありません。** 巡回は周期に合わせて始まります。15 分ごとにしたなら、反映してから 15 分ほどのうちに最初の巡回が始まります。Agent が動き始めるまで、さらに数分かかることがあります。

**前の巡回がまだ動いているあいだは、次の巡回は見送られます。** 1 回の処理に 15 分以上かかる Agent なら、周期を長くしてください。

## Step 7: 結果を見る

1. 「**実行履歴**」タブを開きます。「起動」の列に「**巡回**」と出る行が並びます
2. 見たい行の実行日時を選ぶと、その実行の**実行記録**が開きます

**結果が「実行終了 (完遂は未計測)」なのは正常です。** Agent は正常に終了したが、仕事を果たしたかどうかを Agent が報告していない、という意味です。成功にも失敗にも数えません。何をしたかは、その実行の会話で確かめてください（[記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md#%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB%E3%81%AE%E7%B5%90%E6%9E%9C%E5%AE%9F%E8%A1%8C%E7%B5%82%E4%BA%86-%E5%AE%8C%E9%81%82%E3%81%AF%E6%9C%AA%E8%A8%88%E6%B8%AC)）。

動いている実行を止めたいときは、実行記録の「**停止する**」を押します。

## Step 8: 止める

1. プロジェクトの画面の上部で「**一時停止**」を押し、「プロジェクトを一時停止」で「**一時停止**」を押します

**止めるまで、巡回は 15 分ごとに続きます。** もう一度動かすときは「**再開**」を押します。

## 次に読むもの

- [起動ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/trigger-guide.md#%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB%E3%82%92%E5%9B%9E%E3%81%99) — 巡回の見送りと、Webhook で動かすとき
- [エージェントガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/agent-guide.md#%E3%82%B5%E3%82%A4%E3%82%AF%E3%83%AB%E3%81%A7-agent-%E3%81%AB%E6%B8%A1%E3%82%8B%E3%82%82%E3%81%AE) — サイクルで Agent に渡るもの
- [記録ガイド](https://developers.fd.agenticstar.tm.softbank.jp/docs/marketplace/project/guide/record-guide.md) — 実行記録と指標の読み方
