> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/agent-builder/schedule/schedule-setup.md).

# エージェントスケジュールの設定方法

{% hint style="info" %}
本ページでは、エージェントスケジュールを実際に作成する手順を解説します。エージェントスケジュールの用途がまだよくわからない場合は、先に [エージェントスケジュール](/maiagent-user-guide/maiagent-user-guide-ja/agent-builder/schedule.md) をお読みになることをおすすめします。
{% endhint %}

## 前提条件 <a href="#prerequisites" id="prerequisites"></a>

スケジュールを作成する前に、次の点をご確認ください。

1. **Agent モードの AI アシスタントを作成済みであること** — エージェントスケジュールは Agent モードの AI アシスタントのみに対応しており、Agent モード以外のアシスタントはメニューに表示されません
2. **AI アシスタントが少なくとも 1 つの対話プラットフォームに連携されていること** — スケジュール実行時には対話プラットフォームをコンテナとして Agent が動作します
3. **エージェントスケジュールへのアクセス権限があること** — 「エージェントスケジュール」メニューが表示されない場合は、組織管理者に権限設定をご確認ください

## エージェントスケジュールを開く <a href="#navigate-to-schedule" id="navigate-to-schedule"></a>

左側メニューから <mark style="color:blue;">AI 機能</mark> → <mark style="color:blue;">エージェントスケジュール</mark> をクリックします。開くとスケジュール一覧が表示されます。

<figure><img src="/files/dvYfrIksg2v97o2wDpLT" alt="エージェントスケジュール一覧ページ"><figcaption><p>エージェントスケジュール一覧ページ。すべてのスケジュールのステータス、タイプ、配信方法、前回実行時刻が表示されます</p></figcaption></figure>

一覧の各列の説明：

| 列             | 説明                                                     |
| ------------- | ------------------------------------------------------ |
| **名前**        | スケジュールの識別名                                             |
| **AI アシスタント** | このスケジュールが使用する AI アシスタント                                |
| **実行モード**     | コンテキストモードまたは独立モード                                      |
| **スケジュール**    | スケジュールタイプ（Cron、interval、one\_shot）と時刻                  |
| **配信方法**      | 💬 は対話への送信、🔗 は Webhook を表します。`auto` は自動作成された専用対話を示します |
| **前回実行**      | 直近に実行された時刻                                             |
| **ステータス**     | 有効中 / 一時停止中                                            |

## スケジュールの作成 <a href="#create-schedule" id="create-schedule"></a>

### 1. スケジュールの新規作成をクリック <a href="#step-new-schedule" id="step-new-schedule"></a>

右上の <mark style="color:blue;">スケジュールの新規作成</mark> ボタンをクリックしてフォームを開きます。フォームは 4 つのタブに分かれています。**基本情報**、**プロンプト**、**スケジュール設定**、**配信設定** です。

### 2. 基本情報を入力 <a href="#step-basic-info" id="step-basic-info"></a>

<figure><img src="/files/wNCPhlIppsuE4cyTqv4U" alt="基本情報タブ"><figcaption><p>基本情報タブ：AI アシスタントの選択、命名、実行モードと対話プラットフォームの決定を行います</p></figcaption></figure>

| 欄                | 必須 | 説明                                                                                              |
| ---------------- | -- | ----------------------------------------------------------------------------------------------- |
| **AI アシスタント**    | ✅  | 作成済みの AI アシスタントを選択します（Agent モードのアシスタントのみ表示されます）                                                 |
| **名前**           | ✅  | スケジュールの識別名。例：「毎日のカスタマーサポート要約」                                                                   |
| **実行モード**        | ✅  | コンテキストモードまたは独立モードを選択します                                                                         |
| **対話プラットフォーム**   | ✅  | スケジュール実行時の対話プラットフォームコンテナ。コンテキストモードではこれを使って Agent のメモリを蓄積します（バックエンドで使用され、カスタマーサポート対話一覧には表示されません） |
| **結果をコンテキストに保存** | —  | コンテキストモードでのみ表示されます。**次回実行時のメモリにのみ影響します**（結果を閲覧できるかどうかには影響しません。過去すべての回答は実行ログページに保持されます）          |

**実行モードはどう選べばよいですか？**

* **コンテキストモード**：実行をまたいでメモリを保持します。情報を蓄積する必要があるタスクに適しています。例：顧客クレーム対応の進捗を継続的に追跡する、データ変動の傾向を監視するなど。
* **独立モード**：毎回ゼロから開始し、前回のメモリを引き継ぎません。独立した繰り返しタスクに適しています。例：日次レポート、定期集計など。

{% hint style="warning" %}
**AI アシスタント、実行モード、対話プラットフォームの 3 つの欄は、作成後に変更できません。** 変更が必要な場合は、スケジュールを削除してから作り直す必要があります。その他の欄（名前、プロンプト、スケジュール時刻、配信方法）はいつでも編集できます。
{% endhint %}

### 3. プロンプトを作成 <a href="#step-prompt" id="step-prompt"></a>

<figure><img src="/files/l0cyXWYXPsZFmvOKVmRj" alt="プロンプトタブ"><figcaption><p>プロンプトタブ：Agent が毎回の実行で完了すべきタスクを記述します</p></figcaption></figure>

プロンプト欄に、Agent が **毎回の実行で** 行うべき内容を記述します。プロンプトは Agent への指示として渡され、Agent はマウントされたツールやスキルを活用してタスクを完了します。

**プロンプトの例：**

```
過去 24 時間以内のすべての未解決クレーム案件を照会し、
優先度順に並べたうえで、箇条書きの要約にまとめてください。
「高」優先度の案件がある場合は、別途「⚠️ 緊急」と注記してください。
```

プロンプト作成のヒント：

* タスクの目標と出力フォーマットを明確に記述する
* Agent に特定のツールを使わせたい場合は、プロンプトの中で誘導する（例：「データベースの orders テーブルを照会してください」）
* 現在時刻以外の外部状態に依存しないようにし、毎回の実行を独立したタスクとして扱う（コンテキストモードを使用する場合を除く）

### 4. スケジュール時刻を設定 <a href="#step-schedule-config" id="step-schedule-config"></a>

<figure><img src="/files/yEO7dPzmauQq5l18Aqns" alt="スケジュール設定：Cron"><figcaption><p>Cron モード：標準の 5 フィールド Cron 式を使って時刻を正確に設定します</p></figcaption></figure>

スケジュールタイプは 3 種類あります。

{% tabs %}
{% tab title="Cron" %}
標準の 5 フィールド Cron 式で正確な時刻を設定します：`分 時 日 月 曜日`。

| 式             | 意味              |
| ------------- | --------------- |
| `0 9 * * 1-5` | 毎週月曜から金曜の朝 9:00 |
| `0 */2 * * *` | 2 時間ごとの正時に実行    |
| `30 8 * * *`  | 毎日朝 8:30        |
| `0 0 1 * *`   | 毎月 1 日の深夜       |

「タイムゾーン」欄と併せて設定する必要があり、デフォルトは `Asia/Taipei`（台北時間）です。
{% endtab %}

{% tab title="間隔" %}
一定の間隔ごとに 1 回実行します。日／時／分／秒の 4 つの欄を組み合わせて設定します。

<figure><img src="/files/SuxwdoMthm7MeIPIQsTf" alt="スケジュール設定：間隔"><figcaption><p>間隔モード：日、時、分、秒の 4 フィールドの組み合わせ</p></figcaption></figure>

* 間隔は**最低 1 秒**です
* たとえば「30 分ごとに 1 回実行」を設定するには、「分」欄に `30` を入力し、その他の欄に `0` を入力します
* 間隔モードではタイムゾーン欄を使用しません（絶対時刻ではなく相対時刻のため）
  {% endtab %}

{% tab title="1 回のみ実行" %}
指定した時刻に 1 回実行し、その後スケジュールは自動的に終了します。

<figure><img src="/files/XG9oNlnnY1IB1gRbUOPV" alt="スケジュール設定：1 回のみ実行"><figcaption><p>1 回のみ実行：特定の日時を選択し、実行完了後にスケジュールが終了します</p></figcaption></figure>

* 秒単位まで正確な日時を選択します
* 「タイムゾーン」欄と併せて設定する必要があります
* 実行完了後、スケジュールはログ閲覧用に一覧に残りますが、再度実行されることはありません
  {% endtab %}
  {% endtabs %}

**その他の欄：**

| 欄          | 説明                                                        |
| ---------- | --------------------------------------------------------- |
| **有効**     | スケジュールを直ちに起動するかどうか。オフにするとスケジュールは「一時停止中」状態になり、トリガーされません    |
| **最大実行回数** | スケジュールが実行される最大回数を制限します。回数に達すると自動的に一時停止します。空欄の場合は無制限を意味します |

### 5. 配信方法を設定 <a href="#step-delivery" id="step-delivery"></a>

実行完了後の結果をどこへ送るか。このタブで設定します。

<figure><img src="/files/cJxTXwoB2DvD8ibydOHX" alt="配信設定タブ"><figcaption><p>配信設定：複数の対話ターゲットと複数の Webhook URL を設定できます</p></figcaption></figure>

{% hint style="info" %}
本ページで設定するのは、**結果を能動的にどこへプッシュするか**（指定した対話、Webhook 受信先）です。配信ターゲットを 1 つも設定しなくても、毎回の実行の完全な結果は<mark style="color:blue;">実行ログ</mark>ページに保持されます。ただし他の場所へ能動的にプッシュされないだけです。
{% endhint %}

#### 対話 <a href="#delivery-conversation" id="delivery-conversation"></a>

<mark style="color:blue;">対話を追加</mark> をクリックしてメニューから対話を選びます。結果はボットメッセージの形式で送信されます。複数の対話を追加できます。

#### Webhook <a href="#delivery-webhook" id="delivery-webhook"></a>

<mark style="color:blue;">Webhook URL を追加</mark> をクリックすると、結果は POST リクエストとして外部 URL に送信されます（`http://` または `https://` で始まる必要があります）。よく使われる用途：

* Slack / Discord / LINE への連携
* 自社システムへの書き込みによるさらなる処理
* 他の自動化フローのトリガー

{% hint style="warning" %}
配信ターゲットを設定しなくても問題ありません。実行結果は必ず<mark style="color:blue;">実行ログ</mark>ページに残ります。ただし、チームや同僚に結果を受動的に受け取らせたい場合（例：Slack へのプッシュ）は、少なくとも 1 つの対話または Webhook を設定する必要があります。そうしないと誰にも通知されません。
{% endhint %}

### 6. 保存して有効化 <a href="#step-save" id="step-save"></a>

<mark style="color:blue;">確認</mark> をクリックして保存します。「有効」スイッチがオンの状態であれば、スケジュールは設定した時刻に従って直ちにトリガーを開始します。

## 保存後に何が起こりますか？ <a href="#after-save" id="after-save"></a>

スケジュールの保存に成功すると、すぐに次のような変化が表示されます。

1. **モーダルが閉じ、スケジュールが一覧に表示される**
   * ステータスは「有効中」（緑色のタグ）と表示されます。あるいは「一時停止中」（有効スイッチをオフにした場合）と表示されます
   * 「前回実行」欄は空欄で、初回トリガー後に実行時刻へ更新されます
2. **システムがバックグラウンドで 2 つのことを行う**（UI 上の変化は見えませんが、裏側で発生します）
   * スケジュールをバックエンドのスケジューラーに登録し、設定した時刻になると自動的にトリガーされます
   * コンテキストモードの場合はさらに、Agent のメモリを蓄積するためのシステム内部の対話コンテナを 1 つ作成します（このコンテナは<mark style="color:blue;">カスタマーサポート対話</mark>一覧には表示されません）
3. **スケジュールのトリガーを待つ**
   * **Cron / 間隔**：設定した時刻に従って自動実行されます。たとえば Cron `0 9 * * 1-5` は次の月曜から金曜の 9:00 にトリガーされます
   * **1 回のみ実行**：設定したその時点で 1 回実行されます
   * 待ちたくない場合は、一覧の ▶️ <mark style="color:blue;">今すぐ実行</mark> ボタンをクリックすれば、すぐに 1 回トリガーしてテストできます
4. **実行の過程**
   * 一覧のステータスは「有効中」のままで、「前回実行」欄は実行のたびに時刻が更新されます
   * 1 回の実行ごとに<mark style="color:blue;">実行ログ</mark>ページに 1 件の記録が生成されます（Agent の完全な回答を含みます）
   * 「配信設定」で対話や Webhook を追加した場合、結果は同時にそれらのターゲットへも送信されます
   * 詳細な確認方法は、下記の〈[結果はどこへ届きますか？](#where-results-go)〉をご覧ください
5. **タスクの終了時**
   * 「最大実行回数」の上限に達した → 自動的に「一時停止中」に切り替わり、トリガーされなくなります
   * 1 回のみ実行が完了した → スケジュールは一覧に残りますが、再度トリガーされません

## 結果はどこへ届きますか？ <a href="#where-results-go" id="where-results-go"></a>

スケジュールの実行が完了すると、Agent の回答は次の場所に表示されます。**実行ログページが履歴を確認するための主要な入り口です。** どの実行モードであっても、1 回の実行が完了するたびにここに完全な内容が残ります。その他の場所は配信設定によって異なります。

### 1. 実行ログページ（主要な確認入口） <a href="#result-execution-log" id="result-execution-log"></a>

1 回の実行ごとに 1 件の記録が生成されます。これが過去の結果を確認する最も確実な方法です。

**入り方：**

<mark style="color:blue;">エージェントスケジュール</mark>一覧 → 該当スケジュールの行で 🕘 <mark style="color:blue;">実行ログを表示</mark> をクリック → 実行履歴ページへ移動 → ある記録の右側の 👁 <mark style="color:blue;">詳細を表示</mark> をクリック

**表示される内容：**

* 実行ステータス（成功 / 失敗 / 一部成功）
* 開始時刻、完了時刻
* Agent の完全な回答内容（後続の配信が失敗しても、内容はここに保持されます）
* 失敗時のエラーメッセージ

### 2. 指定した対話（配信設定で追加した対話） <a href="#result-target-conversations" id="result-target-conversations"></a>

実行結果は Agent のメッセージとしてこれらの対話に送信され、顧客や同僚が見るメッセージと同じように表示されます。

**見つけ方：**

<mark style="color:blue;">カスタマーサポート対話</mark> → 配信設定で追加したその対話を開く → メッセージは最新の位置にあります。

### 3. Webhook URL（配信設定で追加した URL） <a href="#result-webhooks" id="result-webhooks"></a>

実行結果は HTTP POST で外部 URL に送信されます。**Body は JSON です。**

```json
{
  "content": "Agent が生成した完全な回答内容"
}
```

**技術的な詳細：**

* Content-Type：`application/json`
* タイムアウト：30 秒（Webhook 側は 30 秒以内に 2xx を返す必要があり、そうでなければ失敗とみなされます）
* 失敗は実行ログの「エラーメッセージ」に記録されます（実行ログのステータスは「一部成功」になります）が、リトライは行われません

### 「結果をコンテキストに保存」スイッチにはどのような効果がありますか？ <a href="#save-context-effect" id="save-context-effect"></a>

このスイッチは**コンテキストモードでの次回実行時のメモリにのみ影響し**、結果を閲覧できるかどうかには影響しません。

| 設定            | 次回実行への影響                                                 |
| ------------- | -------------------------------------------------------- |
| **オン**（デフォルト） | 前回のプロンプトと Agent の回答が履歴対話として次回に引き継がれ、Agent はコンテキストを継続できます |
| **オフ**        | 毎回コンテキストモードで実行されますがメッセージは残さず、効果は独立モードに近くなります             |

スイッチの状態にかかわらず、**実行ログページには毎回の完全な回答が保持されます。** このスイッチは履歴の確認には影響しません。

### 要約：結果の可視性対照表 <a href="#result-summary" id="result-summary"></a>

| 実行モード / 設定                      | 実行ログページ | 指定した対話   | Webhook  | Agent の実行間メモリ |
| ------------------------------- | ------- | -------- | -------- | ------------- |
| コンテキストモード + 結果をコンテキストに保存（デフォルト） | ✅       | ✅ 設定した場合 | ✅ 設定した場合 | ✅ メモリあり       |
| コンテキストモード + 結果を保存しない            | ✅       | ✅ 設定した場合 | ✅ 設定した場合 | ❌ メモリなし       |
| 独立モード                           | ✅       | ✅ 設定した場合 | ✅ 設定した場合 | ❌ メモリなし       |

{% hint style="info" %}
**なぜ「専用対話」への入り口がないのですか？** コンテキストモードはメモリを蓄積するためにバックエンドで専用対話を作成しますが、この対話は**現在**<mark style="color:blue;">**カスタマーサポート対話**</mark>**一覧には表示されません**。これはシステム内部で使用するコンテナであり、人間のカスタマーサポートが対応する対話ではありません。過去の結果を確認するには<mark style="color:blue;">実行ログ</mark>をご利用ください。
{% endhint %}

## 完全な例：毎日のカスタマーサポート要約 <a href="#example-daily-summary" id="example-daily-summary"></a>

以下は、毎朝 9:00 に前日のカスタマーサポートの要約を自動的に集約し、その結果を Slack へ送信するスケジュールの作成方法を示す、エンドツーエンドの例です。

### シナリオ <a href="#example-scenario" id="example-scenario"></a>

毎朝の出勤前に、AI アシスタントに前日のすべての未解決クレームを集約させ、要約にまとめてチームの Slack #customer-support チャンネルへ送信し、カスタマーサポート責任者が Slack を開いた瞬間に確認できるようにしたい、というケースです。

### 事前準備 <a href="#example-prerequisites" id="example-prerequisites"></a>

* クレームデータを照会できるツール（例：データベースツールやカスタマーサポートシステムの API ツール）をマウントした、Agent モードの AI アシスタント
* 連携済みの対話プラットフォーム 1 つ（スケジュール実行のコンテナとして使用）
* Slack の incoming webhook URL 1 つ（結果の受信に使用）

### 設定内容 <a href="#example-config" id="example-config"></a>

**基本情報：**

| 欄          | 入力内容                       |
| ---------- | -------------------------- |
| AI アシスタント  | `カスタマーサポート AI 責任者`         |
| 名前         | `毎日のクレーム要約 - 9:00`         |
| 実行モード      | 独立モード（毎日独立して集約し、前日のメモリは不要） |
| 対話プラットフォーム | `社内カスタマーサポート`              |

**プロンプト：**

```
過去 24 時間以内（本日の深夜を終点とする）に、
ステータスが「未解決」または「処理中」のすべてのクレーム案件を照会し、
優先度順（高 → 中 → 低）に並べて要約にまとめてください：

## フォーマット
### 🔴 高優先度（X 件）
- [#案件番号] 顧客名 — 一文で説明

### 🟡 中優先度（X 件）
...

### 🟢 低優先度（X 件）
...

最後に総括の一文を追加：「合計 X 件が対応待ち、うち高優先度 X 件は本日対応が必要」。
```

**スケジュール設定：**

* スケジュールタイプ：`Cron`
* Cron 式：`0 9 * * 1-5`（月曜から金曜の朝 9:00）
* タイムゾーン：`Asia/Taipei`
* 有効：オン
* 最大実行回数：空欄（継続実行）

**配信設定：**

* 対話：追加の対話は加えない（実行ログページにもともと Agent の完全な出力が保持されるため、わざわざカスタマーサポート対話へ送ってスペースを取る必要はない）
* Webhook URL：`https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXX`

### 保存後 <a href="#example-after-save" id="example-after-save"></a>

1. **月曜の朝 9:00（初回トリガー）**：スケジュールが自動的にトリガーされ、Agent が照会と集約を開始します
2. **約 30 秒以内（Agent の処理速度による）**：
   * チームの Slack #customer-support チャンネルが Webhook でプッシュされた要約メッセージを受信します（POST body は `{"content": "..."}`）
   * スケジュール一覧の「前回実行」が `2026-04-20 09:00:12` に更新されます
3. **Agent が何を生成したか後から確認したい場合は？** 2 つの場所があります：
   * **実行ログページ**（主要な入り口）：<mark style="color:blue;">エージェントスケジュール</mark> → 該当スケジュールの 🕘 をクリック → 👁 をクリック → 完全なボット回答と token 使用量を確認
   * **Slack**：直接 #customer-support チャンネルへ（これはあなたが設定した Webhook 受信先です）
4. **火曜、水曜… と継続実行**：毎営業日の朝 9:00 に自動的にトリガーされ、以降は人手による介入は不要です

### 問題があった場合はどう切り分けますか？ <a href="#example-troubleshooting" id="example-troubleshooting"></a>

* **Slack にメッセージが届かない** → まず実行ログページでその実行のステータスを確認します。「失敗」であればエラーメッセージを確認します。「成功」なのに Slack に届かない場合は、Webhook URL が正しいか、Slack 側に rate limit がないかを確認します
* **要約内容が想定どおりでない** → 実行ログの詳細で Agent の実際の出力を確認し、プロンプトを調整し直します
* **スケジュールがトリガーされない** → 本ページ下部の「よくある質問」を参照してください

## 既存スケジュールの管理 <a href="#manage-schedules" id="manage-schedules"></a>

スケジュール一覧に戻ると、各行の右側の操作エリアに次の機能があります。

| アイコン   | 機能             | 説明                                             |
| ------ | -------------- | ---------------------------------------------- |
| ✏️     | **編集**         | スケジュールの内容を変更します（AI アシスタント、実行モード、対話プラットフォームを除く） |
| 🕘     | **実行ログを表示**    | 該当スケジュールの過去の実行ログページへ移動します                      |
| ▶️     | **今すぐ実行**      | スケジュール時刻を待たず、すぐに 1 回実行をトリガーします                 |
| ⏸️ / ⏻ | **一時停止 / 有効化** | スケジュールの有効状態を切り替えます                             |
| 🗑     | **削除**         | スケジュールを削除します。削除すると実行ログも併せて消去されます               |

### 今すぐ実行 <a href="#run-now" id="run-now"></a>

「今すぐ実行」は、スケジュールが正しく設定されているかをテストする最も速い方法です。押すと：

1. システムが直ちに 1 回実行をトリガーし、本来のスケジュール時刻には影響しません
2. 画面に「スケジュールをトリガーしました」という通知が表示されます
3. 「実行ログを表示」で実行結果を確認できます

### 一時停止と有効化 <a href="#pause-resume" id="pause-resume"></a>

一時停止後はスケジュールがトリガーされなくなりますが、設定と実行ログは保持されます。いつでも再度有効化できます。

## 実行ログの確認 <a href="#view-executions" id="view-executions"></a>

一覧で 🕘 アイコンをクリックして実行ログページに入ります。

<figure><img src="/files/cmr2W8I4n87aroqgzSYF" alt="実行ログ一覧"><figcaption><p>実行ログページ：ステータスや日付範囲で絞り込み、各実行の結果を確認できます</p></figcaption></figure>

### 絞り込み <a href="#filter-executions" id="filter-executions"></a>

* **ステータス**：待機中 / 実行中 / 成功 / 失敗
* **日付範囲**：開始日と終了日を指定

### 各列の説明 <a href="#execution-fields" id="execution-fields"></a>

| 列            | 説明                               |
| ------------ | -------------------------------- |
| **ステータス**    | 待機中（キュー待ち）、実行中、成功、失敗             |
| **開始時刻**     | Agent が実行を開始した時刻                 |
| **完了時刻**     | 実行が終了した時刻                        |
| **エラーメッセージ** | 実行が失敗した場合、エラーの原因を表示します           |
| **ボット回答**    | Agent が生成した応答内容（完全な内容は詳細で確認できます） |

### 実行詳細の確認 <a href="#execution-detail" id="execution-detail"></a>

各行の右側の 👁 アイコンをクリックすると詳細ダイアログが開き、完全なボット回答とエラーメッセージを確認できます。

<figure><img src="/files/AEFKsHslhrGOfMh929Wz" alt="実行詳細"><figcaption><p>実行詳細：ステータス、開始/完了時刻、完全なボット回答とエラーメッセージ</p></figcaption></figure>

## よくある質問 <a href="#faq" id="faq"></a>

<details>

<summary>スケジュールがトリガーされないのはなぜですか？</summary>

考えられる原因：

1. スケジュールのステータスが「一時停止中」になっている — 一覧のステータス列を確認してください
2. 「最大実行回数」の上限に達している — 自動的に一時停止します
3. Cron 式またはタイムゾーンの設定が誤っている — 編集ページで確認してください
4. 1 回のみ実行モードが既に実行済み — 1 回のみ実行は一度しかトリガーされません

まず「今すぐ実行」でテストし、スケジュール自体が正しく実行できることを確認してから、時刻設定を切り分けることをおすすめします。

</details>

<details>

<summary>自分の AI アシスタントが選べないのはなぜですか？</summary>

エージェントスケジュールは **Agent モードのみに対応** する AI アシスタントです。お使いのアシスタントが Chatbot モードやその他のモードの場合、メニューに表示されません。AI アシスタント設定ページでモードを確認してから、スケジュールを作成してください。

</details>

<details>

<summary>スケジュールの実行後、Agent が何を生成したかはどこで確認できますか？</summary>

主要な入り口は<mark style="color:blue;">エージェントスケジュール</mark> → 該当スケジュールの 🕘 <mark style="color:blue;">実行ログを表示</mark> をクリック → ある記録の 👁 をクリックです。詳細に Agent の完全な回答が表示されます。

配信ターゲット（対話 / Webhook）を設定している場合は、そちらにも 1 部送信されます。

* 指定した対話：その対話に直接入ってメッセージを確認
* Webhook：あなたの外部受信先で POST body を確認

</details>

<details>

<summary>「結果をコンテキストに保存」をオンにした後、その対話はどこで確認できますか？</summary>

**このスイッチは結果を閲覧できるかどうかには影響しません。** 過去すべての回答は常に実行ログページに保持されます。

これは「Agent が次回実行時に前回の出来事を覚えているかどうか」だけに影響します。

* オン（デフォルト）：Agent はバックエンドで同じ対話コンテナを使ってメモリを蓄積し、次回実行時にコンテキストを継続できます
* オフ：毎回メッセージを残さず、効果は独立モードに似ています

このバックエンドの対話コンテナは現在<mark style="color:blue;">カスタマーサポート対話</mark>一覧には表示されません。システム内部で使用するものであり、人間のカスタマーサポートが対応するものではありません。

</details>

<details>

<summary>Webhook が受信するデータのフォーマットは何ですか？</summary>

POST リクエストで、Content-Type は `application/json`、body の構造は次のとおりです。

```json
{
  "content": "Agent が生成した完全な回答内容（プレーンテキスト）"
}
```

タイムアウトは 30 秒で、リトライは行いません。Webhook 側は 30 秒以内に 2xx ステータスコードを返す必要があり、そうでなければその配信は失敗として記録されます（ただし実行ログページには Agent の完全な回答が保持されます）。

</details>

<details>

<summary>独立モードとコンテキストモードの違いは結局どこにありますか？</summary>

両者の最大の違いは、**Agent が実行時に前回の対話履歴を見られるかどうか** です。

* **コンテキストモード**：同じバックエンド対話を使ってメッセージを蓄積します。Agent は次回実行時に過去のプロンプトと回答を参照でき、判断を継続できます（傾向の追跡、重複の回避、コンテキストの蓄積が必要なタスクに適しています）
* **独立モード**：毎回一時的な対話を作成し、実行後すぐに削除します。Agent は毎回ゼロから開始し、以前に何があったかを知りません（日次レポートのように毎日独立して出力するタスクに適しています）

両モードの実行結果は**いずれも実行ログページに保存されます**。違いは「履歴を確認できるかどうか」ではなく、「Agent が作業時にメモリを持つかどうか」にあります。

</details>

## 関連記事 <a href="#related" id="related"></a>

* [エージェントスケジュール](/maiagent-user-guide/maiagent-user-guide-ja/agent-builder/schedule.md) — エージェントスケジュールの概念紹介
* [Agent（AI アシスタント）](/maiagent-user-guide/maiagent-user-guide-ja/agent-builder/agent.md) — Agent モードの AI アシスタントの作成
* [対話プラットフォームの連携：ウェブサイト](/maiagent-user-guide/maiagent-user-guide-ja/conversations/web-chat/website.md) — 対話プラットフォームの設定（ウェブサイトを例に）


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-ja/agent-builder/schedule/schedule-setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
