Retell AI ローカル開発ループ

概要

Retell AIの高速で再現可能なローカル開発ワークフローをセットアップします。

前提条件

• retellai-install-authセットアップが完了していること
• Node.js 18以上（npm/pnpmを含む）
• TypeScriptサポート付きのコードエディタ
• バージョン管理用のGit

手順

ステップ1: プロジェクト構造の作成

my-retellai-project/
├── src/
│   ├── retellai/
│   │   ├── client.ts       # Retell AIクライアントラッパー
│   │   ├── config.ts       # 設定管理
│   │   └── utils.ts        # ヘルパー関数
│   └── index.ts
├── tests/
│   └── retellai.test.ts
├── .env.local              # ローカルシークレット（gitで無視）
├── .env.example            # チーム用テンプレート
└── package.json

ステップ2: 環境の設定

# 環境テンプレートをコピー
cp .env.example .env.local

# 依存関係をインストール
npm install

# 開発サーバーを起動
npm run dev

ステップ3: ホットリロードの設定

{
  "scripts": {
    "dev": "tsx watch src/index.ts",
    "test": "vitest",
    "test:watch": "vitest --watch"
  }
}

ステップ4: テスト環境の設定

import { describe, it, expect, vi } from 'vitest';
import { RetellAIClient } from '../src/retellai/client';

describe('Retell AI Client', () => {
  it('should initialize with API key', () => {
    const client = new RetellAIClient({ apiKey: 'test-key' });
    expect(client).toBeDefined();
  });
});

出力

• ホットリロード機能付きの動作開発環境
• モック設定済みのテストスイート
• 環境変数管理
• Retell AI開発向けの高速イテレーションサイクル

エラーハンドリング

エラー	原因	対応方法
Module not found	依存関係が不足している	npm installを実行
Port in use	別のプロセスが実行中	プロセスを終了するか別のポートに変更
Env not loaded	.env.localがない	.env.exampleからコピー
Test timeout	ネットワークが遅い	テストタイムアウトを増加

例

Retell AIレスポンスのモック

vi.mock('@retellai/sdk', () => ({
  RetellAIClient: vi.fn().mockImplementation(() => ({
    // ここにモックメソッドを追加
  })),
}));

デバッグモード

# 詳細ログを有効化
DEBUG=RETELLAI=* npm run dev

リソース

• Retell AI SDK リファレンス
• Vitest ドキュメント
• tsx ドキュメント

次のステップ

本番環境対応のコードパターンについては retellai-sdk-patterns を参照してください。