> ## Documentation Index > Fetch the complete documentation index at: https://docs.zelto.ai/llms.txt > Use this file to discover all available pages before exploring further. # Listar benchmarks > Benchmarks de la organización, los actualizados más recientemente primero, con sus últimas ejecuciones. ## OpenAPI ````yaml /es/docs-openapi.json get /v1/benchmarks openapi: 3.1.0 info: title: API REST de Zelto version: v1 description: >- Acceso programático a tu organización de Zelto. Cada endpoint está limitado a la organización a la que pertenece la clave de API. Crea una clave en Configuración → Integraciones → Integración por API. servers: - url: https://api.zelto.ai description: Producción security: - bearerAuth: [] tags: - name: Monitors description: Exportaciones filtradas y asíncronas de resultados guardados de monitores. - name: Agentes description: >- Agentes de IA de voz y texto normalizados mediante el flujo de ingestión de Zelto. - name: Conversaciones description: >- Conversaciones de voz y texto (llamadas, chats y mensajes de voz), junto con sus transcripciones y grabaciones. - name: Métricas del cliente description: >- Evaluaciones proporcionadas por el cliente y asociadas a una conversación. Requiere que las métricas estén habilitadas. - name: Revisiones description: Estado de revisión humana de las conversaciones. - name: Colas de revisión description: Agrupa y dirige conversaciones para revisarlas por lotes. - name: Empresas description: Clientes o marcas para los que trabajan tus agentes, y sus logos. - name: Hallazgos description: >- Problemas estructurados descubiertos durante el análisis, con conversaciones y comentarios opcionales. - name: Experimentos description: >- Medición prospectiva de dos versiones de prompt enrutadas externamente mediante resultados de monitores independientes. - name: Organizaciones description: >- Aprovisionamiento de organizaciones sin interfaz. Requiere una clave de API de administrador o servicio. - name: Proveedores de IA description: >- Las claves propias de tu organización para proveedores de IA (trae tu propia clave). Los monitores pueden ejecutarse con ellas en lugar de los modelos integrados de Zelto. Solo propietarios o administradores; el secreto es de solo escritura. - name: Benchmarks description: >- Evaluaciones repetibles de prompts, modelos y motores de voz a texto de tus agentes sobre un conjunto fijo de casos, puntuadas por Judges. paths: /v1/benchmarks: get: tags: - Benchmarks summary: Listar benchmarks description: >- Benchmarks de la organización, los actualizados más recientemente primero, con sus últimas ejecuciones. operationId: listBenchmarks parameters: - name: kind in: query required: false description: Solo benchmarks `llm` o solo `stt`. schema: type: string enum: - llm - stt - name: agentId in: query required: false description: >- Conservar los benchmarks asignados a cualquiera de estos agentes. Repite el parámetro para varios. schema: type: array items: type: string format: uuid - name: archived in: query required: false description: >- Benchmarks archivados: excluidos (predeterminado), incluidos o los únicos listados. schema: type: string enum: - exclude - include - only - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Cursor' responses: '200': description: Respuesta correcta. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/BenchmarkSummary' nextCursor: description: Cursor de la página siguiente, o null en la última página. type: - string - 'null' required: - data - nextCursor '400': $ref: '#/components/responses/ValidationFailed' '401': $ref: '#/components/responses/Unauthorized' components: parameters: Limit: name: limit in: query required: false description: >- Elementos por página. Predeterminado 50, máx. 200 (los valores mayores se limitan a 200). Debe ser un entero positivo; cualquier otro valor se rechaza con un 400 `invalid_parameter`. schema: type: integer minimum: 1 maximum: 200 default: 50 Cursor: name: cursor in: query required: false description: >- Cursor de paginación opaco. Envía el `nextCursor` devuelto por la página anterior, sin modificar. Un cursor que esta API no emitió se rechaza con un 400 `invalid_parameter`. Los endpoints de listado también responden 400 `unknown_query_parameter` (con los nombres válidos) ante cualquier parámetro de consulta que no aceptan, así que un filtro mal escrito como `agent_id` nunca se ignora en silencio. schema: type: string schemas: BenchmarkSummary: type: object properties: id: type: string name: type: string description: type: - string - 'null' kind: type: string enum: - llm - stt agents: type: array items: $ref: '#/components/schemas/BenchmarkAgentRef' caseCount: type: integer description: Casos activos en la versión publicada actual. draftCaseCount: description: >- Casos que publicaría el borrador abierto; null si el benchmark no tiene borrador. anyOf: - type: integer - type: 'null' validatorKinds: type: array items: type: string enum: - judge - code - builtin runs: type: array items: $ref: '#/components/schemas/BenchmarkListRun' description: Ejecuciones más recientes, la más nueva primero (como máximo 5). createdAt: type: string description: Marca de tiempo ISO 8601. updatedAt: type: string description: Marca de tiempo ISO 8601. archivedAt: anyOf: - type: string description: Marca de tiempo ISO 8601. - type: 'null' settings: $ref: '#/components/schemas/BenchmarkSettings' language: type: - string - 'null' currentVersion: anyOf: - type: integer - type: 'null' hasDraftChanges: type: boolean required: - id - name - description - kind - agents - caseCount - validatorKinds - runs - createdAt - updatedAt description: Un benchmark de la lista. BenchmarkAgentRef: type: object properties: id: type: string name: type: string required: - id - name description: Un agente al que está asignado el benchmark. BenchmarkListRun: type: object properties: id: type: string number: type: integer status: type: string enum: - queued - running - completed - failed - cancelled - awaiting_approval - rejected totalCells: type: integer completedCells: type: integer failedCells: type: integer erroredCells: type: integer allErrored: type: boolean candidates: type: array items: $ref: '#/components/schemas/BenchmarkCandidate' results: type: array items: type: object properties: candidateId: type: string passRate: type: - number - 'null' wer: type: - number - 'null' p50LatencyMs: type: - number - 'null' costUsd: type: - number - 'null' required: - candidateId - passRate - wer - p50LatencyMs - costUsd estimatedCostUsd: type: number actualCostUsd: type: - number - 'null' createdBy: type: string createdByUser: $ref: '#/components/schemas/BenchmarkRunAuthor' createdAt: type: string description: Marca de tiempo ISO 8601. finishedAt: anyOf: - type: string description: Marca de tiempo ISO 8601. - type: 'null' required: - id - number - status - totalCells - completedCells - failedCells - erroredCells - allErrored - candidates - results - estimatedCostUsd - actualCostUsd - createdBy - createdByUser - createdAt - finishedAt description: >- Una ejecución reciente tal como aparece en la lista de benchmarks (resultados completos: los endpoints de ejecuciones). BenchmarkSettings: type: object properties: passBar: anyOf: - type: number minimum: 0 maximum: 1 - type: 'null' description: >- El objetivo: tasa mínima de aprobación (LLM), WER máximo (STT) (ambos 0..1). Nulo = sin objetivo. defaultRepeats: type: integer minimum: 1 maximum: 3 description: Repeticiones con las que empieza una ejecución nueva (solo LLM). defaultCandidates: maxItems: 10 type: array items: type: object properties: model: type: string minLength: 1 maxLength: 200 agentVersionId: anyOf: - type: string minLength: 1 maxLength: 100 - type: 'null' required: - model - agentVersionId required: - passBar - defaultRepeats - defaultCandidates description: Valores predeterminados de ejecución del benchmark. No se versionan. Error: type: object required: - error properties: error: type: string description: >- Nombre corto del error: `Unauthorized`, `Validation failed`, `Not found` o un código estable en snake_case que puedes comparar en tu código, como `unknown_query_parameter`, `invalid_parameter`, `payload_too_large` o `not_found`. message: type: string description: Una frase en lenguaje claro que explica qué falla y cómo corregirlo. code: type: string description: >- Causa estable y legible por máquina; compara con este valor y no con `error` ni `message`. En un 401: `missing_credentials`, `malformed_credentials`, `ingest_key_not_allowed` (se usó una clave de ingesta de observabilidad, solo de escritura, en un endpoint que requiere una clave API), `key_expired` o `invalid_credentials`. En otros casos, por ejemplo: `not_found`, `invalid_parameter`, `unknown_query_parameter`, `missing_parameter`, `validation_failed`, `invalid_json`, `payload_too_large`, `conversation_not_found`, `plan_required`. hint: type: string description: >- El siguiente paso a probar: dónde encontrar el id correcto, qué parámetros acepta el endpoint, cómo mejorar el plan o cómo autenticarte. parameter: type: string description: 'Con `invalid_parameter`: el parámetro de consulta rechazado.' unknown: type: array items: type: string description: >- Con `unknown_query_parameter`: los parámetros enviados que este endpoint no acepta. valid: type: array items: type: string description: >- Con `unknown_query_parameter`: los parámetros que acepta este endpoint. details: type: object additionalProperties: true BenchmarkCandidate: type: object properties: id: type: string label: type: string model: type: string description: 'LLM: "openrouter/anthropic/claude-…"; STT: "deepgram/nova-3".' agentVersionId: description: Solo LLM. Null = el prompt tal como se grabó en cada caso. type: - string - 'null' agentVersionLabel: type: - string - 'null' isReference: type: boolean required: - id - label - model - agentVersionId - agentVersionLabel description: >- Lo que compara una ejecución: un modelo más una fuente de prompt, o un motor de STT. BenchmarkRunAuthor: type: object properties: id: type: string name: type: string image: type: - string - 'null' required: - id - name - image description: Un miembro de la organización. responses: ValidationFailed: description: >- El cuerpo o la cadena de consulta de la solicitud han fallado en la validación. `code` indica el tipo (`validation_failed`, `invalid_json`, `invalid_parameter`, `unknown_query_parameter`, `missing_parameter`) y un filtro con valores fijos lista los permitidos en `valid` (se comprueba cada valor repetido: `?status=open&status=zz` es un 400). Un cuerpo `validation_failed` incluye además `message` (los primeros campos que fallan), `hint` (cómo corregirlo, por ejemplo que la `description` de un hallazgo es un documento JSON de TipTap y no una cadena) y `details` (nombre del campo y mensajes). content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: >- Clave API faltante o no válida. El cuerpo indica la causa en `code` (por ejemplo `ingest_key_not_allowed` cuando se usa aquí una clave de ingesta, solo de escritura), con un `message` y un `hint`. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer description: >- Envía `Authorization: Bearer YOUR_API_KEY`. La clave corresponde a una sola organización. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.