> ## 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.

# エージェント向けスキル

> 自然言語のプロンプトを使って、AIエージェントで Vozo の動画ローカライズプロジェクトを作成、管理、ダウンロードできます。

Vozo Skills を使うと、自然な言葉で AI エージェントに Vozo 内での動画ローカライズを任せることができます。これはセットアップ時にインストールされる Vozo CLI を通じて動作し、エージェントを Vozo に接続することで、コマンドを覚えたり実行したりしなくても、プロジェクトの作成、進行状況の確認、完成したファイルのダウンロードを行えるようになります。

## できること

Vozo Skills は、4つの主要なローカライズ作業に対応しています。

* **AI Dubbing**: 音声を翻訳し、別の言語の吹き替え動画または音声を作成します。
* **字幕翻訳**: 翻訳された字幕を作成するか、動画内ですでに表示されている字幕を置き換えます。
* **ビジュアル翻訳**: 見た目の表現を保ったまま、画面上のテキストを翻訳します。
* **リップシンク**: 新しい音声または翻訳済み音声に合わせて口の動きを同期させます。

また、エージェントに次のことも依頼できます。

* ローカルファイル、ファイルを含むフォルダー、または対応している動画 URL を処理する
* 複数の言語バージョンを作成する、または複数ファイルを一括処理する
* 複数の Vozo ツールを1つのワークフローとして適用する
* プロジェクトのステータスを確認し、既存のプロジェクトを見つける
* 利用可能な動画、音声、字幕ファイルをエクスポートしてダウンロードする

## 始める前に

必要なもの：

* Vozo アカウント
* お使いのコンピューター上のツールやファイルを利用できる AIエージェント

Vozo Skills は、Claude Code、Codex、OpenClaw、Cursor、WorkBuddy、Hermes でテストされています。ローカルツールを実行できる他の AI エージェントでも動作する可能性があります。

<Info>
  Vozo Skills で作成されたプロジェクトは、Vozo Web アプリで作成されたプロジェクトと同じ Vozo アカウントおよび[ポイントシステム](/docs/ja/common/tools-points-rules)を使用します。プロジェクトを作成する前に、エージェントは推定ポイント数を表示し、確認を求めます。
</Info>

## Vozo Skills をインストールする

開始する最も簡単な方法は、以下のプロンプトを AIエージェントにコピーすることです。

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

エージェントがセットアップを実行し、ローカルツールの使用に許可が必要な場合はその旨を知らせます。

サインイン中、Vozo は安全なブラウザーページを開きます。そこでログインを完了し、その後エージェントに戻ってアカウントを認証できるようにしてください。

<Accordion title="代わりにターミナルからインストールする">
  セットアップを自分で実行したい場合は、ターミナルを開いて次を入力してください。

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

  インストール後、AIエージェントに戻り、Vozo にサインインするよう依頼してください。
</Accordion>

## 最初のプロジェクトを作成する

<Steps>
  <Step title="ソースを共有する">
    ローカルファイル、フォルダー、または対応している動画 URL をエージェントに渡してください。エージェントがお使いのコンピューター上のソースにアクセスできることを確認してください。
  </Step>

  <Step title="希望する結果を説明する">
    対象言語と、吹き替え、字幕、画面上のテキストの翻訳、リップシンクなど、含めたい作業を指定してください。あわせて、希望する用語、トーン、完成したファイルの保存先も指定できます。
  </Step>

  <Step title="プランを確認して確定する">
    ソース、対象言語、選択した作業、推定ポイント数を確認してください。プランが依頼内容と一致している場合にのみ確定してください。
  </Step>

  <Step title="エージェントにワークフローを実行させる">
    エージェントはプロジェクトを作成し、進行状況を確認し、必要な場合はエクスポートを開始します。処理中もステータス更新を引き続き依頼できます。
  </Step>

  <Step title="結果を確認またはダウンロードする">
    処理が完了すると、エージェントは利用可能なファイルを指定した場所にダウンロードできます。また、Vozo Web アプリでプロジェクトを開くためのリンクを提供することもできます。
  </Step>
</Steps>

## プロンプトの例

自然な言葉を使い、ソース、対象言語、希望する結果を含めてください。

### 1本の動画をローカライズする

```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.
```

### フォルダーを処理する

```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.
```

### 複数の言語バージョンを作成する

```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.
```

### 完了した成果物を回収する

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

## Vozo で確認・編集する

Vozo Skills で作成されたプロジェクトは、Vozo アカウントにも表示されます。Vozo Web アプリで確認したいときは、エージェントにプロジェクトを開くよう依頼してください。

Vozo Skills は現在、プロジェクトの作成、進行状況の確認、結果のエクスポート、ファイルのダウンロードに重点を置いています。翻訳の編集、音声を変更、コンテンツの再吹き替え、その他の詳細な変更を行うには、Vozo Web エディターでプロジェクトを開いてください。

## よくある質問

<AccordionGroup>
  <Accordion title="コーディングの知識は必要ですか？">
    いいえ。インストール用プロンプトを AIエージェントにコピーすると、コンピューターを確認し、セットアップを案内してくれます。その後は、わかりやすい自然な言葉で Vozo Skills を利用できます。
  </Accordion>

  <Accordion title="Vozo Skills は Vozo Web アプリの代わりになりますか？">
    いいえ。Vozo Skills は、エージェントが対応しているワークフローや繰り返し作業を実行するのを支援します。プロジェクトを視覚的に確認したい場合や、内容を詳細に編集したい場合は Web アプリを使用してください。
  </Accordion>

  <Accordion title="エージェントが作成したプロジェクトはどこで見つけられますか？">
    それらは、サインイン時に使用したのと同じ Vozo アカウントに表示されます。エージェントにプロジェクトを見つける、または開くよう依頼することも、Vozo Web アプリでプロジェクトを参照することもできます。
  </Accordion>

  <Accordion title="エージェントがダウンロードした動画の字幕が、web app で表示されるものと異なって見えるのはなぜですか？">
    Vozo の web app は、以前に使用した字幕のスタイルと位置を記憶しています。この情報はブラウザ内にローカル保存されるため、AI エージェントはプロジェクト作成時にこれへアクセスできません。そのため、エージェント経由で作成されたプロジェクトではデフォルトの字幕スタイルが使用されます。

    字幕の見た目が重要な場合は、まずエージェントにプロジェクトを作成させ、その後 Vozo の web app で開いてください。手動で動画を書き出してダウンロードする前に、字幕のスタイルと位置を確認し、調整してください。
  </Accordion>

  <Accordion title="web app で行った編集内容が、エージェントがダウンロードした動画に反映されないのはなぜですか？">
    Vozo の web app での一部の編集では、音声の再生成や字幕の追加など、追加の処理が必要です。処理が完了するまでブラウザ上で待機しない場合、最新の変更は AI エージェントに同期されません。

    その結果、エージェントはプロジェクトが未変更であると判断し、新しい動画を書き出す代わりに前のバージョンをダウンロードする場合があります。編集後は、web app でプロジェクトを開いたままにして、処理が完了するまで待ってください。その後、エージェントにプロジェクトを再確認し、最新バージョンを書き出してダウンロードするよう依頼してください。
  </Accordion>

  <Accordion title="Vozo Skills ではポイントを使用しますか？">
    はい。プロジェクトには、Vozo Web アプリで作成されたプロジェクトと同じポイントルールが適用されます。エージェントは作成前に見積もりを表示し、確認を待ちます。
  </Accordion>
</AccordionGroup>