> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# コアトリガー

> 手動実行、スケジュール実行、HTTPリクエスト、ファイルアップロード用の汎用トリガーです。

コアトリガーは、最も一般的なワークフローのエントリポイントをカバーします。手動呼び出し、スケジュール実行、受信HTTPリクエスト、ファイルアップロードです。

## 手動インプット

ユーザーまたは外部システムが明示的に呼び出した場合にワークフローを開始します。ワークフロー実行前に必須となるカスタムインプットフィールドを設定できます。リクエストの送信、レポートの開始、Odinチャットインターフェースからのプロセスの起動など、ユーザーコンテキストが必要なオンデマンドタスクに最適です。

**使用場面**

* Odin UIまたはAPIからオンデマンドでワークフローを実行したい場合。
* ワークフローが実行される前に、ユーザー提供のインプットが必要な場合。
* 特定の値でワークフローをテストまたはデバッグしている場合。

**設定**

| フィールド      | タイプ | 説明                                                                     |
| ---------- | --- | ---------------------------------------------------------------------- |
| インプットフィールド | Any | トリガー設定で構成されたユーザー定義パラメータ。各フィールドには名前、タイプ、ランタイム時にユーザーに表示されるオプションの説明があります。 |

**出力変数**

| 変数                       | 説明                                                                                  |
| ------------------------ | ----------------------------------------------------------------------------------- |
| `trigger.user_input`     | ユーザーが送信した生のテキスト。                                                                    |
| `trigger.inputs.<field>` | 各名前付きインプットフィールドの値。`<field>`を設定したフィールド名に置き換えてください（例：`trigger.inputs.customer_name`）。 |
| `trigger.chat_id`        | 実行を開始したチャットセッションのID。                                                                |
| `trigger.message_id`     | ワークフローをトリガーしたメッセージのID。                                                              |

```text 例：インプットフィールドの参照 theme={null}
Hello {{ trigger.inputs.customer_name }}, your request has been received.
```

<AccordionGroup>
  <Accordion title="メモ">
    * インプットフィールドは、ワークフロー開始前にフォームとしてユーザーに提示されます。フィールド名は簡潔で分かりやすいものにしてください。
    * カスタムインプットフィールドが設定されていない場合でも、`trigger.user_input`は利用可能です。
    * このトリガーをプログラムから呼び出すには、ワークフローIDと必須のインプット値を使用してOdin APIを呼び出してください。
  </Accordion>
</AccordionGroup>

## Webhook

ワークフローに固有のHTTPエンドポイントを公開します。サードパーティアプリケーション、オートメーションプラットフォーム、カスタムスクリプトなどの外部システムは、そのURLにHTTPリクエストを送信してワークフローを起動できます。リクエストボディ、ヘッダー、クエリパラメータ、HTTPメソッドはすべて、ダウンストリームノードに渡されます。

**使用場面**

* 外部システムが発生したイベントをOdinに通知する必要がある場合（例：フォーム送信、決済イベント、他のプラットフォームからの更新）。
* Automation AnywhereやHTTPエンドポイントを呼び出せる他のシステムとOdinを統合している場合。
* 開発者やツールが呼び出せるAPIエンドポイントとしてワークフローを公開したい場合。

**設定**

| 設定              | タイプ    | 説明                                                                                     |
| --------------- | ------ | -------------------------------------------------------------------------------------- |
| `http_method`   | String | エンドポイントが受け付けるHTTPメソッド：`GET`、`POST`、`PUT`、`PATCH`、`DELETE`。                             |
| `auth_type`     | String | 受信リクエストの認証方法：`none`、`basic`、`header`。                                                  |
| `response_mode` | String | `onReceived`はリクエストが到着した時点で即座にHTTP 200を返します。`lastNode`はワークフローの完了を待ち、最終出力をHTTP応答として返します。 |

**出力変数**

| 変数                    | 説明                                                |
| --------------------- | ------------------------------------------------- |
| `trigger.body`        | 受信リクエストのJSONボディ。                                  |
| `trigger.headers`     | リクエストに送信されたHTTPヘッダー。                              |
| `trigger.query`       | リクエストのURLクエリパラメータ。                                |
| `trigger.method`      | 呼び出し元が使用したHTTPメソッド。                               |
| `trigger.webhook_url` | Webhookエンドポイントの完全なURL。ワークフローを呼び出す外部システムと共有してください。 |

**応答モード**

| モード          | 動作                                                                              |
| ------------ | ------------------------------------------------------------------------------- |
| `onReceived` | リクエストが到着した時点で、ワークフローが完了する前に即座にHTTP `200 OK`を返します。 FIRE AND FORGETシナリオに使用してください。 |
| `lastNode`   | ワークフローが完了するまでHTTP接続を保持し、最終ノードの出力を応答ボディとして返します。 呼び出し元が同期ペイロードを期待する場合に使用してください。   |

<AccordionGroup>
  <Accordion title="メモ">
    * `header`認証を使用する場合は、トリガー設定で期待されるヘッダー名と値を設定してください。
    * `trigger.webhook_url`は、統合パートナーに送信するセットアップドキュメントにエンドポイントURLを含める際に便利です。
    * Automation AnywhereからこのWebhookを呼び出す場合は、ボット内の**HTTP Task**アクションを使用してWebhook URLにPOSTしてください。
  </Accordion>
</AccordionGroup>

## スケジュール

cron式で定義された繰り返しスケジュールに基づいて、ワークフローを自動的に発火します。日次レポート、定期的なデータ同期、繰り返し通知など、手動介入なしにタイムベースのタスクを自動化できます。

**使用場面**

* ワークフローを毎日、毎週、毎月の決まった時間に実行する必要がある場合。
* 繰り返しのビジネスプロセスを自動化している場合（例：毎朝データの取得、週次概要の送信）。
* 定期的に外部システムをポーリングしたい場合。

**設定**

| 設定         | タイプ    | 説明                                                             |
| ---------- | ------ | -------------------------------------------------------------- |
| `schedule` | String | ワークフローの実行タイミングを定義するcron式。                                      |
| `timezone` | String | cron式が評価されるタイムゾーン。`UTC`や`America/New_York`などの標準タイムゾーン名を受け付けます。 |

<Warning>
  常に`timezone`フィールドを明示的に設定してください。設定しない場合、スケジュールはUTCで実行され、リージョン固有のワークフローで予期しないタイミングが発生する可能性があります。
</Warning>

**cron式リファレンス**

cron式は5つのフィールドで構成されます：**分 · 時 · 日 · 月 · 曜日**

```text theme={null}
┌───── 分 (0–59)
│ ┌───── 時 (0–23)
│ │ ┌───── 日 (1–31)
│ │ │ ┌───── 月 (1–12)
│ │ │ │ ┌───── 曜日 (0–6, 日曜 = 0)
│ │ │ │ │
* * * * *
```

| 式              | スケジュール    |
| -------------- | --------- |
| `0 9 * * *`    | 毎日午前9時    |
| `0 9 * * 1`    | 毎週月曜日午前9時 |
| `0 */6 * * *`  | 6時間ごと     |
| `0 8 1 * *`    | 毎月1日午前8時  |
| `*/15 * * * *` | 15分ごと     |

**出力変数**

| 変数                            | 説明                          |
| ----------------------------- | --------------------------- |
| `trigger.trigger_time`        | スケジュールが発火したISO 8601タイムスタンプ。 |
| `trigger.schedule_expression` | この実行に使用されたcron式。            |
| `trigger.trigger_type`        | 常に`"schedule"`。             |

<AccordionGroup>
  <Accordion title="メモ">
    * スケジュールトリガーはユーザーインプットを渡しません。ワークフローに動的データが必要な場合は、APIノードやツールキットツールを使用してワークフロー内で取得してください。
    * スケジュール実行が発生した時刻を記録したり、ログに記録したりするには、ダウンストリームノードで`trigger.trigger_time`を使用してください。
  </Accordion>
</AccordionGroup>

## ファイルアップロード

1つ以上のファイルがアップロードされた場合にワークフローを開始します。各ファイルのコンテンツ、名前、サイズ、MIMEタイプをダウンストリームノードに提供します。アップロードされたレポートのパース、スプレッドシートからのデータ抽出、分析のためにAIモデルへのファイルルーティングなど、ドキュメント処理ワークフローに最適です。

**使用場面**

* ユーザーにワークフローで処理させるファイルを提出してほしい場合（例：請求書、契約書、CSVエクスポート）。
* アップロードされたドキュメントからコンテンツを抽出し、LLMやデータ処理ノードに渡す必要がある場合。
* マルチファイル取り込みパイプラインを構築している場合。

**設定**

このトリガーには必須の設定フィールドはありません。ワークフローに関連付けられたチャットまたはインターフェースにファイルがアップロードされると自動的に有効になります。

**出力変数**

<Tabs>
  <Tab title="単一ファイル">
    | 変数                     | 説明                                       |
    | ---------------------- | ---------------------------------------- |
    | `trigger.file.content` | アップロードされたファイルの完全な抽出テキストコンテンツ。            |
    | `trigger.file.name`    | 元のファイル名。                                 |
    | `trigger.file.size`    | ファイルサイズ（バイト単位）。                          |
    | `trigger.file.type`    | MIMEタイプ（例：`application/pdf`、`text/csv`）。 |
    | `trigger.file_count`   | アップロードされたファイルの合計数。単一ファイルの場合は`1`を返します。    |
  </Tab>

  <Tab title="複数ファイル">
    | 変数                   | 説明                                                                |
    | -------------------- | ----------------------------------------------------------------- |
    | `trigger.files`      | アップロードされたすべてのファイルの配列。各アイテムには`content`、`name`、`size`、`type`が含まれます。 |
    | `trigger.file_count` | アップロードされたファイルの合計数。                                                |

    1回の実行で複数のアップロードを処理する場合は、**ループ**ノードを使用して`trigger.files`を反復処理してください。
  </Tab>
</Tabs>

<Note>
  ファイルコンテンツはプレーンテキストとして抽出されます。PDFやWordドキュメントなどのバイナリ形式は自動的にパースされます。抽出されたテキストは`trigger.file.content`に表示されます。
</Note>

<AccordionGroup>
  <Accordion title="メモ">
    * `trigger.file`は常に最初の（または唯一の）アップロードされたファイルを参照します。マルチファイルワークフローの場合は、ループノードで`trigger.files`を使用してください。
    * 条件分岐ノードで`trigger.file.type`を使用して、異なるファイルタイプを異なる処理ブランチにルーティングしてください。
  </Accordion>
</AccordionGroup>
