Minds ComfyUIの結果、出力、およびトラブルシューティング

Minds · Audience Preferencesは、リサーチレスポンスと一連のグラフ出力を返します。レスポンスは選択されたAudienceが何を好んだかを理解するのに役立ちます。出力により、その結果を保持しながら選択された元のメディアで後続処理を続行できます。選好度テストが完了したからといって、すべての出力ポートからネイティブ画像や動画が自動的に送信されるわけではありません。

このリファレンスは、カスタムノードパックがインストールされており、サーバーにMINDS_API_KEYが設定されていることを前提としています。ノードが見当たらない場合や最初のテストをまだ実行していない場合は、ComfyUIセットアップガイドから始めてください。グラフでモーションや音声が必要な場合は、ネイティブ動画ガイドを参照してください。

サムネイルとラベルを合わせて確認してください。広告Aはサッカーのキャンペーン画像、広告BはShare a Cokeです。完了した分布ではAが1件、Bが4件なので、ウィジェットには20%と80%が表示されます。結果の詳細画像には説明と最下部の操作列も含まれています。対応するワークフローでは元のB画像がSave Imageに渡されています。この5件のQA回答は表示と選択の整合性を確認するもので、市場推計の妥当性を検証するものではありません。 キャンペーンの出典: Coca-Cola football, Share a Coke.

結果の上にポインターを置き、マウスホイールまたはトラックパッドの2本指操作でスクロールすると、所見と下部の操作ボタンまで表示できます。グラフは動きません。この縦長のドキュメント用画像では結果全体を一度に表示しています。

ウィジェットをリサーチレスポンスとして読み解く

埋め込みウィジェットは、MCPクライアントでも使用されているMindsのレスポンス表示インターフェースを採用しています。完了したレスポンスに応じて、設問、選択されたAudience、カテゴリ分布、分析結果、および利用可能な個々のMindの回答を表示できます。最も高いバーだけを見るのではなく、結果領域内をスクロールしてレスポンス全体を確認してください。

まず設問を確認します。コンテキスト、候補のリファレンス、作成された設問が組み合わされて、保存された選好度調査票が構成されます。Webサイトの導入部分向けの結果は、無音のソーシャルフィードでどのクリエイティブが勝つかという問いに自動的に答えるものではありません。次に、Audienceと選択肢のラベルを確認します。これらが、結果が適用される母集団と選択肢セットを定義します。

分布と合わせて、分析結果と個々の回答を確認してください。これらは調査すべき課題を特定するのに役立ちますが、もっともらしい説明であっても現実世界の行動を証明する独立した証拠にはなりません。より広範な定性調査、アンケート調査、またはMaxDiffなどの定量手法については、連携するStudyワークフローおよび機能ガイドで作業を続けてください。

Mindsは、Minds、Audiences、Studiesを通じて定性調査と定量調査をつなぐ、商用シンセティックリサーチのためのエンドツーエンドプラットフォームです。Minds PRISMは、各Mindの基盤となる推論、インファレンス、ソースモデリング機能を提供します。このアダプターは、その基盤上で焦点を絞ったカテゴリカルな選好度の設問を1つ実行します。

5つの出力ポートを理解する

画像および動画ポートはリスト出力です。ショートリスト、同着結果、または選択セットには複数のアイテムが含まれる場合があります。後続のノードがComfyUIワークフローのネイティブタイプおよびリストの動作に対応していることを確認してください。これらのカスタム出力は汎用文字列ではないため、一致する型を理解できるノードを接続してください。

結果ポートは、特定のモダリティに対応するネイティブメディアが存在しない場合でも役立ちます。たとえば、テキストコンセプトの比較では、画像を生成することなく有効な結果と選択されたコンセプトレコードを生成できます。同様に、ホストされた動画リファレンスは、MIMEタイプがvideo/mp4であってもネイティブのVIDEOオブジェクトにはなりません。

results_jsonに含まれる内容

JSONには、studyId、runId、reviewUrl、question、audiences、creativeFingerprint、interpretationが含まれます。これにより、選好度と保存されたリサーチおよび正確なクリエイティブセットが関連付けられます。意思決定を記録する際はこれらのリファレンスを保持し、どの実行と選択肢に基づいて判断されたかを追跡できるようにしてください。

各Audienceエントリには、audienceId、表示名、ranking、winners、オプションのAPI estimationデータ、およびconfidenceが含まれます。各ランキングアイテムには、label、index、share、rankが含まれます。shareはパーセンテージ文字列ではなく、返された分布合計に対する割合です。80%のシェアは0.8として表現されます。

候補のインデックスは0始まりで、組み立てられたクリエイティブの順序を参照します。winners配列には、同着を含むrank 1のインデックスが含まれます。結果の検査やルーティングを行う際は、ラベルをインデックスおよびフィンガープリントと一緒に使用してください。入力位置自体は、候補が好まれたことの証拠にはなりません。

アダプターは、返されたカテゴリ分布を正規化し、シェアの降順でソートします。confidenceはnullのまま残され、根拠のない信頼区間、有意性スコア、またはコンバージョン予測を算出することはありません。独自の後続自動化を構築する場合は、選好度を測定された効果としてラベル付けし直すのではなく、その違いを維持してください。

Audienceをプール（合算）せずに比較する

選択された各Audienceは、独自の選好度分布とランキングを保持します。Audience Aがあるクリエイティブを好み、Audience Bが別のクリエイティブを好んだ場合、結果にはその両方が記録されます。ノードが架空の重み付けを行ってそれらを1つの母集団に統合することはありません。

選択されたAudienceが1つだけの場合、そのランキングが直接メディア選定を制御できます。複数ある場合は、含まれているAudience IDをselection_audience_idに入力してください。これにより、どの母集団の選好度に基づいて選択クリエイティブ出力を制御するかを指定します。他のAudienceのリサーチ結果が変わることはありません。

そのルーティング指定がない場合でも、ウィジェットとresults_jsonには完了したリサーチが表示されますが、メディアおよび選択クリエイティブのルーティングはブロックされたままになります。これは想定された動作です。まずセグメント間の差異を確認し、制作ワークフローのこの分岐をどのAudienceで制御するかを選択してください。

テスト対象外のAudience IDは拒否されます。表示名はIDの代わりにはなりません。サーバーアカウントからアクセス可能な母集団を確認する必要がある場合は、AudienceガイドおよびオプションのMinds · Find Audiencesヘルパーを参照してください。

top_kと同着（タイ）の解釈

top_kは候補数の中でのショートリストのカットオフを設定します。ノードは、そのカットオフ位置のシェア以上のシェアを持つ候補を含めます。その位置で複数の候補が同着となった場合、出力に含まれるアイテム数がtop_kを超えても、それらすべてが選択された状態を維持します。

ランク付けには、厳密にそれより大きいシェアを持つ候補の数が使用されます。1位で同着となった2つの選択肢は、どちらもrank 1を受け取ります。トップに2つの同着があり、スコアの低い3番目の選択肢がある場合、その3番目の選択肢はrank 3を受け取ります。これにより、データが示していない順序を勝手に補完することなく、実際の同着状態を維持します。

次のステップで単一のファイルを期待している場合は、ワークフロー内でその前提を明示的に処理してください。同着の出力を保持して別のイテレーションを行うか、Minds内で同着を確認することができます。アダプターが同着を解消するために、最初に接続された候補を自動的に選択することはありません。

また、ノードはオリジナル素材を選択する前に、クリエイティブフィンガープリントがランク付けされたバッチと一致しているかを検証します。ラベルやメディア入力を変更することはリサーチ自体の変更であり、単なるグラフの外見上の調整ではありません。変更された素材に対しては新しいテストを開始してください。

ネイティブ出力は元の素材を保持する

ネイティブ画像入力は、アップロード用リサーチコピーとしてPNG形式でエンコードされます。ネイティブ動画は音声を含めてMP4形式でエンコードされます。選択された出力には、アップロードされたエンコーディングやレスポンスウィジェットから抽出されたプレビューではなく、元の接続されたテンソルまたはVIDEOオブジェクトが使用されます。

これにより、グラフは元の作業品質を維持したまま処理を継続できます。保存されるファイルがどのようにエンコードされ命名されるかは、後続のノードによって決定されます。特定の形式や音声の動作が必要な場合は、その設定を確認してください。選好度アダプターは、入力を受け取る前に欠落していた素材を復元することはできません。

混合比較で画像が勝利した場合、selected_imagesは使用可能になりますが、selected_videosには選択されたネイティブ動画が存在しない状態になります。ホストされたレコードが勝利した場合は、選択されたリファレンスを検査してください。どの候補が実際に勝利したかを確認せずに、ネイティブ出力が存在しないことをリサーチレスポンスの失敗と解釈しないでください。

準備、レビュー、実行の各ステージを把握する

初回キュー実行時、ノードは保存されたStudyドラフトを作成または読み込み、レビューダイアログを開きます。承認を待つ間、後続の実行はブロックされます。設問、選択肢、Audience、および言語を検査し、正確なドラフトを承認してから、再度キューを実行して実行を開始します。

レビューをキャンセルした場合、勝者は利用できません。承認しても再度キューを実行しなかった場合、その操作だけではリサーチはトリガーされていません。Review draftボタンは、利用可能なレビューを再度開きます。まだ準備されていないドラフトを表示することはできません。

アダプターは実行前に保存されたドラフトを検証します。設問の変更、添付ファイルの変更、異なるAudience、または新しいリビジョンによって、事前の承認が無効になる場合があります。新しい状態を準備してレビューしてください。レビュー手順を回避するためにワークフロー間で承認値をコピーしないでください。

同じリクエストを再試行するか、新しいテストを開始する

ノードは、認証されたアカウントにスコープされたリクエストIDと永続的なサーバー側レシートを保持します。変更のない再試行では、保存されたStudy、ドラフト、および実行を再利用できます。これは、リサーチがすでに開始された後にネットワークの中断やローカルのポーリング期限が発生した場合に特に便利です。

変更のない再試行を行うには、同じワークフローを再度キューに入れます。素材、ラベル、設問、コンテキスト、Audience、調査言語を同一に保ってください。サーバーの認証情報を別のアカウントのものに置き換えても、最初のアカウントの保存済み作業にはアクセスできません。アダプターは所有権をチェックします。

リサーチの入力が変更された場合はNew testを使用してください。これにより新しいリクエストIDが作成され、ノードの以前の承認およびレスポンス表示がクリアされます。修正されたテストを準備、レビューし、実行してください。これは、プロンプトテキストが変更されていない場合でも、アップストリームの生成ノードが新しい画像や動画を生成した場合にも適用されます。

完全に失敗（Terminal failure）またはキャンセルされた実行は、ポーリングのタイムアウトとは異なります。保存されたStudyを開いて確認してください。完全に失敗した実行を繰り返しキューに入れても、不完全なエビデンスから勝者を選定できるようにはなりません。

入力制限とバリデーション

これらの制限はアダプターの入力を検証するものであり、制限内のすべてのファイルやすべてのアカウントが同じテストを実行できることを保証するものではありません。アカウントのアクセス権、利用枠、Audienceの準備状態、およびリサーチサービスのバリデーションが引き続き適用されます。マニフェストテキストの個別の制限によって、構成された設問の制限を超える設問が許可されることはありません。

停止したステージのトラブルシューティング

認証エラーはドラフトエラーとは異なります。HTTP 401はサーバーキーの問題を示します。HTTP 402または403は、アクセス権またはアカウントの利用枠の問題を示している可能性があります。HTTP 409は、リクエストの変更またはMindsの準備ができていないことを示す場合があります。HTTP 413はアセットサイズの問題を示します。HTTP 429の場合は、新しいStudyを繰り返し作成するのではなく、後で同じリクエストを再試行してください。

パックのサポート窓口は公式イシュートラッカーです。パックとComfyUIのバージョン、失敗したステージ、サニタイズされたエラー情報を提供してください。サーバーキー、プライベートメディア、署名付きURL、編集されていないアカウントデータは公開レポートに含めないでください。

検証済みの内容

公開されているインテグレーションのエビデンスには、ドラフト承認、ライブMinds APIの実行、埋め込みレスポンスのレンダリング、ネイティブ保存を通じた、実際の画像およびネイティブ動画ワークフローが含まれます。動画テストデータは2秒の長さで音声を含んでいました。同じリクエストを繰り返すことで、テストされたワークフロー内で既存の永続実行が再開されました。

これらの検証はComfyUI 0.41.0およびフロントエンド1.55.17を使用し、5つのMindによるQA Audienceで実施されました。これらは長時間の動画の受け入れ、Comfy Cloudでの実行、ネイティブPartner Nodeとしての掲載、リサーチのキャリブレーション、またはキャンペーンのリフト効果を立証するものではありません。自身のクリエイティブに関する意思決定を同僚に説明する際は、この区別を維持してください。

リサーチの設計と解釈については、導入、Minds、Audiences、Studiesを参照してください。インテグレーション概要、ChatGPTセットアップ、Claudeセットアップ、MCP概要では、その他のホストワークフローについて説明しています。ComfyUIクリエイティブ記事では、焦点を絞った選好度の設問を有用な次のクリエイティブイテレーションに活用する方法を紹介しています。