Retell AI アップグレード & 移行

概要

Retell AI SDK バージョンアップグレードと破壊的変更の対応ガイドです。

前提条件

• Retell AI SDK がインストール済み
• バージョン管理用の Git
• テストスイートが利用可能
• ステージング環境

手順

ステップ 1: 現在のバージョンを確認

npm list @retellai/sdk
npm view @retellai/sdk version

ステップ 2: チェンジログを確認

open https://github.com/retellai/sdk/releases

ステップ 3: アップグレードブランチを作成

git checkout -b upgrade/retellai-sdk-vX.Y.Z
npm install @retellai/sdk@latest
npm test

ステップ 4: 破壊的変更に対応

必要に応じてインポートステートメント、設定、メソッドシグネチャを更新します。

出力

• 更新されたSDK バージョン
• 修正された破壊的変更
• テストスイートの合格
• ロールバック手順のドキュメント化

エラーハンドリング

SDK バージョン	API バージョン	Node.js	破壊的変更
3.x	2024-01	18+	メジャーリファクタリング
2.x	2023-06	16+	認証の変更
1.x	2022-01	14+	初回リリース

例

インポートの変更

// 変更前 (v1.x)
import { Client } from '@retellai/sdk';

// 変更後 (v2.x)
import { RetellAIClient } from '@retellai/sdk';

設定の変更

// 変更前 (v1.x)
const client = new Client({ key: 'xxx' });

// 変更後 (v2.x)
const client = new RetellAIClient({
  apiKey: 'xxx',
});

ロールバック手順

npm install @retellai/sdk@1.x.x --save-exact

非推奨機能の対応

// 開発環境で非推奨警告を監視
if (process.env.NODE_ENV === 'development') {
  process.on('warning', (warning) => {
    if (warning.name === 'DeprecationWarning') {
      console.warn('[Retell AI]', warning.message);
      // プロアクティブな更新のためトラッキングシステムにログを送信
    }
  });
}

// 監視すべき一般的な非推奨パターン:
// - メソッド名の変更: client.oldMethod() -> client.newMethod()
// - パラメータの変更: { key: 'x' } -> { apiKey: 'x' }
// - 機能の削除: アップグレード前にリリースノートを確認

リソース

• Retell AI チェンジログ
• Retell AI 移行ガイド

次のステップ

アップグレード中の CI インテグレーションについては、retellai-ci-integration を参照してください。