カスタムコンポーネントはどのように動作しますか？
カスタムコンポーネントは、ドキュメントに記載されたコンポーネントでは対応できない要件に対して、Pythonによる処理を定義します。構成する5つの要素は、型を指定した入力、出力とメソッド、フィールド、ツールモード、実行時の処理です。カタログのCustom Componentテンプレートから始めてください。このテンプレートから作成したコンポーネントが、自動的に組み込みコンポーネントになるわけではありません。更新日：2026年10月9日。
執筆：Ai Flowi · 技術レビュー：Janice Lee、Ai Flowiのテクニカルサポート。
公開日 · 更新日
定義できる内容
定義できるのは5つの要素です。ワークフローの値を受け取る型付きの入力、名前付きの出力と結果を生成するメソッド、設定用のフィールド、ツールモードに適した動作、実行時のエラー処理です。フィールドは動的にしたり、条件に応じて表示したりできます。まず既存のカタログ項目を確認し、その後、自分のコンポーネントの出力型と、次のコンポーネントが受け付ける入力型を比較してください。
| 要素 | 目的 |
|---|---|
| 入力 | 宣言した型でワークフローから値を受け取ります。 |
| 出力とメソッド | 名前付きの出力と、各結果を生成するメソッドを通じて値を返します。 |
| フィールド | 動的なフィールドや条件に応じたフィールドを含め、設定値を表示します。 |
| ツールモード | ツールとしての利用に適した処理を提供します。 |
| 実行時の処理 | コンポーネントのコード内でエラーに対処します。 |
カタログには、ドキュメントに記載されたほかのコンポーネントとともに、Custom Componentテンプレートが掲載されています。まず既存の項目を確認してください。記載されているWebhookやAPIのコンポーネントで同じ処理を表現できるなら、その設定だけで十分かもしれません。コンポーネントを作成する場合は、接続する前に、その出力型と次のコンポーネントが受け付ける入力型を比較してください。AI Flowi Workflowを参照してください。設定からPythonへ切り替えるタイミングを判断するには、コンポーネントを書く前にローコードとノーコードのアプローチを比較してください。