# Utilitários, receitas e skills

> Teste a conexão com ping, carregue receitas testadas com get_recipe, inicie a skill Film Director e prepare vídeos UGC sobre sites com os montadores.

Source: https://nodaro.ai/pt-BR/docs/mcp/tools/utility

As **ferramentas de utilitários, receitas e skills** ajudam um assistente a começar bem. `ping` testa a conexão, `get_recipe` carrega guias testados de várias etapas, `start_film_director` carrega a skill Film Director e os três montadores de UGC preparam um vídeo de criador de conteúdo sobre um site. Nenhuma delas gera mídia nem gasta créditos.

Outras ferramentas que retornam instruções estão documentadas com a família delas: [`start_workflow_editor` e `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) e [`get_recast_authoring_skill`](https://nodaro.ai/docs/mcp/tools/recast#get_recast_authoring_skill).

## `ping`
Retorna `pong`, o seu ID de usuário do Nodaro e o nome do cliente que a chamou. Use-a para verificar se o conector funciona.

**Permissão:** nenhuma, sempre visível. **Créditos:** grátis.

Esta ferramenta não tem parâmetros.

## `get_recipe`
Lista e carrega receitas de conteúdo: guias testados que conduzem um assistente por um fluxo completo com várias ferramentas, como um vídeo explicativo animado e narrado. A ferramenta só retorna texto. As ações que uma receita pede são feitas com as outras ferramentas, cada uma com a própria permissão e o próprio preço. Veja o catálogo em [Receitas de conteúdo](https://nodaro.ai/docs/mcp/recipes).

**Permissão:** nenhuma, sempre visível. **Créditos:** grátis.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `recipe` | string | O nome de uma receita, como `video-explainer`. Omita-o para listar todas as receitas. |
| `file` | string | Um arquivo de referência dentro da receita, como `references/prompts.md`. Exige `recipe`. |

**Retorna:** sem argumentos, o nome, a descrição e as frases de ativação de cada receita. Com `recipe`, as instruções completas da receita. Com `file`, esse arquivo. Um nome desconhecido retorna um erro com os nomes válidos.

No Nodaro Cloud, a lista também inclui um vídeo UGC sobre um site: um criador de conteúdo falando para a câmera sobre um site, com as capturas de tela dele exibidas como cartões.

## `start_film_director`
Retorna a skill Film Director: as instruções que fazem o assistente dirigir um filme em 10 etapas, do roteiro à montagem final, e montar um workflow editável no seu canvas ao longo do processo. Os assistentes a chamam primeiro para qualquer pedido de vídeo com várias tomadas, como um trailer, um curta-metragem, um videoclipe, um reel ou um anúncio. Veja [Film Director](https://nodaro.ai/docs/mcp/film-director).

**Permissão:** nenhuma, sempre visível. **Créditos:** grátis. **Somente no Nodaro Cloud.**

Esta ferramenta não tem parâmetros. Ela não altera nada.

## Os montadores de vídeo UGC
Três auxiliares grátis usados pela receita de vídeo UGC sobre sites. Eles não geram nada: cada um verifica ou prepara a sua parte e retorna os argumentos exatos das próximas chamadas de geração. Estão disponíveis somente no Nodaro Cloud e não precisam de permissão, exceto `build_ugc_creator` com um personagem salvo, que precisa de `assets:read`.

### `build_ugc_creator`
Prepara o criador de conteúdo que fala para a câmera: uma pessoa nova, gerada por amostragem, um dos seus personagens salvos ou a sua própria foto.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `source` | string | **Obrigatório.** `sampled`, `character` ou `photo`. |
| `character_id` | string | Para `character`: o personagem salvo. |
| `photo_url` | string | Para `photo`: a sua foto. |
| `gender` | string | `woman` ou `man`. |
| `product_category`, `overrides`, `previous`, `seed` | | Detalhes opcionais para orientar ou repetir o criador gerado por amostragem. |

**Retorna:** as imagens de identidade do criador, ou um prompt de imagem com os argumentos exatos da geração de imagem a executar em seguida.

### `build_ugc_clips`
Verifica o roteiro de um vídeo UGC e o transforma em pedidos de clipe. Um roteiro inválido retorna todos os problemas de uma vez, cada um com a correção.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `plan` | object | **Obrigatório.** O roteiro. |
| `gender` | string | **Obrigatório.** `woman` ou `man`. |
| `identity_images` | array | **Obrigatório.** Uma ou duas imagens do criador. |
| `traits`, `seed` | | Opcionais. |
| `spent_job_ids` | array | Os jobs já executados para este vídeo, que a cotação lista como gastos. |

**Retorna:** uma chamada de `generate_video` pronta para executar por clipe, a chamada que junta os clipes e uma cotação em créditos para o resto do vídeo.

### `build_ugc_cards`
Define o timing dos cartões de captura de tela e das legendas de um vídeo UGC a partir dos tempos das palavras.

| Parâmetro | Tipo | Observações |
| --- | --- | --- |
| `plan` | object | **Obrigatório.** O roteiro. |
| `alignment` ou `words` | array | Os tempos das palavras, de [`forced_alignment`](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director#forced_alignment) ou de [`transcribe`](https://nodaro.ai/docs/mcp/tools/audio#transcribe). |
| `video_duration_ms` | number | A duração do vídeo. |

**Retorna:** as camadas para [`overlay_images`](https://nodaro.ai/docs/mcp/tools/video-editing#overlay_images) e os segmentos de legenda para [`add_captions`](https://nodaro.ai/docs/mcp/tools/video-editing#add_captions).

## Frequently asked questions

### Como verifico se o meu assistente está conectado ao Nodaro?

Peça para ele chamar ping. A ferramenta responde com pong, o seu ID de usuário do Nodaro e o nome do seu cliente, e não precisa de permissão.

### O que get_recipe retorna?

Instruções, não mídia. Sem argumento, lista as receitas com as descrições e as frases de ativação; com o nome de uma receita, retorna o guia completo dela, que o assistente então segue com as outras ferramentas.

### Os montadores de UGC geram o vídeo?

Não. Eles são auxiliares grátis da receita de vídeo UGC sobre sites. Preparam o criador, verificam o roteiro e definem o timing dos cartões e das legendas, e retornam as chamadas exatas a fazer em seguida, com uma cotação em créditos.
