チャット エージェントの実行をスケジュールする

チャット エージェントを構成して、タスクを定期的に自動実行できます。スケジュールは、エージェントの事前定義された指示またはプロンプトの自動トリガーとして機能します。

実行スケジュールを追加する

アプリ

チャット エージェントの実行スケジュールを追加する手順は次のとおりです。

  1. エージェントを編集モードで開きます。
  2. チャット エージェント ビルダーのキャンバスで、[スケジュール] タブをクリックします。

  3. [+ スケジュールを追加] をクリックして、繰り返しと実行時間を構成します。

    1. 繰り返しの頻度: 指定したプロンプトを実行するためにエージェントを実行する頻度を選択します。次のオプションが用意されています。

      • 毎時: 指定した時間ごとに、その時間内の特定の分にタスクを実行します。
      • 毎日: 指定した時間に 1 日 1 回タスクを実行します。
      • 毎週: 指定した曜日と時間にタスクを週に 1 回実行します。
      • 毎月: 指定した日時にタスクを毎月 1 回実行します。この日がない月は、エージェントはトリガーされません。たとえば、ここに 30 と入力すると、エージェントは 2 月にトリガーされません。
      • 毎年: 指定した月、日、時刻にタスクを 1 年に 1 回実行します。

    2. 実行時間とタイムゾーン: 選択した頻度に基づいて特定の間隔設定を定義し、実行タイムゾーンを選択します。

    3. 実行時間とタイムゾーン: 選択した頻度に基づいて特定の間隔設定を定義し、実行タイムゾーンを選択します。

    4. プロンプト: スケジュールされた時間にエージェントが受け取る具体的なプロンプト（または指示）を入力します。これは、チャット エージェントが実行するタスクを定義します。

  4. [保存] をクリックしてスケジュールを作成し、下書き状態のエージェントに追加します。

  5. 省略可: スケジュールをテストして、想定どおりに機能するかどうかを確認します。

  6. スケジュールを有効にして、更新された変更を適用してチャット エージェントを再起動するには、[更新] をクリックします。

実行スケジュールをテストする

スケジュールを構成したら、次のスケジュールされた間隔を待たずに、チャット エージェントの実行をすぐにテストして、タスクが想定どおりに実行されることを確認できます。

アプリ

実行スケジュールをテストするには、次の操作を行います。

  1. チャット エージェント ビルダーのキャンバスで、[スケジュール] タブをクリックします。

  2. テストするスケジュール カードを見つけて、[プレビューで実行] をクリックします。

    これにより、保存されたプロンプトと構成を使用してチャット エージェントがトリガーされます。

実行スケジュールを編集する

実行スケジュールを編集して、頻度、時刻、タイムゾーン、プロンプトを変更します。

アプリ

既存の実行スケジュールを編集する手順は次のとおりです。

  1. チャット エージェント ビルダーのキャンバスで、[スケジュール] タブをクリックします。
  2. テストするスケジュール カードを見つけて、[編集] をクリックします。
  3. 選択した [繰り返しの頻度]、[実行時間]、[タイムゾーン]、[プロンプト] を変更します。
  4. [保存] をクリックします。
  5. [更新] をクリックして、新しいスケジュールを含むすべての変更が保存され、チャット エージェントに適用されるようにします。

実行スケジュールを削除する

繰り返すタスクが不要になった場合は、[エージェントのスケジュール] リストから削除できます。

アプリ

実行スケジュールを削除するには、次の操作を行います。

  1. チャット エージェント ビルダーのキャンバスで、[スケジュール] タブをクリックします。
  2. テストするスケジュール カードを見つけて、[削除] をクリックします。
  3. 削除を確定して、チャット エージェントの実行スケジュールを完全に削除します。

チャット エージェントのスケジュールを更新する

チャット エージェントのスケジュールは、ユーザーの認証情報を使用して動作します。データのプライバシーとセキュリティを確保するため、これらの認証情報は 14 日ごとに有効期限が切れます。チャット エージェントのスケジュールを手動で更新して、中断なく自動的に実行されるようにする必要があります。

アプリ

すべてのチャット エージェントのスケジュールを更新する手順は次のとおりです。

  1. Gemini Enterprise ウェブアプリを開き、[Agent Gallery] ページに移動します。

  2. 次のいずれかの操作を行って、スケジュールを更新します。

    • [エージェント] セクションに移動し、event_repeat（既存のスケジュールを更新）をクリックします。

    • チャット エージェントを編集モードで開き、次の操作を行います。

      1. チャット エージェント ビルダーのキャンバスで、[スケジュール] タブをクリックします。
      2. [スケジュールを更新] をクリックします。

ユーザー認証情報が更新され、スケジュール設定されたすべてのチャット エージェントがさらに 14 日間実行されます。

スケジュールされた実行を表示して承認する

承認待ちの実行を含む、スケジュールされたすべての実行がチャット履歴に表示されます。

アプリ

スケジュール設定された実行を表示して承認する手順は次のとおりです。

  1. Gemini Enterprise ウェブアプリを開き、ナビゲーション メニューの [チャット] セクションに移動します。
  2. スケジュールされたチャット エージェントに対応する会話スレッドを見つけて開きます。
  3. スケジュールされた実行が一時停止している場合は、提案されたアクションを確認し、[承認] をクリックしてタスクを完了します。

制限事項

  • スケジュールされたチャット エージェントが失敗しないように、スケジュールを 14 日ごとに手動で更新する必要があります。
  • チャット エージェントのスケジュールを実行する際に、最大 5 分の遅延が発生する可能性があります。
  • スケジュールは、マルチリージョン ロケーションでのみサポートされます。

次のステップ