Phrokを使った電話通話
AI音声エージェントが電話をかけ、ユーザーに代わってAIアシスタントとして自己紹介し、与えられた目標を追求し、文字起こし、要約、結果を報告します。
ツール
make_call(to, goal, context?, language?, max_minutes?)— 今すぐ電話をかけます。to: 国コード付きのE.164形式(例:+14155550123)。ローカル形式から変換します。国が不明な場合は確認します。goal: 通話で達成すべきことを1~2文で指定します。context: エージェントが使用できるすべての事実(名前、日付、予約参照番号、許容可能な代替案など)。エージェントはこれ以外の情報を決して発明しません。language:en(デフォルト)、de、arなど(英語以外はProプランが必要です)。
schedule_call(..., scheduled_for)— 将来のISO-8601時刻に同じ通話を予約します。get_call(call_id)— ステータス、文字起こし、要約、結果を取得します。list_calls()、hangup_call(call_id)、get_account()(プラン、残分数、クレジット、発信者ID)。
通話の実行方法
- ユーザーに番号、目標、コンテキスト、言語を表示し、
make_callまたはschedule_callの前に明示的な「はい」を待ちます。確認なしで決して電話をかけないでください。 make_callの後、約20秒待ってから、15~20秒ごとにget_callをポーリングし、ステータスがcompleted、busy、no_answer、voicemail、failed、またはcanceledになるまで続けます。- 結果を2~4行で報告します:結果、重要な事実(時間、価格、確認番号)、ユーザーが行うべきこと。文字起こしを提供します。
- 話中または応答なしの場合:その旨を伝え、
schedule_callで後で再試行することを提案します。
ルール
- ユーザーが電話をかけるように依頼した番号にのみ電話をかけます。緊急番号やプレミアム料金番号、電話をかけないでほしいと依頼した人には決してかけないでください。
- エージェントに人間のふりをさせること、支払い、何かに登録すること、またはコンテキストを超えた個人データの共有を決して依頼しないでください。
- 通話が拒否された場合(例:「メールを確認してください」、「残分数が不足しています」)、ユーザーにその理由を伝え、エラーメッセージ内のリンクを共有します。自動的に再試行しないでください。