observability

Generate a test scenario from an insight failure mode

Changed on

Turn one failure mode of a metric failure-mode insight into a test scenario that reproduces the issue against a target agent. Choose the failure mode with failure_mode_index and the agent with agent. Set redact_transcripts to strip personal identifiers from the source call transcripts before they are used to draft the scenario. Pass folder_path to file the generated scenario under an existing scenario folder; it lands in the project's default folder otherwise. Runs in the background and returns a progress_id; poll scenario generation progress to retrieve the generated scenario id.

post/observability/v1/metric-failure-mode-insights/{id}/generate-scenario/

Request

  • Base URL
    https://api.cekura.ai
  • URL
    https://api.cekura.ai/observability/v1/metric-failure-mode-insights/{id}/generate-scenario/
  • Auth
    • API key in header X-CEKURA-API-KEY
    • or HTTP bearer
    • or HTTP bearer
    • or HTTP bearer

Path parameters

idinteger required

A unique integer value identifying this metric failure mode insight.

Request body

failure_mode_indexinteger required

Zero-based index of the failure mode within the insight's failure_modes list.

agentinteger required

ID of the agent the generated scenario should target.

redact_transcriptsboolean

If true, strip personal identifiers (names, contact details, financial, credentials, ID/health numbers) from the example call transcripts before they are used to draft the scenario. Semantic context (dates, locations, amounts, intent) is preserved. Defaults to false.

folder_pathstring

Path of the scenario folder the generated scenario should land in (e.g. "Sales.Inbound"), as returned by GET /test_framework/v1/scenarios/folders/. Omit to use the project's default folder.

Response

failure_mode_indexinteger required

Zero-based index of the failure mode within the insight's failure_modes list.

agentinteger required

ID of the agent the generated scenario should target.

redact_transcriptsboolean

If true, strip personal identifiers (names, contact details, financial, credentials, ID/health numbers) from the example call transcripts before they are used to draft the scenario. Semantic context (dates, locations, amounts, intent) is preserved. Defaults to false.

folder_pathstring

Path of the scenario folder the generated scenario should land in (e.g. "Sales.Inbound"), as returned by GET /test_framework/v1/scenarios/folders/. Omit to use the project's default folder.

Changes