Retell AI Core Workflow A

概要

カスタムプロンプト、関数呼び出し、通話フロー ロジックを使用してボイスエージェントを構築・構成します。

前提条件

• retellai-hello-world の完了

指示

ステップ 1: 関数呼び出し機能付きエージェント

const llm = await retell.llm.create({
  model: 'gpt-4o',
  general_prompt: `You are a booking assistant for Dr. Smith's office.
    - Help callers book, reschedule, or cancel appointments
    - Collect: name, phone, preferred date/time
    - Confirm all details before booking`,
  functions: [
    {
      name: 'book_appointment',
      description: 'Book a new appointment',
      parameters: {
        type: 'object',
        properties: {
          patient_name: { type: 'string' },
          phone: { type: 'string' },
          date: { type: 'string', description: 'YYYY-MM-DD format' },
          time: { type: 'string', description: 'HH:MM format' },
        },
        required: ['patient_name', 'phone', 'date', 'time'],
      },
      url: 'https://your-api.com/appointments',
      speak_during_execution: true,
      speak_after_execution: true,
    },
  ],
});

ステップ 2: 音声と動作の設定

const agent = await retell.agent.create({
  response_engine: { type: 'retell-llm', llm_id: llm.llm_id },
  voice_id: '11labs-Rachel',
  agent_name: 'Dr. Smith Booking Agent',
  language: 'en-US',
  opt_out_sensitive_data_storage: false,
  end_call_after_silence_ms: 10000,  // End call after 10s silence
  max_call_duration_ms: 300000,       // 5-minute max
  enable_backchannel: true,           // "mhm", "yeah" responses
  boosted_keywords: ['appointment', 'schedule', 'Dr. Smith'],
});

ステップ 3: エージェント構成の更新

await retell.agent.update(agent.agent_id, {
  voice_id: '11labs-Dorothy',  // Change voice
  end_call_after_silence_ms: 15000,
});

出力

• カスタム LLM プロンプトと関数呼び出し機能を備えたエージェント
• 音声と動作の設定
• 通話中のリアルタイム関数実行

エラーハンドリング

エラー	原因	解決策
関数が起動しない	プロンプトが関数の使用を誘導していない	プロンプトに関数の使用を含める
音声品質の問題	不適切な音声選択	異なる音声をテストする
通話が早期に終了	沈黙タイムアウトが短すぎる	end_call_after_silence_ms を増加させる

リソース

• Retell AI Documentation
• retell-sdk npm

次のステップ

電話管理: retellai-core-workflow-b