ギャラリーとアセット
AI アシスタントから、Nodaro のギャラリーとアップロードを閲覧し、結果をチャットに表示します。ジョブの詳細の読み取り、アプリの実行の追跡、お気に入りの登録もできます。
ギャラリーとアセットのツールを使うと、アシスタントは、あなたが Nodaro ですでに作ったものを探し、表示し、再利用できます。browse_gallery と browse_uploads は、結果とアップロードをグリッドで表示します。get_asset と display_asset は、1 つの結果を取得または表示します。get_app_run はワークフローやアプリの実行を追跡し、list_favorites と favorite_asset はお気に入りを管理します。どのツールもクレジットはかかりません。
browse_gallery
ギャラリーを、操作できるサムネイルのグリッドで表示します。タイルをクリックすると、表示、コピー、次の編集での使用ができます。ユーザーが自分の作品を見たいときに使います。アシスタントがデータだけを必要とする場合は、list_jobs を使います。
権限:assets:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
scope | string | 自分のライブラリなら mine(デフォルト)、ほかのユーザーの最近の公開された結果なら public です。 |
kinds | array | 含めるメディアの種類で、image、video、audio を自由に組み合わせます。デフォルトは ["image", "video"] です。 |
kind | string | 1 つのメディアの種類で、image、video、audio のいずれかです。 |
query | string | プロンプトの中から検索する語で、最大 200 文字です。たとえば rabbit です。すべての語がプロンプトに含まれている必要があります。大文字と小文字は区別されません。 |
limit | integer | 1〜200 です。デフォルトは 50 です。 |
cursor | string | 前のページの next_cursor です。 |
戻り値:MCP Apps を表示できるクライアントではグリッドが表示され、データとしては項目と next_cursor が返されます。
public スコープには、Web の公開ギャラリーに表示されるものが、同じモデレーションで表示されます。そのため、1 ページの項目が limit より少ないことがあります。next_cursor がなくなるまでたどってください。
公開作品を許可しないデプロイ(outputs.allowPublic: false)では、public スコープには何も表示されず、(no items) が返されます。自分のギャラリーは変わりません。
自分のギャラリーには、EDL 適用のレンダーも表示されます。動画のレンダーは video に、オーディオのレンダーは audio に含まれます。プレビューの品質で作ったレンダーには preview: true が付き、テキストの行には (preview) と表示されます。public スコープには、EDL 適用のレンダーは表示されません。
browse_uploads
Nodaro が生成した結果ではなく、あなたがアップロードしたファイルを表示します。以前のアップロードを、新しい生成の入力として選ぶときに使います。グリッドの Use(使用)ボタンを押すと、ファイルの ID がチャットに渡されます。
権限:assets:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
kind | string | image、video、audio のいずれかです。すべてのアップロードを対象にするには、省略します。 |
search | string | ファイル名の中から検索する語で、最大 200 文字です。すべての語がファイル名に含まれている必要があります。大文字と小文字は区別されません。 |
limit | integer | 1〜100 です。デフォルトは 40 です。 |
cursor | string | 前のページの nextCursor です。 |
戻り値:URL と ID 付きのアップロードと、nextCursor です。プレビューの品質で作った EDL 適用のレンダーには preview: true が付き、テキストの行には (preview) と表示されます。 保存されたファイルがなくなったものは、一覧に表示されず、数にも含まれません。
get_asset
1 つの結果の詳細(出力 URL、プロンプト、モデル)を返します。自分のジョブはステータスに関係なく返し、ほかのユーザーのジョブは公開済みで完了したものを返します。公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、自分のジョブだけを返し、ほかのユーザーのジョブは見つからないものとして扱われます。ほかのユーザーの公開ジョブには、失敗についてのプロバイダーの言葉(errorDetail は null)も、そのユーザーの ID も含まれません。失敗したジョブには、retryable、guidance、そしてある場合は suggestedProvider が追加されます。これらについては、ジョブが失敗したときで説明しています。
権限:assets:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
job_id | string | 必須。結果のジョブ ID です。 |
戻り値:input を除いたジョブエンベロープです。
display_asset
1 つの結果をチャットに表示します。ユーザーには、データではなく、画像、動画、オーディオそのものが表示されます。画像には、Animate(動画化)、Edit(編集)、Recreate(再作成)のボタンと全画面表示も付きます。アシスタントが詳細だけを必要とする場合は、get_asset を使います。
権限:assets:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
job_id | string | 必須。ステータスを問わない自分のジョブ、またはほかのユーザーの公開済みで完了したジョブです。 |
公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、display_asset は自分のジョブだけを表示します。ほかのユーザーのジョブは見つからないものとして扱われます。
戻り値:メディアカードです。結果の詳細は、データとして返されます。
get_app_run
ワークフローの実行、または公開されたアプリの実行の進行状況を返します。内容は、実行のステータス、各ノードの状態、それまでに生成されたすべての出力 URL と、それぞれのプロンプト、モデル、ジョブ ID です。ジョブ ID ではなく実行 ID(execution_id)を返す run_workflow、render_final、run_app の後に使います。get_job では実行 ID は見つかりません。実行が pending または running の間は、5〜10 秒ごとに呼び出します。
権限:assets:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
execution_id | string | 必須。実行 ID です。 |
戻り値:実行のステータス、ノードの状態、それまでの出力です。
executionId、status、errorMessageと、total、completed、failed、skipped、skippedForEmptyInputの件数を含むsummaryです。nodeStatesは、ワークフローの順に並んだノードごとのエントリーで、id、label、nodeType、status、error、jobId、text、mediaを含みます。textはノードのテキスト出力で、1,500 文字で切られます。切られた場合はtextTruncated: trueになります。mediaは、ノードが生成したすべての画像、動画、オーディオの URL を、それぞれ{ kind, url }として一覧表示します。skipReason: "empty_input"は、この実行でノードの入力に何も届かなかったことを意味します。outputsは、実行のすべてのメディア URL で、それを作ったジョブのprompt、model、createdAtが付きます。resumeHintは、run_workflowで続けられる失敗した実行(mcp プロジェクト内の保存済みワークフローで、アプリの実行ではないもの)に付きます。その実行を止まった所から続けるrun_workflowの呼び出しです。失敗した実行を続けるを参照してください。失敗したアプリの実行には、代わりにアプリの再試行が付きます。これを見積もるretry_app_runの呼び出しです。これが付くのは実行の現在のワークフロー実行だけなので、再試行や新規の開始のあとは、以前のワークフロー実行には付きません。実行のあとでアプリが変更されている場合、この呼び出しには実行自体のversionが示されます。
実行が完了すると、outcome も含まれます。入力に何も届かなかったためにスキップされたノードが 1 つ以上あり、何も失敗していない場合、outcome は "nothing_new" です。たとえば、新しい投稿が見つからなかったフィードです。それ以外の場合は "succeeded" です。失敗またはキャンセルされた実行には、outcome ではなく status があります。
list_favorites
お気に入りの結果のジョブ ID を、新しい順に一覧表示します。
権限:assets:read。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
limit | integer | 1〜100 です。 |
cursor | string | 前のページのカーソルです。 |
戻り値:お気に入りのジョブ ID です。お気に入りにした自分の EDL 適用のレンダーも表示され、プレビューには preview: true が付きます。ほかの人のレンダーは表示されません。公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、自分のジョブだけが返されます。
favorite_asset
結果をお気に入りに追加するか、お気に入りから削除します。対象は自分のジョブでも、ほかのユーザーの公開ジョブでもかまいません。公開作品を許可していないデプロイメント(outputs.allowPublic: false)では、自分のジョブだけを登録できます。お気に入りの削除は常にできます。お気に入りにしたジョブは、list_jobs に favorited: true を付けると一覧表示できます。
権限:assets:write。クレジット:無料。
| パラメーター | 型 | 説明 |
|---|---|---|
job_id | string | 必須。お気に入りに登録または解除する結果です。 |
favorited | boolean | 必須。true でお気に入りに追加し、false で削除します。 |
戻り値:確認メッセージです。
よくある質問
Claude で Nodaro のギャラリーを見るにはどうすればよいですか?
ギャラリーを見せてほしいと頼みます。browse_gallery が、最近の画像と動画をクリックできるグリッドで表示します。プロンプトを検索することもでき、たとえばウサギが写っている画像をすべて探せます。
browse_gallery と browse_uploads の違いは何ですか?
browse_gallery は、Nodaro があなたのために生成した結果を表示します。browse_uploads は、あなたが自分でアップロードしたファイルを表示するので、その中から新しい生成の入力を選べます。
アシスタントは、公開ギャラリーの結果を使えますか?
はい。get_asset と display_asset は、自分のジョブに加えて、ほかのユーザーの公開済みで完了したジョブも返します。そのため、アシスタントは公開された結果の URL をほかのツールに渡せます。公開作品を許可していないデプロイメントでは、自分のジョブだけを返します。
アシスタントが開始したワークフローの実行を追跡するにはどうすればよいですか?
run_workflow または run_app が返した実行 ID で、get_app_run を呼び出します。実行のステータス、各ノードの状態、それまでに生成されたすべての出力が表示されます。
関連ページ
ジョブ
アップロード
アプリとコンポーネント
アセットとメディア
最終更新