Skip to main content
The respan driver connects Polyglot Decision to RESPAN’s hosted POST /api/v1/scores endpoint. Span-01 evaluates plain-language behavior definitions against one conversation span and returns present, absent, and not-observable probabilities.

Configure the driver

Set the RESPAN API key:
Then select the bundled preset:
The preset targets https://api.respan.ai/api/v1/scores with span-01-free. Override the model with span-01-pro when the organization has Span-01 access and sufficient credits.

Conversation input

RESPAN requires an explicit conversation boundary. Pass a JSON object whose input list contains preceding messages and whose output object contains the single turn being judged:
The adapter does not guess conversation turns from a string or unstructured list. Each message must have text content; role is optional but must be a non-empty string when present.

Primitive and answer semantics

Noul instructions become the behavior definition. Optional true and false criteria are rendered as explicit Present when and Absent when guidance. RESPAN evaluates all behaviors independently against the same span. NoulAnswer::probability() remains the positive/present probability. The full NoulProbabilities value exposes positive, negative, and unknown values. confidence() is the greater of positive and negative; it never treats not-observable probability as evidence for absence.

Usage, identity, and failures

  • usage.input_tokens becomes DecisionUsage::inputTokens().
  • Output tokens remain unknown because Span-01 does not generate output.
  • X-Respan-Log-Id becomes DecisionResponse::providerRequestId().
  • HTTP 429 and transient dependency/service failures use the normal Decision retry policy and preserve Retry-After.
  • Missing credentials, unavailable organization entitlement, and insufficient pro credits are non-retryable and reported separately from invalid payloads.
The bundled model records advertise zero pricing for span-01-free and $0.02 per million input tokens for span-01-pro. No token ceiling is recorded because RESPAN does not publish a numeric limit. The initial driver deliberately does not send respan_params. Polyglot does not implicitly export telemetry identities or metadata as provider logging data.