ワークフローの接続と全体の仕組みはどうなっていますか？
ワークフローの接続には型があり、ワークフローは、その接続で結ばれたコンポーネントの集合です。接続を通じてコンポーネント間でデータを渡します。コンポーネントには、テキスト、選択項目、認証情報などの設定フィールドがある場合もあります。通常の接続には、少なくとも1つの一致するポート型が必要です。接続だけでは、設定や実行の成功は確認できません。 AI Flowi Workflowをご覧ください。
執筆：Ai Flowi · 技術レビュー： Janice Lee、Ai Flowi テクニカルサポート。
公開日： · 更新日：
ワークフローとは何ですか？具体例で説明します
ワークフローは、型付き接続でコンポーネントを結びます。たとえば、Playgroundのチャットワークフローでは、Chat Inputから互換性のあるAIモデルへ Message を送り、その Message 形式の応答をChat Outputへ送ります。設定フィールドには認証情報などの設定を保持し、接続入力と出力によって、コンポーネント間で渡せるデータ型が決まります。
| 用語 | 確認する内容 |
|---|---|
| コンポーネント | 目的、必要な設定、接続入力、出力。 |
| 設定入力 | 照合するフレーズや認証情報など、入力または選択する値。 |
| 接続入力 | 別のコンポーネントの出力から受け付ける型。 |
| 出力 | 後続のコンポーネントに渡すデータの型。 |
よく使われる宣言済みの型には、 Message、 JSON、 Table、 Data、 LanguageModel、 Toolがあります。通常の型付き接続では、接続元の出力型のうち少なくとも1つが、接続先の入力が受け付ける型と一致している必要があります。 コンポーネントカタログ に、文書に記載されたインターフェースが掲載されています。
接続を確認する
- 接続元のコンポーネントの出力名と、宣言されている型を確認します。
- 接続先のコンポーネントの接続入力と、受け付ける型を確認します。
- 共通する型があれば、ポートを接続します。必要なフィールドと認証情報は別途設定します。
- 小規模なテストを実行し、期待するデータを生成しない最初のコンポーネントを確認します。
たとえば、 初めてのPlaygroundワークフロー では、Chat Inputから互換性のあるモデルへ Message を渡し、次に Message 形式の応答をChat Outputへ渡します。 Webhookのチュートリアル では、Webhookの JSON 出力を、Structured Outputに渡す前に Message へ変換する理由を説明しています。
接続が失敗する場合
まず、出力と入力の正確な型を確認します。ポートは接続できても実行に失敗する場合は、必要な設定と認証情報を確認してから、前のステージを再度テストします。 よくあるエラー には、さらに詳しい確認項目があります。ワークフローのインポートやコンポーネントの更新後は、 ワークフローのライフサイクルガイド に沿って、影響を受ける接続を確認し、再テストしてください。
ショートカットとキャンバスの編集
AI Flowi Workflowでは、設定 → ショートカットを開くと、現在のキー割り当てを確認できます。ショートカットをダブルクリックして、新しい割り当てを登録します。別の操作に割り当て済みのキーの組み合わせは拒否されます。「復元」を使うと、ショートカット一覧を初期設定に戻せます。カスタムのキー割り当ては、このブラウザーに保存されます。
設定したグループ化、コピー、貼り付け、複製、削除のショートカットを使い、キャンバス上で選択したコンポーネントを整理または再利用します。グループ化では選択された接続を確認し、選択が無効な場合はグループを作成せず、その旨を通知します。履歴が利用できる場合は、『元に戻す』『やり直し』で、記録されたキャンバスの状態を切り替えられます。ワークフローがロックされている間、エージェントが作業している間、バージョンプレビュー中は、元に戻す、やり直し、グループ化、貼り付け、複製、削除は実行できません。
Playgroundと添付ファイル
Playgroundには、ワークフローをテストするためのチャット画面があります。単独のPlaygroundページでは、認識される入力または出力を持つ公開ワークフローが必要です。添付コントロールを使って、メッセージにファイルを追加します。添付ファイルはプレビュー表示され、アップロード先のパスがメッセージと一緒に送られます。設定したワークフローで、添付したファイルを処理できるかテストしてください。
保存済みメッセージとセッションごとの範囲
設定 → メッセージを開くと、保存済みメッセージの表が表示されます。セッション別の表示では、セッションでメッセージを絞り込み、ワークフローが指定されている場合は、そのワークフローでも絞り込みます。単独のPlaygroundページ以外では、メッセージのテキストを更新したり、選択したメッセージ行を削除したりできます。単独のPlaygroundページでは、この表でのメッセージの編集と削除は無効です。削除は選択したメッセージIDを対象とし、ワークフローの削除とは別の操作です。