アプリとコンポーネント

アプリとコンポーネントのツールを使うと、アシスタントは、ユーザーが公開したワークフローを利用できます。アプリは、写真の修復やテーマに沿った編集など、シンプルなフォームを備えた公開済みのワークフローです。コンポーネントは、公開済みの構成要素です。アシスタントはアプリやコンポーネントを検索し、その入力を確認して、あなたのクレジットで実行します。

アプリは、斬新な変換、テーマに沿った編集、複数ステップのパイプラインなど、単一の生成ツールでは対応できない多くの依頼をカバーします。アシスタントは、何かができないと答える前に、アプリを検索するべきです。

list_apps

公開済みのアプリを検索します。対象は、公開マーケットプレイスか、自分のアプリです。

権限：apps:read。クレジット：無料。

戻り値：一致するアプリと、そのスラッグです。

get_app_inputs

アプリの入力を返します。アプリのページに表示されるものと同じフォームです。run_app の前に呼び出して、入力のキーを確認します。

権限：apps:read。クレジット：無料。

戻り値：入力ごとに 1 つのエントリーです。各エントリーには、key、label、type（image、video、audio、text、select、number、boolean、list のいずれか）、required かどうか、select の場合は options が含まれます。

run_app

公開済みのアプリを実行します。実行のクレジットは、あなたが支払います。

権限：workflows:execute。クレジット：アプリの中で実行されるノードのクレジットです。

戻り値：実行 ID です。実行の状況は get_app_run で確認します。

inputOverrides では、Webhook 出力（Webhook Output）ノードの URL、公開ノードのアカウント、スクレイパーの取得先など、出力の送り先を設定できません。設定しようとした実行は、400 locked_field で拒否されます。

delete_app_run

アプリの実行をアーカイブに移動します。移動した実行は、app.nodaro.ai/archived-runs で復元するか、完全に削除できます。

権限：workflows:execute。クレジット：無料。

戻り値：処理の確認です。

list_components

公開済みのコンポーネントを検索します。対象は、公開マーケットプレイスか、自分のコンポーネントです。ユーザーがコンポーネントの名前を挙げたときや、既存のコンポーネントに当てはまる複数ステップのパイプラインを求めたときに使います。

権限：workflows:read。クレジット：無料。

戻り値：一致するコンポーネントと、そのスラッグです。

get_component_inputs

コンポーネントの入力を返します。run_component の前に呼び出して、入力のキーを確認します。

権限：workflows:read。クレジット：無料。

戻り値：入力ごとに 1 つのエントリーです。各エントリーには、key、label、type、required かどうかが含まれます。

run_component

公開済みのコンポーネントを実行します。

権限：workflows:execute。クレジット：コンポーネントの中で実行されるノードのクレジットです。

戻り値：ジョブ ID です。ジョブが完了すると、その output_data にコンポーネントの出力が入ります。MCP Apps に対応したクライアントでは、ジョブのカードに出力が縦に並んで表示されます。