ThunderPhone v3 је сада доступан.Почните самостално, већ од 2 ¢/мин.Прочитајте објаву

Developer cookbook

Тестирајте агента од почетка до краја (API)

Покрените једнократне симулације, паралелне пакете сценарија и скупове за контролу издања преко ThunderPhone API-ја да бисте открили регресије агента пре него што их клијенти чују.

Итерирање AI агента подразумева итерирање његовог упита, алата и начина на који обрађује граничне случајеве. API за симулације покреће стварне позиве ка агенту користећи упит сценарија који наведете. Циљање агента креира извршавање од бота до бота; циљање броја телефона креира SIP повратни тест. Свако извршавање производи стварни запис позива са транскриптом, оцењивањем и обрачуном, тако да тачно видите како се агент понаша и колико кошта.

Користите га за:

  • Smoke тестове пре објављивања након сваке измене упита
  • Регресионе пакете повезане са CI-јем (повежите webhook test-call.completed → неуспешно завршите изградњу ако оцена падне)
  • Тестирање ограничења конкурентности под оптерећењем

Једнократно: једно извршавање

curl -X POST https://api.thunderphone.com/v1/simulations \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_type":     "agent",
    "target_id":       12,
    "direction":       "outbound",
    "scenario_prompt": "You are a polite caller asking about refund policy for order 12345.",
    "consent_to_charge": true
  }'

Поља:

ПољеТипОбавезноОпис
target_typeстрингдаagent или phone_number
target_idцео бројдаID агента (или ID броја телефона)
directionстрингнеoutbound (подразумевано; тест позивалац позива) или inbound (тест позивалац одговара)
scenario_promptстрингнеОдређује шта тест бот говори
language / primary_languageстрингнеЈезик тест позиваоца; неподржани кодови се одбијају
contextстрингнеКонтекст позива у слободном тексту за ово покретање
simulator_productстрингнеtesting (подразумевано) или spark за симулираног позиваоца који више личи на човека, као што су тестови консултације при топлом преносу
consent_to_chargeлогичка вредностдаМора бити true. Страна изабраног агента се наплаћује као стварни позив. Симулирани позивалац се урачунава у цену позива по минутном тарифном моделу и има исту маржу као било који други део, без посебне накнаде (налози са ранијим ценовником за њега плаћају фиксну цену по минуту до 1. децембра 2026), плус сваки телекомуникациони сегмент (ценовник)
target_numberстрингнеE.164 замена за удаљену страну; у супротном се користи тест број платформе

mode је само за читање и изведен је из target_type: agent производи mode="bot", док phone_number производи mode="sip".

Одговор је објекат извршавања симулације са status="queued". Проверавајте док status не постане completed или failed; када је call_id постављен, учитајте транскрипт путем GET /v1/calls/{call_id}/transcript.

Пакети: паралелни сценарији

Покрените N сценарија истовремено — корисно за регресионе пакете који паралелно обухватају сваки познати гранични случај:

curl -X POST https://api.thunderphone.com/v1/simulations/batches \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_type":     "agent",
    "target_id":       12,
    "direction":       "outbound",
    "run_count":       5,
    "stagger_seconds": 2,
    "scenario_prompts": [
      "Ask about refund policy.",
      "Ask for hours of operation.",
      "Complain about a delayed shipment.",
      "Ask to speak with a human.",
      "Ask an unrelated trivia question."
    ],
    "consent_to_charge": true
  }'

Одговор садржи листу run_ids са ИД-јевима подређених извршавања. Преузмите статус пакета:

curl https://api.thunderphone.com/v1/simulations/batches/{batch_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

run_count је ограничен на 20; stagger_seconds распоређује покретање како се агент не би преоптеретио (0–60 s).

Укључите у CI

Направите пакет контролне тачке издања на страници Симулације (/dashboard/simulations) — изаберите агента, ручно додајте сценарије или кликните на Генеришите сценарије помоћу AI да бисте их направили на основу упита агента (уз опционалну проверу граничних случајева) и групишите их у пакет. Пакет фиксира своје сценарије и агента, као и минималну стопу пролазности и опционо правило без критичних неуспеха. Успешна покретања постају прихваћена основа; каснији прелази из проласка у неуспех враћају се као регресије.

Користите API кључ организације у CI-ју. Ова скрипта покреће пакет, проверава статус док се оцењивање и поређење не заврше и завршава се кодом различитим од нуле осим ако је пресуда pass:

#!/usr/bin/env bash
set -euo pipefail
 
: "${THUNDERPHONE_API_KEY:?Set THUNDERPHONE_API_KEY}"
: "${THUNDERPHONE_ORG_ID:?Set THUNDERPHONE_ORG_ID}"
: "${THUNDERPHONE_SUITE_ID:?Set THUNDERPHONE_SUITE_ID}"
 
base="https://api.thunderphone.com/v1/orgs/${THUNDERPHONE_ORG_ID}/suites/${THUNDERPHONE_SUITE_ID}"
auth="Authorization: Bearer ${THUNDERPHONE_API_KEY}"
 
run_id="$(curl --fail --silent --show-error -X POST "${base}/run" \
  -H "$auth" -H "Content-Type: application/json" -d '{}' | jq -r '.id')"
 
deadline=$((SECONDS + 1800))
while (( SECONDS < deadline )); do
  result="$(curl --fail --silent --show-error \
    "${base}/runs/${run_id}" -H "$auth")"
  status="$(jq -r '.status' <<<"$result")"
  if [[ "$status" == "completed" ]]; then
    jq . <<<"$result"
    [[ "$(jq -r '.verdict' <<<"$result")" == "pass" ]]
    exit
  fi
  sleep 10
done
 
echo "ThunderPhone suite timed out" >&2
exit 1

POST /v1/orgs/{org_id}/suites/{suite_id}/run враћа 202 са ИД-ом покретања. GET /v1/orgs/{org_id}/suites/{suite_id}/runs/{run_id} враћа status, verdict, pass_rate, critical_failure_count и листу regressions основе. Обе крајње тачке повезују организацију из URL-а са организацијом API кључа.

Покрените пакет по распореду

Отворите картицу агента Симулирајте, изаберите Пакети контролне тачке издања и направите или измените пакет. Укључите Покрени по распореду, изаберите Учесталост и Временска зона, а затим подесите Минут после пуног сата, Локално време или Дан како је приказано. Изаберите Сачувајте пакет. Искључивањем опције Покрени по распореду уклањате распоред са контролне табле.

Путем API-ја

PATCH-ујте пакет да бисте додали или заменили његов распоред. Погледајте Пакети (контролне тачке издања) за комплетан објекат пакета и крајње тачке.

curl -X PATCH https://api.thunderphone.com/v1/suites/{suite_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "schedule": {
      "enabled": true,
      "frequency": "daily",
      "timezone": "America/Chicago",
      "hour": 6,
      "minute": 30
    }
  }'

frequency може бити hourly, daily или weekly. Користите IANA временску зону. Распореди по сату користе minute; дневни распореди користе hour и minute; недељни распореди користе и weekday, где је понедељак 0, а недеља 6. Одговор пакета садржи next_run_at и last_run_at.

Времена прате промене летњег рачунања времена у изабраној временској зони. Заказана покретања приказују се у историји покретања пакета и користе његовог тренутног агента, сценарије, критеријуме и прихваћену основу. Сваки генерисани тест позив емитује test-call.completed; не постоји webhook за завршетак на нивоу пакета. Заказани позиви се наплаћују по истој стопи симулације као ручна покретања пакета и бележе trigger: "schedule" у покретању пакета.

Да бисте паузирали распоред без промене времена, PATCH-ујте комплетан постојећи објекат распореда са "enabled": false. frequency је обавезан; изостављена временска зона и временска поља враћају се на подразумеване вредности, зато укључите постојеће вредности. Пошаљите "schedule": null да бисте уклонили распоред.

Обрасци

Регресиони корпус по промпту

Одржавајте JSON датотеку са торкама {name, scenario_prompt, expected_outcome}. При свакој измени промпта, покрените цео скуп као пакет; упоредите транскрипте и оцене са претходним покретањем.

Smoke тест по издању

Један пакет од пет сценарија са очекиваним током које покрећете после сваког постављања. Осетљиво на кашњење, зато задржите stagger_seconds: 0.

Мерење кашњења

Покрените идентичне сценарије са различитим подешавањима: интелигенцијом (core, pro), слушањем (audio_tier: lite, standard, plus, max) или временом одговора (endpointing). Упоредите резултате call.graded и duration_seconds из сваког добијеног евиденционог записа позива.

За агенте за веб-сајтове, пробна покретања се извршавају у прегледачу уместо упућивања телефонског позива.


Следећи кораци