layer-workflows

Layer ワークフロー

概要

ワークフローとは、スタジオが Layer の Blueprint エディターで構築し、公開した複数ステップのパイプラインです。Forge では選択したパラメーターを使って 1 つのモデルを実行しますが、ワークフローでは誰かがすでに設計、テスト、標準化したグラフを実行します。タスクに合ったワークフローがある場合、通常はこちらが適しています。スタジオがすでに下した判断が反映されているためです。

セッション内で初めてワークフローを実行する前に、get_workflow_instructions を呼び出してください。共通の実行ループと支出のしきい値については、layer スキルを参照してください。

ここに記載されている関連スキルが利用可能なスキルにない場合は、ユーザーにインストールを依頼してください（npx skills add layerai/skills --skill <name>）。無人で進める場合は、ツールスキーマを確認して不足している点を明示してください。

まずワークフローを確認する

Forge の実行を複数組み合わせてワークフローを構築する前に、ワークスペース ID と、ユーザーが作成しようとしているものを指定した fulltext フィルターを使って list_workflows を呼び出してください。結果は関連度順に返されます。キャラクターのターンアラウンド用の公開済みパイプラインがあるスタジオは、即席のワークフローを望んでいません。また、即席のワークフローではゲーム内の既存アセットに合いません。

生成ステップが 2 つ以上あるタスクでは、最初に低コストの読み取り専用呼び出しを 1 回行う価値があります。

入力スキーマが仕様です

ワークフローごとに入力が定義されており、list_workflows はワークフローごとに完全な JSON スキーマを返します。ワークフローの名前や説明ではなく、そのスキーマを正としてください。「character sheet」と記載されたワークフローでも、入力がまったく異なる場合があります。

実行を組み立てる前にスキーマを読み、定義どおりの値だけを渡してください。入力タイプには注意が必要なものが 2 つあります。

• ファイル。 先にアップロードして返された file_id を渡すか、以前の実行で生成された file_id を渡してください。スキーマがファイル ID を要求しているときに URL を渡してはいけません。
• スタイル。 スタイル入力には、list_reference_sets の参照セットから取得した set_id を渡します。base_model_id は有効な値ではなく、渡すとワークフローの不具合のように見えるエラーが発生します。

必須入力に適切な値が見当たらない場合は、推測せずユーザーに確認してください。誤った入力でワークフローの実行が完了しても、料金は全額かかります。

見積もり、実行、進捗確認

ワークフロー ID と使用予定の入力を指定して estimate_workflow_price を呼び出すと、実行せずに料金を確認できます。結果は、ワークフローの生成内容、支払いに使われるワークスペース、残高に対する料金を表にして提示してください。20 CU を超える場合は、ユーザーに確認して明示的な承認を待ってください。

execute_workflow は run_id と poll_interval_seconds を返します。get_workflow_run は、ステータスが PENDING、RUNNING、そして SUCCESS、FAILURE、または CANCELLED と遷移する状況を報告し、実行中はステップの情報も返します。

ワークフローは単一の生成より時間がかかるため、黙ってポーリングするのではなく、「完了したステップ数 / 合計ステップ数」として定期的に進捗を報告してください。cancel_workflow_run は実行を停止し、予約済みの Creative Units を解放します。すでに消費されたユニットは返金されません。

実行例

「キャラクターのターンアラウンド用パイプラインを、このコンセプトで実行してください。」

1. fulltext: "turnaround" を指定して list_workflows を呼び出します。ワークフローと入力スキーマが返されます。
2. スキーマを確認します。character_image のファイル ID、整数の view_count、任意のスタイルが必要です。
3. コンセプトは以前の実行で生成されたものなので、すでに file_id があります。アップロードは不要です。
4. これらの入力を指定して estimate_workflow_price を呼び出します。残高 900 に対して 34 CU と返され、しきい値を超えるため、表を提示して明示的な承認を待ちます。
5. session_name を指定して execute_workflow を呼び出し、出力が Layer アプリ内でグループ化されるようにします。
6. poll_interval_seconds ごとに get_workflow_run を呼び出し、進捗に応じて「7 ステップ中 3 ステップ」のように報告します。
7. SUCCESS になったら、出力をリンク付きの表で提示します。各出力には file_id があり、そのまま次の実行に利用できます。

よくある間違い

• まず list_workflows を確認せずに、Forge で複数ステップの手順を即興で組み立てる。
• ワークフローのスキーマを読まず、名前から入力値を推測する。
• 参照セットの set_id を求めるスタイル入力に、base_model_id を渡す。
• スキーマでファイル ID が指定されているところに、URL を渡す。
• 見積もりなしで実行する、または明示的な承認なしに 20 CUs を消費する。
• ステップの進捗を報告せず、長時間の実行を黙ってポーリングする。
• 前回の実行ですでに生成されたアセットを再アップロードする。