sempera-debug-call
/sempera-debug-call
Ustala przyczynę błędnego połączenia lub rozmowy w Sempera na podstawie zapisu, transkrypcji, osi narzędzi i dostarczenia webhooka.
- Autor
- Sempera-AI ↗
- Repozytorium
- sempera-ai ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 05.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 05.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Ustala przyczynę błędnego połączenia lub rozmowy w Sempera na podstawie zapisu, transkrypcji, osi narzędzi i dostarczenia webhooka.
Oryginalny opis (EN)
Work out why a Sempera call or conversation went wrong, from the call record, transcript, tool timeline and webhook delivery. Use when a call failed, an agent said something wrong, or a webhook did not arrive.
Jak działa
- Steps
- Rules
Podgląd SKILL.md
---
name: sempera-debug-call
description: Work out why a Sempera call or conversation went wrong, from the call record, transcript, tool timeline and webhook delivery. Use when a call failed, an agent said something wrong, or a webhook did not arrive.
---
# Debug a call
Read first, change nothing until you know the cause.
## Steps
1. **Get the record.** `GET /v1/calls/{call_id}` (MCP `get_call`; CLI `sempera calls get <id>`). Note the status, direction, duration and the agent version that took it. If you only have an agent, `GET /v1/calls?agent_id=...` lists newest first.
2. **Read the conversation.** `GET /v1/sessions/{call_id}` (`get_conversation`) gives the turns, the tool timeline, captured variables, outcome and the version that spoke. Find the first turn where the call went wrong.
3. **Classify.**
- *Wrong words*: the instructions or knowledge of that version are at fault. Read that version with `GET /v1/agents/{agent_id}/versions/{version_id}`, reproduce with a typed turn, `POST /v1/agents/{agent_id}/preview` with `{"message": "..."}` (its `version` field defaults to `draft`), fix the draft, and follow `sempera-build-agent`.
- *A tool failed*: the tool timeline shows the failing step. Fix the tool or the system it calls; do not change the agent's words to hide it.
- *No call happened*: for an outbound call, read the refusal. Common ones are outside calling hours (`409`, `outside_sending_hours`), the number on the do-not-contact list, a reached outbound cap (`429 rate_limited` with `retry_after_s`) and a missing scope (`403 insufficient_scope`). These are working as designed; report them.
- *Call not stored*: the number may not be bound to the agent. Check `GET /v1/phone-numbers?agent_id=...`.
4. **A webhook did not arrive.** `GET /v1/webhooks/{id}/deliveries` is the delivery log, one row per attempt. Check the endpoint is enabled and subscribed to the event, and that your server answered `2xx` within 10 seconds. `POST /v1/webhooks/{id}/test` sends one signed `webhook.test`.
5. **A signature does not verify.** The header `X-Sempera-Signature` is `t=<unix seconds>,v1=<hex>`, the HMAC-SHA256 of `"<t>." + raw_body` keyed with the endpoint secret. Verify the exact raw bytes before parsing JSON. To check a captured delivery locally: `sempera webhooks verify --signature '<header>' --body-file body.json` with `SEMPERA_WEBHOOK_SECRET` set, or the MCP tool `verify_webhook_signature`. Delivery is at least once: drop repeats by `X-Sempera-Event-Id`.
6. **Ask the user for the missing piece, not for a larger key.** If a read is refused for scope, say which scope.
## Rules
- Quote the API's error `code` and `request_id`; they are what support needs.
- Transcripts hold personal data: summarise, do not paste them elsewhere.
- Do not place a new call to reproduce a problem unless the user names the person and confirms (`sempera-send-call`).
Wersje
W bazie nie ma innych skilli o nazwie sempera-debug-call.
Migawka bazy z 13.11.2026 · wersja paczki d68acf0ceeb8 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100sempera-build-agent
Tworzy agenta telefonicznego Sempera, edytuje jego szkic, testuje go w podglądzie tekstowym i publikuje. - 90sempera-read-conversations
Wyświetla listę połączeń i rozmów w Sempera wraz z transkrypcjami i czyta je, gdy trzeba sprawdzić, co mówili rozmówcy. - 100debug-lab
Znajduje prawdziwą przyczynę trudnych błędów, spowolnień, niestabilnych awarii i zawieszonych przepływów, a potem naprawia je u źródła. - 90shopify-webhook-topic
Dodaje lub zmienia obsługę webhooka Shopify w Order Hub, na przykład zamówień, klientów, zwrotów lub produktów, i sposób zapisu jego danych.