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

# フロー

> ボックスと接続で会話ツリーをデザインしましょう。AIエージェントの会話を導くビジュアルインタラクションフローを作成します。

**フロー**モジュールでは、**会話フロー**をビジュアルに構築できます。会話中にAIエージェントがたどるべき正確なパスを設計するキャンバスだと考えてください。AIの自由な応答のみに頼るのではなく、フローによってインタラクションがステップバイステップでどのように展開するかを細かく制御できます。

フローは以下の場合に使用します：

* **構造化された会話：** 特定のシーケンスを通じてユーザーをガイド（例：オンボーディング、トラブルシューティング、データ収集）。
* **人間エスカレーションパス：** 会話をいつ、どのように人間のエージェントに転送すべきかの明確なルールを定義。
* **API統合：** 会話の特定のポイントで外部サービスを呼び出してデータを取得または送信。
* **Loviツール：** フロー内でLoviの組み込み機能を活用して高度なアクションを実行。

***

## はじめに

フローセクションを初めて開くと、最初のフローを作成するよう招待する空の状態が表示されます。

右上隅の **+ 新しいフロー** ボタン（または中央の **+ 最初のフローを作成** ボタン）をクリックして開始します。

***

## 新しいフローの作成

フローの基本情報を設定するダイアログが表示されます：

| フィールド               | 説明                                      |
| :------------------ | :-------------------------------------- |
| **フロー名** *(必須)*     | フローの説明的な名前（例：`挨拶とポリシー`、`注文追跡`）。         |
| **説明** *(任意)*       | このフローが何をするかの簡単な説明。チームの連携維持に役立ちます。       |
| **AIエージェント** *(必須)* | このフローにリンクされるAIエージェント。ドロップダウンから選択してください。 |
| **フロータイプ**          | 構築の開始方法を選択します。                          |

### フロータイプ

| タイプ            | 説明                                                            |
| :------------- | :------------------------------------------------------------ |
| **カスタム（空）**    | トリガーノードのみでゼロから開始。独自のフローを構築する完全な創造的自由。                         |
| **人間エスカレーション** | AIエージェントから人間のエージェントへの会話の引き継ぎ用に設計されたプリセットテンプレート。サポートワークフローに最適。 |

詳細を入力したら、**フローを作成** をクリックしてフローエディタに入ります。

***

## フローエディタ（キャンバス）

フローを作成すると、**フローエディタ**に移動します。ここはドラッグ＆ドロップのノードと接続を使って会話ツリーを設計するインタラクティブなキャンバスです。

エディタの上部には：

* **フロー名**と**リンクされたAIエージェント**。
* 利用可能なノードタイプのツールバー。
* 変更を保存する**保存**ボタン。

左下には、キャンバスコントロールがあります：**ズームイン**、**ズームアウト**、**画面にフィット**、キャンバスの**ロック/アンロック**。

***

## ノードタイプ

ノードはフローの構成要素です。各ノードは会話のステップを表します。エディタ上部のツールバーからノードを追加し、接続して会話パスを定義します。

### 1. エージェントノード

**エージェントノード**は、AIエージェントが話すまたはアクションを実行するポイントを表します。以下の用途：

* ユーザーにメッセージを送信。
* AIエンジンを使用して情報を処理。
* 会話のコンテキストに基づいて意思決定。

これは最も一般的なノードです。フロー内でAIが仕事をしているところです。

### 2. ユーザーノード

**ユーザーノード**は、システムがユーザーの入力を待つポイントを表します。以下の用途：

* ユーザーからの特定の応答をキャプチャ。
* ユーザーの発言や選択に基づいてフローを分岐。
* データを収集（名前、メール、好みなど）。

会話における「一時停止して聞く」ステップと考えてください。

### 3. APIノード

**APIノード**では、外部サービスをフローに直接統合できます。以下の用途：

* サードパーティシステムからデータを取得（例：注文ステータス、アカウント情報）。
* 外部サービスにデータを送信（例：チケット作成、CRM更新）。
* 会話の特定のポイントでWebhookをトリガー。

フローが外部の世界と接続する方法です。

### 4. Loviツールノード

**Loviツールノード**では、フロー内でLoviの組み込み機能にアクセスできます。以下の用途：

* プラットフォーム固有のアクションを実行（例：会話にタグ付け、部門への割り当て）。
* シンプルなテキスト応答を超えたLoviの高度な機能を使用。
* 会話フローの一部として内部オペレーションを自動化。

***

## フローの構築

会話フローを構築する一般的なワークフローは次のとおりです：

1. **トリガーから開始：** すべてのフローは、フローがいつ開始するかを定義するトリガーノードから始まります。
2. **ノードを追加：** ツールバーからキャンバスにノードをドラッグします。
3. **ノードを接続：** ノード間に接続を描いて会話パスを定義します。あるノードの出力ポートをクリックし、別のノードの入力ポートにドラッグするだけです。
4. **各ノードを設定：** ノードをクリックして設定パネルを開き、何をするか（メッセージ、条件、API呼び出しなど）を定義します。
5. **保存：** **保存**ボタンをクリックしてフローを保存します。

### 効果的なフローのヒント

* **シンプルに保つ：** 最小限のフローから始め、必要に応じて拡張します。過度に複雑なツリーは維持が困難です。
* **頻繁にテスト：** 保存後、リンクされたAIエージェントを通じてフローをテストし、会話が自然に感じられることを確認します。
* **分岐を賢く使う：** ユーザーノードは複数のパスに分岐できます。これを使って異なるユーザーの意図を処理しますが、フローを深くしすぎないようにしましょう。
* **AIと組み合わせる：** フローはAIを置き換えるのではなく、ガイドします。AIエージェントは引き続きニュアンスを処理し、フローは構造を提供します。

***

## ベストプラクティス

* **フローに明確な名前を付ける：** 説明的な名前を使用して、チームが各フローの役割を一目で把握できるようにします。
* **1つのフローに1つの目標：** 1つの巨大なフローを構築するのではなく、異なる目標ごとに別々のフローを作成します（例：オンボーディング用、サポートエスカレーション用）。
* **説明で文書化：** フロー作成時に説明フィールドを使用します。将来の自分（と同僚）が感謝するでしょう。
* **レビューと改善：** フローは生きたドキュメントです。アナリティクスをチェックしてユーザーがどこで離脱するかを確認し、それに応じてパスを改善します。

***

## クイックリファレンス

| アクション     | 方法                      |
| :-------- | :---------------------- |
| 新しいフローを作成 | 右上隅の **+ 新しいフロー** をクリック |
| ノードを追加    | ツールバーのノードタイプボタンをクリック    |
| ノードを接続    | あるノードの出力から別のノードの入力へドラッグ |
| ノードを設定    | キャンバス上のノードをクリック         |
| 変更を保存     | **保存**ボタンをクリック          |
| ズームイン/アウト | キャンバス左下のコントロールを使用       |
| 画面にフィット   | 左下のフィットアイコンをクリック        |