# ユーティリティ、レシピ、スキル

> ping で接続を確認し、get_recipe で検証済みのレシピを読み込み、Film Director のスキルを開始します。ビルダーツールでは、Web サイトを紹介する UGC 動画を準備できます。

Source: https://nodaro.ai/ja/docs/mcp/tools/utility

**ユーティリティ、レシピ、スキルのツール**は、アシスタントがうまく作業を始められるようにします。`ping` は接続を確認し、`get_recipe` は検証済みの複数ステップのプレイブックを読み込み、`start_film_director` は Film Director のスキルを読み込みます。3 つの UGC ビルダーは、Web サイトについてクリエイターが話す動画を準備します。どのツールもメディアを生成せず、クレジットも消費しません。

指示を返すほかのツールは、それぞれのグループのページで説明しています。[`start_workflow_editor` と `get_node_skill`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#start_workflow_editor)、[`start_video_director`](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director#start_video_director)、[`get_studio_production_skill`](https://nodaro.ai/docs/mcp/tools/studio-productions#get_studio_production_skill)、[`get_recast_authoring_skill`](https://nodaro.ai/docs/mcp/tools/recast#get_recast_authoring_skill) です。

## `ping`
`pong`、あなたの Nodaro ユーザー ID、呼び出したクライアントの名前を返します。コネクタが動作しているかを確認するときに使います。

**権限**：なし（常に表示されます）。**クレジット**：無料。

このツールにはパラメーターがありません。

## `get_recipe`
コンテンツレシピを一覧表示し、読み込みます。コンテンツレシピは、ナレーション付きのアニメーション解説動画など、複数のツールを使う一連の流れを、アシスタントに最初から最後まで案内する検証済みのプレイブックです。このツールはテキストを返すだけです。レシピが求める操作は、ほかのツールで行います。それぞれのツールには、固有の権限と料金があります。レシピの一覧は、[コンテンツレシピ](https://nodaro.ai/docs/mcp/recipes)を参照してください。

**権限**：なし（常に表示されます）。**クレジット**：無料。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `recipe` | string | レシピ名です。たとえば `video-explainer` です。指定しない場合は、すべてのレシピを一覧表示します。 |
| `file` | string | レシピ内の参照ファイルです。たとえば `references/prompts.md` です。`recipe` が必要です。 |

**戻り値**：引数がない場合は、各レシピの名前、説明、トリガーフレーズです。`recipe` を指定した場合は、そのレシピの完全な指示です。`file` を指定した場合は、そのファイルです。不明な名前を指定すると、有効な名前の一覧を含むエラーが返されます。

Nodaro Cloud では、一覧に Web サイト紹介の UGC 動画も含まれます。クリエイターがカメラに向かってサイトについて話し、サイトのスクリーンショットがカードとして表示される動画です。

## `start_film_director`
Film Director のスキルを返します。このスキルは、脚本から最終カットまでの 10 のステージで映画を監督し、その過程でキャンバス上に編集可能なワークフローを構築するよう、アシスタントに指示します。予告編、短編映画、ミュージックビデオ、リール、広告など、複数のショットからなる動画の依頼では、アシスタントは最初にこのツールを呼び出します。[Film Director](https://nodaro.ai/docs/mcp/film-director) を参照してください。

**権限**：なし（常に表示されます）。**クレジット**：無料。**Nodaro Cloud のみ**。

このツールにはパラメーターがありません。何も変更しません。

## UGC 動画ビルダー
Web サイト紹介の UGC 動画のレシピで使う、3 つの無料のヘルパーです。これらは何も生成しません。それぞれが自分の担当部分をチェックまたは準備し、次に行う生成の呼び出しの引数を正確に返します。Nodaro Cloud でのみ使え、権限は不要です。ただし、保存したキャラクターを使う `build_ugc_creator` には、`assets:read` が必要です。

### `build_ugc_creator`
カメラに向かって話すクリエイターを準備します。新しくサンプリングした人物、保存したキャラクターのいずれか、または自分の写真から選べます。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `source` | string | **必須**。`sampled`、`character`、`photo` のいずれかです。 |
| `character_id` | string | `character` の場合に使う、保存したキャラクターです。 |
| `photo_url` | string | `photo` の場合に使う、自分の写真です。 |
| `gender` | string | `woman` または `man` です。 |
| `product_category`, `overrides`, `previous`, `seed` | | サンプリングしたクリエイターを調整したり、同じクリエイターを再現したりするための、任意の詳細設定です。 |

**戻り値**：クリエイターのアイデンティティ画像、または、次に実行する画像生成の正確な引数を含む画像プロンプトです。

### `build_ugc_clips`
UGC 動画の台本をチェックし、クリップのリクエストに変換します。台本が無効な場合は、すべての問題が、それぞれの修正方法とともに一度に返されます。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `plan` | object | **必須**。台本です。 |
| `gender` | string | **必須**。`woman` または `man` です。 |
| `identity_images` | array | **必須**。クリエイターの画像で、1 枚または 2 枚です。 |
| `traits`, `seed` | | 任意です。 |
| `spent_job_ids` | array | この動画のためにすでに実行したジョブです。見積もりでは、消費済みとして記載されます。 |

**戻り値**：クリップごとの、すぐに実行できる `generate_video` の呼び出し、クリップをつなぐ呼び出し、動画の残りの部分のクレジットの見積もりです。

### `build_ugc_cards`
単語のタイミングから、UGC 動画のスクリーンショットカードと字幕のタイミングを決めます。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `plan` | object | **必須**。台本です。 |
| `alignment` or `words` | array | 単語のタイミングです。[`forced_alignment`](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director#forced_alignment) または [`transcribe`](https://nodaro.ai/docs/mcp/tools/audio#transcribe) から取得します。 |
| `video_duration_ms` | number | 動画の長さです。 |

**戻り値**：[`overlay_images`](https://nodaro.ai/docs/mcp/tools/video-editing#overlay_images) 用のレイヤーと、[`add_captions`](https://nodaro.ai/docs/mcp/tools/video-editing#add_captions) 用の字幕セグメントです。

## Frequently asked questions

### アシスタントが Nodaro に接続されていることを確認するにはどうすればよいですか？

ping を呼び出すよう、アシスタントに依頼してください。このツールは、pong、あなたの Nodaro ユーザー ID、クライアントの名前を返します。権限は必要ありません。

### get_recipe は何を返しますか？

メディアではなく、指示を返します。引数を指定しない場合は、レシピの一覧を、説明とトリガーフレーズとともに返します。レシピ名を指定すると、そのレシピの完全なプレイブックを返します。アシスタントは、ほかのツールを使ってそのプレイブックに従います。

### UGC ビルダーのツールは動画を生成しますか？

いいえ。これらは、Web サイト紹介の UGC 動画のレシピで使う無料のヘルパーです。クリエイターを準備し、台本をチェックし、カードと字幕のタイミングを決めます。そして、次に行う呼び出しを、クレジットの見積もりとともに正確に返します。