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

# フックでルールを追加する

> フックを使うと、Base44 アプリがデータを保存する前、誰かのサインアップを許可する前、インテグレーションを実行する前、アプリ内エージェントにメッセージを渡す前に、独自のルールを確認できます。

フックはワークフローの一種で、アプリの **ワークフロー** ページで他のワークフローと一緒に表示されます。フックを使うと、レコードの保存や誰かのサインアップなど、アプリが特定のアクションを行う前に何が起きるかを決められます。フックはルールを確認し、アクションを許可またはブロックします。フックを使えば、自分でコードを書かずに、データを正しく保ち、アプリに入れる人を制御し、アプリ内エージェントに適切な情報を渡せます。

> [!WARNING]
>
> **フックを使用するために必要なもの:**
>
> * **ロールアウト:** フックは段階的にロールアウトされているため、まだ表示されない場合があります。
> * **プラン:** フックを使用するには、[Builder プラン](https://base44.com/pricing) 以上が必要です。

![通常のワークフローの上に、有効な Before data is saved フック Require Delivery Address が表示された Workflows ページ](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-in-list.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=0e76770e28c780882b3a38e650d812c3)

Workflows ページのフック

> [card] フックは何に使えますか?
>
> フックで作成できるルールの例:
>
> * **データの変更を保護する:** 承認済みの金額を変更できるのはマネージャーだけにします。また、担当者のいないタスクは誰も完了できないようにします。
> * **参加できる人を制御する:** 会社のメールアドレスを持つ人だけがサインアップできるようにし、参加時に適切なロールを付与します。
> * **インテグレーションの使用を制御する:** AI アクションなどの組み込みインテグレーションを使えるのは、有料メンバーだけにします。
> * **エージェントにコンテキストを渡す:** アプリ内エージェントとの会話の最初のメッセージを確認し、エージェントが返信に使う詳細を追加します。

***

## フックの仕組み

フックは、アプリでアクションが行われる直前に実行されるワークフローの一種です。アプリはフックの回答を待ってから、アクションを続行するか停止します。

* **フックの回答:** すべてのフックは **許可** または **ブロック** を返します。新しい人のロールやアプリ内エージェント用のコンテキストなど、追加の詳細を返すフックもあります。
* **ブロックした場合:** ルールで設定したメッセージが表示されます。設定していない場合は、一般的なメッセージが表示されます。
* **外部の情報:** ほとんどのフックは、社内ディレクトリの確認などのためにバックエンド関数を呼び出せます。**データ保存前** フックは、保存を高速に保つため、条件と計算の確認だけを行えます。
* **コードからの変更:** **データ保存前** フックは、アプリのページからだけでなく、バックエンド関数がデータを変更したときにも実行されます。

> [!WARNING]
>
> フックが失敗したり時間がかかりすぎたりすると、アプリはアクションをブロックします。新しいフックに頼る前に、[ロジックと最初の実行を確認](#checking-a-hook) してください。そうすれば、ルールの誤りでアプリが使えなくなることを防げます。

***

## フックを選ぶ

フックごとに、アプリ内の異なるアクションの前に実行されます。AI チャットにルールを説明すると、AI が適切なフックを選びます。ただし、フックの種類を知っておくと、希望を説明しやすくなります。

| フック | 実行されるタイミング | 失敗または時間がかかりすぎた場合 |
| - | - | - |
| **データ保存前** | レコードが作成または更新されるたび | レコードは保存されません |
| **新規登録前** | 新しい人がサインアップするたび | サインアップがブロックされます |
| **初回アクセスの前** | ログインした人が初めてアプリを開くとき | その人はアプリを開けません |
| **連携機能の使用前** | AI アクションを含む組み込みインテグレーションが使われるたび | リクエストがブロックされます |
| **会話の開始前** | アプリ内エージェントとの各会話の最初のメッセージ | 会話が始まりません |
| **ユーザーの各メッセージの前** | アプリ内エージェントに送信されるすべてのメッセージ | メッセージがエージェントに届きません |

サインアップと初回アクセスのフックでは、その人のロールやその他の詳細も設定できます。会話のフックは、エージェントが会話全体で使う情報を追加します。メッセージのフックは、その返信だけに使う情報を追加します。

> [!NOTE]
>
> 一部のフックは、アプリで必要な場合にのみ表示されます。サインアップと初回アクセスのフックは、アプリでログインが必須の場合にのみ表示されます。会話とメッセージのフックは、アプリに [アプリ内エージェント](https://docs.base44.com/ja/Building-your-app/AI-agents-for-apps.md) がある場合にのみ表示されます。

***

## フックを作成する

フックは、他のワークフローと同じように、AI チャットで希望を説明して作成します。AI がフックを構築し、必要な質問をしてから、**ワークフロー** の一覧に追加します。

### ルールを説明する

ルールをわかりやすい言葉で説明すると、AI が適切なフックを選びます。例:

```text theme={null}
タスクを完了として保存する前に、担当者がいるか確認して。いない場合は保存をブロックして、「このタスクを完了する前に担当者を追加してください。」と表示して。
```

```text theme={null}
@northwind.com のメールアドレスを持つ人だけがサインアップできるようにして。Member ロールを付与して。
```

**AI チャットからフックを作成するには:**

1. アプリエディターに移動します。
2. AI チャットでルールを説明して送信します。
3. AI からの追加の質問に答えます。

### 先にアクションを選ぶ

レコードの保存など、確認したいアクションが決まっている場合は、**ワークフロー** ページから始めます。アクションを選ぶと AI チャットが開き、書きかけのプロンプトが入力されているので、続きを書き足します。

**Workflows ページからフックを作成するには:**

1. アプリエディターに移動します。
2. **ダッシュボード** をクリックします。
3. **ワークフロー** をクリックします。
4. **ワークフローを作成** をクリックします。
5. **開始点を追加** をクリックします。
6. **Hooks** で、**データ保存前** など、確認するアクションを選びます。
7. AI チャットのプロンプトにルールを追加して送信します。
8. AI からの追加の質問に答えます。

![Hooks セクションまでスクロールした Add starting point メニューで、Before data is saved が囲まれている様子](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hooks-menu.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=b610ec9221998e03fa99200f7f8f348c)

開始点としてフックを選ぶ

***

## フックを確認する

フックに頼る前に、意図どおりに動作するか確認します。ロジックを読んだり、実際のデータでテストしたりできます。実行を確認するには、[実行のモニタリング](https://docs.base44.com/ja/Building-your-app/managing-workflows.md#monitoring-runs) を参照してください。フックをオフにしたりアーカイブしたりするには、[ワークフローの管理](https://docs.base44.com/ja/Building-your-app/managing-workflows.md#changing-a-workflow) を参照してください。

### フックのロジックを読む

ワークフローの一覧からフックを開くと、確認するアクションから各条件、結果までが図で表示されます。ステップをクリックすると詳細が表示されます。条件のステップには確認する内容が表示されます。結果のステップには、**許可** または **ブロック** の判定と、表示されるメッセージが表示されます。

![Block order ステップが選択されたフックの図。詳細パネルにメッセージと Blocked の判定が表示されている](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-diagram.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=a3dbe0bc71f2cd8b13909ebd048cfc59)

フックのロジックを読む

### フックをテストする

フックをテストすると、以前の実行のデータに対して、現在のルールでフックがどう応答するかを確認できます。テストするには、フックが少なくとも 1 回実行されている必要があります。テストが始まると、フックの図がテスト実行の状態で開くので、アクションが許可されたかブロックされたかを確認できます。**アクティビティ** タブでは、テスト実行に **テスト** のラベルが付きます。

> [!WARNING]
>
> テストでは、レコードの保存など、フックが保護するアクションは実行されません。ただし、フックが呼び出すバックエンド関数は実行されるため、実際のデータを変更したり外部サービスに連絡したりする可能性があります。

**フックをテストするには:**

1. アプリエディターに移動します。
2. **ダッシュボード** をクリックします。
3. **ワークフロー** をクリックします。
4. フックをクリックして開きます。
5. 詳細パネルで **今すぐ実行** をクリックします。
6. ダイアログで、テストデータとして使う以前の実行を選びます。
7. **テストを実行** をクリックします。

![以前の実行が選択され、Run test ボタンが囲まれた Test hook with previous data ウィンドウ](https://mintcdn.com/base44/4q492Ye6WqsFD8-P/images/apps-workflows-hook-test-dialog.png?fit=max\&auto=format\&n=4q492Ye6WqsFD8-P\&q=85\&s=75872758b2837c1a3513f76eec332907)

以前のデータでフックをテストする

> [!NOTE]
>
> このページは AI によって翻訳されました。最も正確で最新の情報については、[英語版](https://docs.base44.com/index.md) を参照してください。


## Related topics

- [Base44 プロフィールを作成して管理する](https://docs.base44.com/ja/Community-and-support/user-profile.md)
- [ワークスペースに IP 許可リストを追加する](https://docs.base44.com/ja/Enterprise/IP-allowlist.md)
- [データ権限の管理](https://docs.base44.com/ja/Setting-up-your-app/Managing-security-settings.md)
- [Superagent を作成する](https://docs.base44.com/ja/superagents/creating-a-superagent.md)
- [チャネルを接続する](https://docs.base44.com/ja/superagents/connecting-channels.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.