get-executions

Bolna の実行を取得する

エンドポイント

• 実行を取得：GET https://api.bolna.ai/executions/{execution_id}
• 生ログを取得：GET https://api.bolna.ai/executions/{execution_id}/log
• エージェントの実行一覧を取得：GET https://api.bolna.ai/v2/agent/{agent_id}/executions
• バッチの実行一覧を取得：GET https://api.bolna.ai/batches/{batch_id}/executions

Authorization: Bearer $BOLNA_API_KEY を使用します。

実行オブジェクト

次のようなフィールドが含まれます。

• id、agent_id、batch_id
• conversation_time、total_cost、cost_breakdown
• status、error_message、answered_by_voice_mail
• transcript、recording_url
• created_at、updated_at
• telephony_data：プロバイダー、発信先／発信元の電話番号、通話タイプ、プロバイダーの通話 ID、切断理由／コード、呼び出し時間、ダイヤル後遅延、通信事業者の詳細。
• transfer_call_data：転送された通話の詳細。
• batch_run_details：再試行とバッチのメタデータ。
• extracted_data：処置または抽出プロンプトから得られた構造化データ。
• context_details：コンテキスト変数と関連メタデータ。

対応するステータス

一般的なステータスには、scheduled、queued、rescheduled、initiated、ringing、in-progress、call-disconnected、completed、balance-low、busy、no-answer、canceled、failed、stopped、error があります。

completed は、音声が終了しただけの状態ではなく、後処理が完了した状態として扱ってください。

単一の実行

curl --request GET \
  --url "https://api.bolna.ai/executions/$EXECUTION_ID" \
  --header "Authorization: Bearer $BOLNA_API_KEY"

生ログ

curl --request GET \
  --url "https://api.bolna.ai/executions/$EXECUTION_ID/log" \
  --header "Authorization: Bearer $BOLNA_API_KEY"

レイテンシのデバッグ、プロンプトの確認、プロバイダーとのリクエスト／レスポンスの問題、ツール呼び出しの失敗、または予期しないモデル出力の調査には、生ログを使用します。

ページネーションされたエージェントの履歴

curl --request GET \
  --url "https://api.bolna.ai/v2/agent/$AGENT_ID/executions?page_number=1&page_size=50" \
  --header "Authorization: Bearer $BOLNA_API_KEY"

次のページを取得するには、has_more を使用します。page_size の最大値は 50 です。

デバッグ用マップ

• 長い間がある場合：トランスクライバーのエンドポインティング、LLM のレイテンシ、シンセサイザーのレイテンシ、incremental_delay を確認します。
• ユーザーの発話が途中で切れる場合：number_of_words_for_interruption を増やすか、エンドポインティングを調整します。
• 無音状態で切断される場合：hangup_after_silence、call_terminate、切断コードを確認します。
• Webhook が届かない場合：ここで実行ステータスを取得し、次に setup-webhook の設定を確認します。
• コストが急増した場合：conversation_time、再試行履歴、cost_breakdown を調べます。

完全なトリアージ手順については、debug-bolna-calls/SKILL.md と debug-bolna-calls/references/latency-metrics.md を参照してください。

スクリプト

# Paginate through all executions for an agent
python3 get-executions/scripts/fetch_executions_paginated.py --agent-id $AGENT_ID

関連項目

• https://raw.githubusercontent.com/bolna-ai/skills/main/references/execution-payload.md — 実行オブジェクトのすべてのフィールドをまとめて確認できます。
• https://raw.githubusercontent.com/bolna-ai/skills/main/references/call-statuses.md — ライフサイクル全体と終端ステータスのパターンを確認できます。
• https://raw.githubusercontent.com/bolna-ai/skills/main/references/hangup-codes.md — hangup_by + hangup_code + hangup_reason の解釈を確認できます。
• setup-webhook — 同じ形式のペイロードをリアルタイムでプッシュします。
• debug-bolna-calls — 実行情報と生ログに基づく、症状と解決策の対応表です。