Skip to main content
GET
List test conversations
Cuando pruebas un agente en Playground, Nexor crea un lead de prueba para esa conversación. Los leads de prueba nunca aparecen en las listas de leads, así que este endpoint es la forma de volver a encontrarlos. Úsalo para revisar qué respondió el agente en una prueba que salió mal, antes de cambiar sus instrucciones. Devuelve primero tus pruebas más recientes, con la tarea en que corrió cada una y sus últimos mensajes.

Antes de empezar

  • Las llaves MCP necesitan leads:read. Las llaves REST de acceso completo no necesitan nada más.
  • Solo devuelve pruebas de Playground. Nunca incluye leads reales.
  • Es solo de lectura: consultarlo no le envía nada a nadie.
  • Los errores devuelven un código estable en error, por ejemplo invalid_limit. Asocia cada código a tus propios textos.

Qué consultar

Qué devuelve

Leer qué hizo el agente

Con el MCP de Nexor, pasa lead_id a list_lead_turns y get_lead_turn. Cada turno muestra la respuesta del agente, las herramientas que llamó y cualquier error de herramienta. Así sabes si el problema está en las instrucciones, en una herramienta o en algo que la plataforma todavía no hace.

Límites

  • Hasta 25 conversaciones por consulta.
  • El texto de cada mensaje se corta en 280 caracteres. Las API keys, los tokens y las firmas aparecen enmascarados. Lo que escribió quien probó se devuelve tal cual, así que trátalo como datos de conversación.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de consulta

workflow_id
string<uuid>

Task ID (workflow in the API). Only tests that ran on that task. A malformed ID returns 400 invalid_workflow_id; a task from another account returns an empty list.

limit
integer
predeterminado:10

How many conversations to return. Any other value returns 400 invalid_limit.

Rango requerido: 1 <= x <= 25

Respuesta

Test conversations, newest activity first.

success
boolean
requerido
conversations
object[]
requerido
Maximum array length: 25
Última modificación el 2 de octubre de 2026