> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Ügynök teljes körű tesztelése (API)
> Futtasson előre definiált forgatókönyveket az ügynökén a test-calls API-val, hogy a regressziókat még azelőtt észlelje, mielőtt az ügyfelek hallanák őket.
Inkább az irányítópultot használja? Ugyanez a funkció elérhető a **Simulations**
(`/dashboard/simulations`) felületen is, beleértve az AI-forgatókönyvek létrehozását — lásd:
[Hívás szimulálása](/hu/guides/simulate-a-call). Ez az oldal a
programozott használatot ismerteti.
Egy AI-ügynök iteratív fejlesztése a prompt, az eszközök
és a szélsőséges esetek kezelésének iteratív fejlesztését jelenti. A **test-calls API**
valós (botok közötti vagy SIP-visszacsatolásos) hívásokat indít egy
ügynök ellen az Ön által megadott forgatókönyvprompt használatával — minden futtatás valós
hívásnaplót hoz létre átirattal, értékeléssel és számlázással, így
pontosan láthatja, hogyan viselkedik az ügynök, és mennyibe kerül.
Használja erre:
* Telepítés előtti gyors tesztek minden promptmódosítás után
* CI-be kötött regressziós tesztcsomagok (kapcsolja be a `test-call.completed` webhoookot
→ a build sikertelen legyen, ha a pontszám csökken)
* Egyidejűségi korlátok terheléses tesztelése
## Egyszeri futtatás: egyetlen futás
```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/test-calls \
-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
}'
```
Mezők:
| Mező | Típus | Kötelező | Leírás |
| ------------------- | ------- | -------- | ------------------------------------------------------------------------------------- |
| `target_type` | string | igen | `agent` vagy `phone_number` |
| `target_id` | integer | igen | Az ügynök azonosítója (vagy a telefonszám azonosítója) |
| `direction` | string | igen | `outbound` (a bot hívást indít) vagy `inbound` (a bot fogadja a hívást) |
| `scenario_prompt` | string | nem | Meghatározza, mit mond a tesztbot |
| `mode` | string | nem | `bot` (botok közötti, alapértelmezett) vagy `sip` (SIP-visszacsatolás) |
| `consent_to_charge` | boolean | **igen** | Értékének `true`-nak kell lennie. A teszthívások a normál díjszabás 2×-esébe kerülnek |
| `target_number` | string | nem | A bot hívóazonosítójának felülbírálása (E.164) |
A válasz egy [Teszthívás-futtatás objektum](/api-reference/test-calls#test-call-run-object)
`status="queued"` állapotban. Lekérdezéssel várjon addig, amíg a `status` értéke `completed` vagy
`failed` nem lesz; a `call_id` beállítása után töltse be az átiratot a
[`GET /v1/calls/{call_id}/transcript`](/api-reference/calls#get-transcript) végponton keresztül.
## Kötegek: párhuzamos forgatókönyvek
Futtasson N forgatókönyvet egyidejűleg — hasznos olyan regressziós tesztcsomagokhoz, amelyek
minden ismert szélsőséges esetet párhuzamosan lefednek:
```bash theme={null}
curl -X POST https://api.thunderphone.com/v1/test-call-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
}'
```
A válasz a gyermekfuttatások azonosítóinak `run_ids` listáját tartalmazza. A köteg
állapotának lekérése:
```bash theme={null}
curl https://api.thunderphone.com/v1/test-call-batches/{batch_id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
A `run_count` legfeljebb 20 lehet; a `stagger_seconds` elosztja az indításokat,
hogy ne terhelje túl az ügynököt (0–60 mp).
## Integrálja a CI-folyamatba
Hozzon létre kiadási kapuhoz tartozó tesztcsomagot a **Szimulációk**
(`/dashboard/simulations`) oldalon — válassza ki az ügynököt, adjon hozzá
forgatókönyveket manuálisan, vagy kattintson az **Forgatókönyvek generálása AI-val**
lehetőségre, hogy az ügynök promptja alapján elkészítse őket (opcionális
szélső esetekre vonatkozó ellenőrzéssel), majd csoportosítsa őket egy tesztcsomagba.
A tesztcsomag rögzíti a forgatókönyveit és az ügynököt, valamint egy minimális
sikerességi arányt és egy opcionális, nulla kritikus hibát előíró szabályt.
A sikeres futtatások lesznek az elfogadott alapvonal; a későbbi sikeres→sikertelen
átmenetek regresszióként jelennek meg.
Használjon [szervezeti API-kulcsot](/api-reference/developer-api-keys) a CI-ben.
Ez a szkript elindítja a tesztcsomagot, lekérdezi az állapotát az értékelés és
az összehasonlítás befejezéséig, és nem nulla kilépési kóddal fejeződik be,
ha az eredmény nem `pass`:
```bash theme={null}
#!/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
```
A `POST /v1/orgs/{org_id}/suites/{suite_id}/run` `202` választ ad vissza a
futtatási azonosítóval. A `GET /v1/orgs/{org_id}/suites/{suite_id}/runs/{run_id}`
a következőket adja vissza: `status`, `verdict`, `pass_rate`, `critical_failure_count`
és az alapvonalhoz tartozó `regressions` lista. Mindkét végpont az URL-ben szereplő
szervezetet az API-kulcs szervezetéhez köti.
## Minták
### Promptonkénti regressziós korpusz
Tartson fenn egy `{name, scenario_prompt, expected_outcome}` rekordokat tartalmazó
JSON-fájlt. Minden promptmódosításkor futtassa a teljes készletet kötegként; hasonlítsa
össze az átiratokat és az értékeléseket az előző futtatással.
### Kiadásonkénti gyors teszt
Öt, ideális esetet lefedő forgatókönyvből álló egyetlen köteg, amelyet minden
telepítés után futtat. Késleltetésérzékeny, ezért tartsa meg a
`stagger_seconds: 0` értéket.
### Késleltetési teljesítménymérés
Futtasson azonos forgatókönyveket különböző termékcsomagokon (`spark`,
`bolt`, `storm-base`). Hasonlítsa össze a `call.graded` pontszámokat és az
egyes létrejövő hívásnaplókból származó `duration_seconds` értékeket.
***
## Következő lépések
Minden lekérdezési paraméter, állapotkód és kötegstruktúra.
Pontozza automatikusan az összes tesztfuttatást a minőség időbeli követéséhez.
Jelöljön meg konkrét teszteket emberi felülvizsgálatra.
Továbbítsa az eredményeket a CI-be / Slackbe / PagerDutyba.