runway-dev-characters

Runway Characters

Developer Portal ではこれらを Characters と呼びますが、API と SDK では Avatars と呼びます。リアルタイムの Session は、1 つのライブ会話です。インストールされている場合は、アカウントの設定と共有認証情報のガイダンスについて runway-dev を参照してください。

ワークフロー

1. アプリの通話体験とサーバーアーキテクチャを確認します。既存の Character、ドキュメントに記載されたプリセット、新しく作成するカスタム Avatar のどれを使用するかがすでに明確でない場合に限り、ユーザーに確認します。
2. ライブのアカウント状態やユーザーの Character が関係する場合は、Dev MCP を使って利用可能な Avatar とその状態を確認します。別の Avatar に置き換えたり、プリセット ID を推測したりしないでください。カスタム Avatar が指定された場合は、その参照画像と現在の API／MCP スキーマを使用します。
3. 現行のCharacters 統合ガイドとSDK ドキュメントに従います。現在の React コンポーネント、フック、スタイルについては @runwayml/avatars-react の README を確認します。React を使用しない Web クライアントには @runwayml/avatars を使用します。
4. @runwayml/sdk を使って、サーバー側で Session を作成します。RUNWAYML_API_SECRET はサーバー上に保持してください。現行の Session 準備完了および認証情報消費のフローに従い、ブラウザー SDK が必要とする一度限りの接続フィールドのみを公開します。API シークレットをブラウザーに送信してはいけません。
5. アプリの UI で、権限、接続中、アクティブ、失敗、終了の状態を処理します。現行の SDK／API ガイダンスに従って、ティアダウン時に Session を終了またはキャンセルします。一度限りの認証情報がすでに消費され、接続に失敗した場合は、それらを再利用せず、新しい Session を作成します。
6. ローカルチェックを実行します。ライブ Session の利用には料金が発生する場合があるため、検証目的で Session を開始するのは、依頼または承認があった場合に限ります。

ライブデータとナレッジ

利用可能な MCP ツールを使って、list_avatars と get_avatar でライブの Avatar を確認し、list_avatar_knowledge_documents と get_avatar_knowledge_document でナレッジドキュメントを確認します。create_avatar、update_avatar、delete_avatar は Avatar を管理します。対応する *_avatar_knowledge_document ツールはナレッジドキュメントを管理します。Avatar を作成したら、状態が READY または FAILED になるまで get_avatar で確認します。変更する前に既存のレコードと現在のツール仕様を読み、破壊的な削除はユーザーに確認してください。MCP を利用できない場合は、ドキュメントと既存の ID から実装できるアプリコードの作業を続け、ライブのアカウント状態が必要な手順のみを保留します。

現行ドキュメント

• Characters の概要
• 統合の構築
• Session の概念とライフサイクル
• Characters ドキュメント一式
• React SDK