onboarding

ElevenLabs のオンボーディング

ElevenLabs CLI がセットアップ全体を実行し、各ステップを案内します。キーを使用するアプリのフォルダー（モノレポの場合は、そのアプリのフォルダー）から次を実行します。

npx -y @elevenlabs/cli@latest onboard init

すべての onboard コマンドは JSON を出力します。その内容に従って操作し、next が done になるまで続けてください。

• next：今すぐ行うことが instruction に明記されています。
• run：次に実行する正確なコマンドです。表示されたとおりに実行してください。
• say：ユーザーに伝える内容です。記載されたとおりに伝えてください。
• details：アプリでのキーの読み込み方法や SDK のインストールコマンドなど、次のステップに関する情報です。
• rules：セットアップ全体に適用されるルールです。必ず従ってください。

各 next の意味：

• run：run を実行します。
• wait：承認ページが開いています。say（リンクが含まれています）を表示してから、ターンを終了せずにすぐ run を再度実行します。ユーザーにリンクを伝えるときは、出力されたリンク全体を正確にコピーしてください。短縮リンクは機能しません。
• ask_what_to_build：ユーザーに say を伝えます。何を作りたいか、または SDK を追加するだけでよいかを尋ね、コードを書く前に回答を待ってください。以前にユーザーが話していても、必ず尋ねてください。また、ユーザーに代わって製品を選ばないでください。回答があったら run を実行します。
• write_code：instruction の指示どおりに、ユーザーが依頼したもの（SDK のみ、または統合）を書きます。details.fetch_skills に該当するスキルがあれば、それを使用してください。ElevenLabs 側でエージェントの作成などが必要な場合は、ユーザーが実行するスクリプトを作成するのではなく、キーを使って自分で作成してください（コマンド内で環境ファイルを読み込み、内容は絶対に表示しないでください）。details.load_key の指示に従ってキーを読み込み、その後 run を実行します。
• load_key：コードではすでに SDK が使用されているため、作成するものはありません。アプリが details.load_key の指示どおりにキーを読み込むことを確認し、それ以外は変更せずに run を実行します。
• fix：say の説明に従って対応し、その後 run を実行します。ユーザーのシェル、設定、またはシークレットが必要な場合は、ask_user と同様にユーザーに依頼してください。
• ask_user：ユーザーに say の内容を尋ね、回答を待ってから run を実行します。ただし、ユーザーが拒否した場合は実行しません。
• offer_test：セットアップした内容と、追加したパッケージのインストールなど、ユーザー自身で行う必要があることを伝えます。その後、返信の最後を say の質問で締めくくります。ユーザーが「はい」と答えた場合にのみ run を実行します。
• done：ユーザーに say の内容を伝え、その後、ユーザー自身で行う必要があることを、具体的な手順で1つまたは2つ伝えます。

ルール

• 環境ファイルを開いたり、表示したり、cat したりしないでください。onboard check がファイルを検証します。
• チャットで API キーを尋ねたり、貼り付けられた API キーを受け入れたりしないでください。キーが表示された場合は、API keys ページでローテーションするようユーザーに伝えてください。
• キーをコードに記述しないでください。SDK は ELEVENLABS_API_KEY を読み込みます。
• キーは未追跡ファイルに含まれているため、git clean を実行したり、未追跡ファイルを削除したりしないでください。
• 返信の next が write_code または load_key になるまで、コードを書いたり変更したりしないでください。
• パッケージやアーカイブなど、読むためだけにダウンロードするものは、プロジェクト内ではなく一時フォルダーに保存してください。
• テスト依頼に対してユーザーが「はい」と答えるまでは、アプリ（または起動スクリプト）を実行したり、試すために音声を生成したりしないでください。エージェントの作成など、ユーザーが依頼した作業に必要な API 呼び出しは実行してかまいません。コードを書いたら、作業を終える前に onboard check を実行してください。キーとコードが検証されます。

npx は使用しない

npx を使用できない場合（Node.js がインストールされていない場合）は、CLI をインストールするか、すでにインストール済みなら更新します（brew upgrade elevenlabs を実行するか、インストーラーを再度実行してください）。その後、elevenlabs onboard init を実行します。それ以降の手順は同じです。

• macOS または Linux：brew install elevenlabs/tap/elevenlabs、または curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
• Windows：powershell -ExecutionPolicy ByPass -c "irm https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.ps1 | iex"

インストーラーを実行した後も elevenlabs が見つからない場合は、ここおよび CLI が指示するすべての run で、代わりに ~/.cargo/bin/elevenlabs を使用してください。