> ## Documentation Index
> Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills para Agentes

> Use seu agente de IA para criar, gerenciar e baixar projetos de localização de vídeo do Vozo com prompts em linguagem natural.

As Vozo Skills permitem que você peça ao seu agente de IA para cuidar da localização de vídeos no Vozo usando linguagem natural. Elas funcionam por meio do Vozo CLI, que é instalado durante a configuração e conecta seu agente ao Vozo para que ele possa criar projetos, verificar o progresso e baixar os arquivos finalizados para você — sem exigir que você aprenda ou execute qualquer comando.

## O que você pode fazer

O Vozo Skills oferece suporte a quatro tarefas principais de localização:

* **Dublagem por IA**: Traduza a fala e crie vídeo ou áudio dublado em outro idioma.
* **Tradução de Legendas**: Crie legendas traduzidas ou substitua legendas já visíveis em um vídeo.
* **Tradução visual**: Traduza o Texto na tela preservando sua apresentação visual.
* **Lip Sync**: Sincronize os movimentos da boca com áudio novo ou traduzido.

Você também pode pedir ao seu agente para:

* Processar um arquivo local, uma pasta de arquivos ou uma URL de vídeo compatível
* Criar várias versões em diferentes idiomas ou processar vários arquivos em lote
* Aplicar várias ferramentas do Vozo em um único fluxo de trabalho
* Verificar o status do projeto e encontrar projetos existentes
* Exportar e baixar vídeos, áudios e arquivos de legenda disponíveis

## Antes de começar

Você precisa de:

* Uma conta Vozo
* Um agente de IA que possa usar ferramentas e arquivos no seu computador

As Skills do Vozo foram testadas com Claude Code, Codex, OpenClaw, Cursor, WorkBuddy e Hermes. Outros agentes de IA que conseguem executar ferramentas locais também podem funcionar.

<Info>
  Os projetos criados por meio do Vozo Skills usam a mesma conta Vozo e o mesmo [sistema de Pontos](/docs/pt/common/tools-points-rules) que os projetos criados no aplicativo web do Vozo. Antes de criar um projeto, seu agente mostra os Pontos estimados e pede sua confirmação.
</Info>

## Instalar o Vozo Skills

A maneira mais fácil de começar é copiar o prompt abaixo para o seu agente de IA:

```text wrap theme={null}
Install vozoai/cli: https://raw.githubusercontent.com/vozoai/cli/main/installation-guide.md
```

Seu agente executará a configuração e informará se precisa de permissão para usar ferramentas locais.

Durante o login, o Vozo abre uma página segura no navegador. Conclua o login lá e depois volte ao seu agente para que ele possa verificar sua conta.

<Accordion title="Instalar a partir de um terminal">
  Se preferir executar a configuração por conta própria, abra um terminal e digite:

  ```bash theme={null}
  npx @vozoai/cli@latest install
  ```

  Após a instalação, volte ao seu agente de IA e peça para ele fazer login no Vozo para você.
</Accordion>

## Crie seu primeiro projeto

<Steps>
  <Step title="Compartilhe sua fonte">
    Forneça ao seu agente um arquivo local, uma pasta ou uma URL de vídeo compatível. Certifique-se de que o agente possa acessar a fonte no seu computador.
  </Step>

  <Step title="Descreva o resultado que você deseja">
    Informe o idioma de destino e as tarefas a incluir, como dublagem, legendas, tradução de Texto na tela ou Lip Sync. Você também pode descrever a terminologia preferida, o tom e onde salvar os arquivos finalizados.
  </Step>

  <Step title="Revise e confirme o Plano">
    Verifique a fonte, o idioma de destino, as tarefas selecionadas e os Pontos estimados. Confirme somente quando o Plano corresponder à sua solicitação.
  </Step>

  <Step title="Deixe seu agente executar o fluxo de trabalho">
    Seu agente cria o projeto, verifica seu progresso e inicia uma exportação quando necessário. Você pode continuar pedindo atualizações de status enquanto ele trabalha.
  </Step>

  <Step title="Revise ou baixe o resultado">
    Quando o processamento for concluído, seu agente poderá baixar os arquivos disponíveis para um local de sua escolha. Ele também pode fornecer um link para abrir o projeto no aplicativo web do Vozo.
  </Step>
</Steps>

## Exemplos de prompts

Use linguagem natural e inclua a fonte, o idioma de destino e o resultado que você deseja.

### Localize um vídeo

```text wrap theme={null}
Translate this video into Spanish with dubbing and translated subtitles. Keep product names in English, and save the finished video in my Downloads folder.
```

### Processe uma pasta

```text wrap theme={null}
Translate every video in this folder into Japanese. Include dubbing, on-screen text translation, and lip sync, then save all finished videos in a new folder.
```

### Crie várias versões em diferentes idiomas

```text wrap theme={null}
Make English, French, and Spanish versions of this video with dubbing and subtitles. Show me the plan and estimated points before creating anything.
```

### Colete o trabalho concluído

```text wrap theme={null}
Find my completed Vozo projects from last week and download the available final videos and subtitle files.
```

## Revise e edite no Vozo

Os projetos criados por meio do Vozo Skills também aparecem na sua conta Vozo. Peça ao seu agente para abrir um projeto quando você quiser revisá-lo no aplicativo web do Vozo.

Atualmente, o Vozo Skills se concentra na criação de projetos, verificação de progresso, exportação de resultados e download de arquivos. Para editar traduções, Mudar Vozes, redublar conteúdo ou fazer outras alterações detalhadas, abra o projeto no editor web do Vozo.

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Preciso saber programar?">
    Não. Copie o prompt de instalação para o seu agente de IA, e ele verificará seu computador e orientará você durante a configuração. Depois disso, você poderá usar o Vozo Skills com solicitações em linguagem simples.
  </Accordion>

  <Accordion title="O Vozo Skills substitui o aplicativo web do Vozo?">
    Não. O Vozo Skills ajuda seu agente a executar fluxos de trabalho compatíveis e tarefas repetitivas. Use o aplicativo web quando quiser revisar visualmente um projeto ou editar seu conteúdo em detalhes.
  </Accordion>

  <Accordion title="Onde posso encontrar os projetos criados pelo meu agente?">
    Eles aparecem na mesma conta Vozo que você usou durante o login. Você pode pedir ao seu agente para encontrar ou abrir um projeto, ou navegar pelos seus projetos no aplicativo web do Vozo.
  </Accordion>

  <Accordion title="Por que as legendas em um vídeo baixado pelo meu agente parecem diferentes do que vejo no aplicativo web?">
    O aplicativo web da Vozo lembra o estilo e a posição das legendas que você usou anteriormente. Essas informações são armazenadas localmente no seu navegador, por isso seu agente de IA não pode acessá-las ao criar um projeto. Portanto, os projetos criados por meio de um agente usam o estilo de legenda padrão.

    Se a aparência das legendas for importante, peça ao seu agente para criar o projeto e depois abra-o no aplicativo web da Vozo. Revise e ajuste o estilo e a posição das legendas antes de exportar e baixar o vídeo manualmente.
  </Accordion>

  <Accordion title="Por que minhas edições no aplicativo web não estão incluídas no vídeo baixado pelo meu agente?">
    Algumas edições no aplicativo web da Vozo exigem processamento adicional, como regenerar a fala ou adicionar legendas. Se você não esperar no navegador até que o processamento seja concluído, as alterações mais recentes não poderão ser sincronizadas com seu agente de IA.

    Seu agente poderá então tratar o projeto como inalterado e baixar a versão anterior em vez de exportar um novo vídeo. Após editar, mantenha o projeto aberto no aplicativo web e espere o processamento terminar. Depois, peça ao seu agente para verificar o projeto novamente, exportar a versão mais recente e baixá-la.
  </Accordion>

  <Accordion title="O Vozo Skills usa Pontos?">
    Sim. Os projetos seguem as mesmas regras de Pontos que os projetos criados no aplicativo web do Vozo. Seu agente mostra uma estimativa antes da criação e aguarda sua confirmação.
  </Accordion>
</AccordionGroup>