用語
すべての用語集

/

promptのバージョン管理とは?

promptのバージョン管理とは?

promptのバージョン管理とは何か、音声エージェントのチームがprompt変更をすべてバージョン管理する理由、本番の通話を壊さずにテスト・リリース・ロールバックする方法を解説します。

promptのバージョン管理(prompt versioning)とは、AIエージェントのpromptへの変更を、番号付きの固定バージョンとして保存する手法です。これにより、チームは変更を本番公開前にテストし、何が変わったかを正確に確認できます。新しいバージョンに問題があれば、以前のバージョンに戻すこともできます。prompt version controlとも呼ばれます。promptマネジメントはpromptの作成・保存・整理を担う、より広い業務です。バージョン管理は、その中でリリースを管理する部分にあたります。

promptエンジニアリングはpromptで何を伝えるかを決めます。promptのバージョン管理は、通話相手がそれをいつ聞くかを決めます。

音声エージェントでは、なぜprompt変更のリスクが高いのですか?

音声エージェントは、実際の通話相手とリアルタイムで会話します。そのため、不適切なpromptは、誰かが文字起こしを確認する前に相手に届いてしまいます。相手がすでに聞いた発言は取り消せません。

チャットアシスタント電話の音声エージェント
ミスが表れる場所画面上(ユーザーは読み返しや再試行が可能)会話の途中で一度だけ発話される
promptが制御するものテキストの返答、場合によってはツール呼び出し返答に加え、実際のシステムに届く通話転送・予約・SMS送信
テキストでのテストが見落とすものプロダクト自体がテキストなので、ほとんどない音声、割り込み、通話転送、キーパッド入力

音声エージェントでは、変わるのはpromptだけではありません。Retell AI におけるバージョンとは、エージェント全体を指します。具体的には、prompt、音声、ツール、会話フロー、連携されたナレッジベースです。新しい音声やツール名の変更は、指示文の言い換えと同じくらい簡単に通話を壊す可能性があります。そのため、チームはpromptのテキストだけでなく、エージェント全体をバージョン管理します。

Retell AI でのpromptのバージョン管理の仕組みは?

Retell は、ドラフト、公開済みバージョン、環境タグを基盤としたリリース手順をドキュメント化しています。以下の各ステップは、エージェントのバージョン、テスト、分析、アラートに関する Retell のドキュメントに基づいています。

音声エージェントにおけるpromptのバージョン管理のライフサイクル(6段階)。ドラフト:新しいバージョンは、過去の任意のバージョンからコピーされた編集可能なドラフトとして始まる。テスト:シミュレーションテストを一括で実行し、さらにドラフトでWeb通話と電話をテストする。比較:最後に公開されたバージョンとの差分を単語レベルで確認する。公開:バージョンは読み取り専用になり、V3(ドラフト)がV3になる。リリース:prod環境タグをV2からV3に移動すると、そのタグに紐づく電話番号も追従する。モニタリング:バージョン別に分析し、prodタグでアラートを設定する。ロールバック:prodタグをV2に戻す。
ドラフトからロールバックまで、ドキュメント化された Retell AI の音声エージェントのリリース手順。図:Retell AI、2026年10月。
  • ドラフト。新しいバージョンは、編集可能なドラフトとして始まります。過去のどのバージョンからでも作成でき、複数のドラフトを同時に保持できます。
  • テスト。保存済みのシミュレーションテストケースを一括で実行し、合格率を前回の実行と比較します。次にWeb通話で変更内容を実際に聞き、電話で通話転送とキーパッド入力を確認します。どちらも、ドラフトを公開せずに実行できます。
  • 比較。公開ダイアログでは、ドラフトを最後に公開されたバージョンと比較できます。promptで追加・削除された単語のレベルまで確認可能です。
  • 公開。公開するとバージョンは読み取り専用になり、V3(ドラフト)はV3になります。これは、後から戻ることができる固定の構成です。
  • リリース。各エージェントには、最初からprodタグとstagingタグがあります。prodに割り当てられた電話番号は、そのタグが指すバージョンに従います。そのため、prodをV2からV3に移動すれば、番号ごとに編集しなくても切り替わります。まず一部の通話で変更を試したい場合は、A/Bテストで電話番号のトラフィックをエージェント間で割合に応じて振り分けられます。
  • モニタリング。分析ダッシュボードではエージェントのバージョン別に指標を確認でき、アラートルールはprodタグに限定できます。
  • ロールバック。prodをV2に戻します。

promptのバージョンは誰が管理すべきですか?

電話回線でのprompt変更は、本番環境の変更です。そのため、すべてのリリースに責任を持つ担当者を1人決めておくべきです。Retell のお客様の中には、その役割をCXオートメーションエンジニアに任せている企業もあります。CXオートメーションエンジニアは社内の責任者として、うまく処理されなかった通話を見つけ、修正を作成してテストします。うまくいかなければ、最後に公開されたバージョンに戻します。

簡単なリリース習慣を持つことで、バージョンを有効に活用できます。

  1. 各バージョンには、「返金時の通話転送を修正」のように変更理由をタイトルとして付けます。
  2. テストを実行する前に、本番システムにアクセスするすべての関数をモック化します。Retell のドキュメントでは、モック化されていないカスタム関数は実際のendpointを呼び出すと注意を促しています。
  3. prodを移動する前に、どのバージョンにロールバックするかを記録しておきます。
  4. 最初の1日は、新しいバージョンの通話をバージョン別に監視します。

promptのバージョン管理に関するよくある質問

promptのバージョン管理とpromptマネジメントの違いは何ですか?

promptマネジメントは、promptの作成・保存・整理・編集を対象とします。promptのバージョン管理は、promptマネジメントの一部です。各変更を固定バージョンとして保存し、チームがテスト・比較・ロールバックできるようにします。

promptのバージョン管理ツールとは何ですか?

各promptのバージョンを識別子付きで保存し、何が変わったかを表示し、本番環境でどのバージョンを実行するかを制御するツールです。音声エージェントのプラットフォームでは、バージョン管理をエージェントビルダーに組み込むことができます。Retell AI では、ドラフト、公開済みバージョン、環境タグがすべてのエージェントに備わっています。

音声エージェントでprompt変更をロールバックするには?

本番環境を、最後に正常に動作していたバージョンに戻します。Retell AI では、prod環境タグを以前のバージョンに戻すと、そのタグに割り当てられた電話番号も追従します。

本番の通話に影響を与えずに新しいpromptのバージョンをテストできますか?

はい。変更をドラフトのまま保持し、シミュレーションテスト、Web通話、またはテスト用番号での電話でテストできます。Retell では、ドラフトのバージョンを公開せずに電話番号に紐づけられます。テスト中はprodタグの動的変数を変更しないでください。これらは本番の通話に適用されます。

Retell AI で音声エージェントのバージョン管理とテストを

Retell AI は、コンタクトセンター向けのAI音声エージェントプラットフォームです。ドラフト、バージョン比較、環境タグ、シミュレーションテストと一括テストがエージェントビルダーに組み込まれています。リリース後はAI QAが本番通話のサンプルをスコアリングするため、リリースのたびに通話品質を確認できます。

Add Retell AI as a preferred source on Google
おすすめ

関連するAI音声エージェント用語

Retellで通話業務に革新を