> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar ejecuciones creadas por un programa de evaluación

> Devuelve las ejecuciones de eval que fueron creadas por el programa dado.



## OpenAPI

````yaml https://apigw.mka1.com/speakeasy.json?language=es get /api/v1/llm/evals/schedules/{schedule_id}/runs
openapi: 3.1.1
info:
  title: MKA1 API
  version: 1.1.0
  description: >-
    La API MKA1 es una API RESTful que proporciona acceso a la plataforma MKA1.
    Aprende cómo comenzar con la API y el SDK de TypeScript
    [aquí](https://mka1.apidocumentation.com/guides/getting-started).
  license:
    name: Propietario
servers:
  - url: https://apigw.mka1.com
    description: MKA1 API Gateway
  - url: /
    description: Relative server URL (configurable via SDK constructor)
security: []
tags:
  - name: Resource Authorization
    description: >-
      Gestiona permisos para recursos LLM. Crea recursos, otorga/revoca permisos
      y elimina recursos. Solo los propietarios de recursos pueden otorgar,
      revocar o eliminar permisos.
    x-displayName: Autorización de Recursos
  - name: Embeddings
    description: >-
      Puntos finales de la API de incrustación de texto para generar
      representaciones vectoriales del texto. Crea incrustaciones semánticas
      para búsqueda, agrupamiento y coincidencia de similitudes utilizando
      varios modelos de incrustación.
    x-displayName: Incrustaciones
  - name: Feedback
    description: >-
      API de retroalimentación del usuario para calificar y comentar sobre las
      completaciones de chat. Recopila calificaciones de pulgares arriba/abajo y
      comentarios detallados para mejorar las respuestas del modelo y rastrear
      la satisfacción del usuario.
    x-displayName: Retroalimentación
  - name: Images
    description: >-
      Puntos finales de la API de generación de imágenes para crear imágenes a
      partir de descripciones de texto. Genera imágenes con control sobre el
      tamaño, la calidad y el estilo.
    x-displayName: Imágenes
  - name: MCP Vault
    description: >-
      API de bóveda MCP para almacenar configuraciones de servidor MCP propiedad
      del usuario y credenciales encriptadas. Los agentes hacen referencia a los
      ID de la bóveda para que los secretos se resuelvan solo en el momento de
      la ejecución de la herramienta.
    x-displayName: Bóveda MCP
  - name: Speech
    description: >-
      Puntos finales de la API de voz para el procesamiento de audio. Convierte
      texto en habla natural (TTS) o transcribe el habla a texto (STT) en
      diferentes idiomas.
    x-displayName: Discurso
  - name: Usage
    description: >-
      API de seguimiento de uso y análisis para monitorear el consumo de tokens,
      la cantidad de solicitudes y el análisis de costos. Visualiza estadísticas
      detalladas por usuario, modelo y período de tiempo.
    x-displayName: Uso
  - name: Extract
    description: >-
      API de extracción de datos estructurados para extraer información de
      archivos. Define esquemas JSON para extraer datos estructurados de
      imágenes, PDFs y documentos. Soporta plantillas de esquemas reutilizables.
    x-displayName: Extracción
  - name: Text Classification
    description: >-
      API de clasificación de texto para categorizar texto en etiquetas
      predefinidas. Utilice modelos de IA para clasificar el contenido del texto
      para análisis de sentimientos, categorización de temas y moderación de
      contenido.
    x-displayName: Clasificación de Texto
  - name: Responses
    description: >-
      API de respuestas impulsadas por agentes para crear agentes de IA con uso
      autónomo de herramientas. Crea asistentes conversacionales que pueden
      utilizar búsqueda en la web, operaciones con archivos, generación de
      imágenes, ejecución de código, simulación de uso de computadoras e
      integraciones de MCP. Soporta procesamiento en segundo plano, transmisión
      y seguimiento de estado en tiempo real.
    x-displayName: Respuestas
  - name: Files
    description: >-
      API de gestión de archivos para cargar, almacenar y gestionar archivos con
      expiración automática e integración con S3. Carga archivos que se pueden
      usar con Asistentes, Almacenes Vectoriales y otras funciones. Los archivos
      se almacenan en S3 con metadatos rastreados en PostgreSQL. Soporta la
      limpieza automática de archivos expirados.
    x-displayName: Archivos
  - name: Vector Stores
    description: >-
      API de almacenamiento de vectores para almacenar y buscar documentos
      utilizando incrustaciones. Crea almacenes de vectores, sube archivos con
      fragmentación automática y generación de incrustaciones, y realiza
      búsquedas semánticas. Los archivos se procesan de forma asincrónica
      utilizando flujos de trabajo de Temporal para durabilidad. Soporta
      limpieza automática de almacenes caducados y LanceDB para almacenamiento
      eficiente de vectores.
    x-displayName: Almacenes de Vectores
  - name: Conversations
    description: >-
      API de gestión de conversaciones para almacenar y recuperar el estado de
      la conversación a través de llamadas a la API de respuesta. Crea
      conversaciones, añade elementos (mensajes de usuario, mensajes del
      asistente, mensajes del sistema) y mantiene el historial de la
      conversación. Soporta seguimiento de metadatos y gestión del estado del
      diálogo en múltiples turnos.
    x-displayName: Conversaciones
  - name: Guardrails
    description: >-
      API de salvaguardias de seguridad de IA para configurar la moderación de
      contenido y las políticas de seguridad. Configura listas de palabras
      prohibidas, detección de inyección de mensajes y prevención de filtración
      de mensajes del sistema. Las salvaguardias se aplican a todas las
      solicitudes de una cuenta y se pueden probar antes del despliegue.
    x-displayName: Barandillas
  - name: Models
    description: >-
      API de listado de modelos para descubrir modelos disponibles. Devuelve IDs
      de modelos, propiedad y metadatos para todos los modelos registrados en la
      puerta de enlace.
    x-displayName: Modelos
  - name: Skills
    description: >-
      API de habilidades para gestionar paquetes de instrucciones y archivos
      versionados siguiendo el estándar de Habilidades del Agente. Crea,
      versiona y descarga paquetes de habilidades reutilizables que incluyen
      manifiestos SKILL.md para entornos de agentes.
    x-displayName: Habilidades
  - name: Chat Completions
    description: >-
      **Obsoleto: Usa la API de Respuestas (`/api/v1/llm/responses`) en su
      lugar.** Puntos finales de completación de chat con soporte para
      transmisión, llamadas a herramientas y múltiples proveedores.
    x-deprecated: true
    x-displayName: Completaciones de Chat
  - name: Batches
    x-displayName: Lotes
  - name: Evals
    x-displayName: Evaluaciones
  - name: Fine-Tuning
    x-displayName: Ajuste fino
  - name: Memory Stores
    x-displayName: Almacenes de memoria
  - name: Prompts
    x-displayName: Sugerencias
  - name: Tables
    description: Gestionar esquemas de tablas, operaciones de datos, búsqueda e índices.
    x-displayName: Mesas
  - name: Text Store
    description: >-
      Gestiona almacenes de texto con búsqueda híbrida (vector + texto completo)
      y conjuntos de texto agrupados.
    x-displayName: Tienda de Texto
  - name: GraphRAG
    description: >-
      Construya y consulte gráficos de conocimiento livianos respaldados por
      Redis y LanceDB.
    x-displayName: GraphRAG
  - name: API Key
    x-displayName: Clave de API
  - name: Sessions
    description: Crear, inspeccionar, acceder y terminar sesiones de sandbox.
    x-displayName: Sesiones
  - name: Browser
    description: >-
      Conéctate a las sesiones del navegador a través del proxy del puerto de la
      puerta de enlace. Las sesiones del navegador exponen un punto final del
      Protocolo de DevTools de Chrome en el puerto 9222.
    x-displayName: Navegador
  - name: Execution
    description: >-
      Ejecutar comandos de shell y código dentro de una sesión de sandbox
      existente.
    x-displayName: Ejecución
  - name: Workspace
    description: >-
      Inspeccionar el manifiesto del espacio de trabajo, transferir archivos o
      archivos comprimidos, y descargar artefactos generados.
    x-displayName: Espacio de trabajo
  - name: Sandbox Usage
    x-displayName: Uso de Sandbox
  - name: Agents
    description: Crea y gestiona definiciones de agentes reutilizables.
    x-displayName: Agentes
  - name: Agent Versions
    description: >-
      Inspeccionar el historial de configuración de un agente y revertir a una
      versión anterior.
    x-displayName: Versiones de Agente
  - name: Agent Runs
    description: >-
      Ejecutar agentes guardados e inspeccionar los resultados de ejecución
      persistidos.
    x-displayName: Ejecuta Agentes
  - name: Agent Schedules
    description: >-
      Crea y gestiona ejecuciones de agentes programadas o recurrentes
      guardadas.
    x-displayName: Horarios de Agentes
  - name: schema-5_other
    x-displayName: otro
paths:
  /api/v1/llm/evals/schedules/{schedule_id}/runs:
    get:
      tags:
        - Evals
      summary: Listar ejecuciones creadas por un programa de evaluación
      description: >-
        Devuelve las ejecuciones de eval que fueron creadas por el programa
        dado.
      operationId: listEvalScheduleRuns
      parameters:
        - name: schedule_id
          in: path
          required: true
          schema:
            type: string
          example: eval_sched_aa87e2b1112a455b8deabed784372198
        - name: after
          in: query
          schema:
            type: string
          allowEmptyValue: true
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
          allowEmptyValue: true
        - name: suite_id
          in: query
          schema:
            type: string
          allowEmptyValue: true
        - name: status
          in: query
          schema:
            enum:
              - queued
              - in_progress
              - finalizing
              - completed
              - failed
              - cancelling
              - cancelled
          allowEmptyValue: true
        - name: X-On-Behalf-Of
          in: header
          required: false
          schema:
            type: string
          description: Optional external end-user identifier forwarded by the API gateway.
      responses:
        '200':
          description: Está bien
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    const: list
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        object:
                          const: eval.run
                        suite_id:
                          type: string
                        suite_version:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        suite_version_id:
                          type: string
                        status:
                          $ref: '#/components/schemas/EvalRunStatus'
                        models:
                          type: array
                          items:
                            type: string
                        task_ids:
                          anyOf:
                            - type: array
                              items:
                                type: string
                            - type: 'null'
                        judge_model:
                          anyOf:
                            - type: string
                            - type: 'null'
                        embedding_model:
                          anyOf:
                            - type: string
                            - type: 'null'
                        generation:
                          type: object
                          properties:
                            instructions:
                              type: string
                            temperature:
                              type: number
                              minimum: 0
                              maximum: 2
                            top_p:
                              type: number
                              minimum: 0
                              maximum: 1
                            max_output_tokens:
                              type: integer
                              minimum: 1
                              maximum: 9007199254740991
                            max_gen_toks:
                              type: integer
                              minimum: 1
                              maximum: 9007199254740991
                              description: lm-eval alias for max_output_tokens.
                            stop:
                              anyOf:
                                - type: string
                                - type: array
                                  minItems: 1
                                  items:
                                    type: string
                            until:
                              type: array
                              minItems: 1
                              items:
                                type: string
                              description: lm-eval generate_until stop sequences.
                            max_tool_calls:
                              type: integer
                              minimum: 1
                              maximum: 9007199254740991
                            reasoning: {}
                            text: {}
                            tools:
                              type: array
                              items:
                                anyOf:
                                  - {}
                                  - type: 'null'
                            tool_choice: {}
                            parallel_tool_calls:
                              type: boolean
                            truncation:
                              enum:
                                - auto
                                - disabled
                            service_tier:
                              enum:
                                - auto
                                - default
                                - flex
                                - priority
                            presence_penalty:
                              type: number
                              minimum: -2
                              maximum: 2
                            frequency_penalty:
                              type: number
                              minimum: -2
                              maximum: 2
                            top_k:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            min_p:
                              type: number
                              minimum: 0
                              maximum: 1
                            repetition_penalty:
                              type: number
                              minimum: 0
                            do_sample:
                              type: boolean
                            extra_body:
                              type: object
                              propertyNames:
                                type: string
                              additionalProperties: {}
                            chat_template_kwargs:
                              type: object
                              propertyNames:
                                type: string
                              additionalProperties: {}
                            prefill_think:
                              anyOf:
                                - type: boolean
                                - type: string
                            use_cache:
                              type: boolean
                            timeout_seconds:
                              type: integer
                              minimum: 1
                              maximum: 3600
                            max_retries:
                              type: integer
                              minimum: 0
                              maximum: 10
                            max_empty_retries:
                              type: integer
                              minimum: 0
                              maximum: 10
                          additionalProperties: {}
                        request_counts:
                          type: object
                          properties:
                            total:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            completed:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            failed:
                              type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                          required:
                            - total
                            - completed
                            - failed
                        metrics:
                          anyOf:
                            - type: object
                              propertyNames:
                                type: string
                              additionalProperties: {}
                            - type: 'null'
                        error:
                          anyOf:
                            - type: object
                              propertyNames:
                                type: string
                              additionalProperties: {}
                            - type: 'null'
                        artifact_file_ids:
                          type: array
                          items:
                            type: string
                        metadata:
                          type: object
                          propertyNames:
                            type: string
                            maxLength: 64
                          additionalProperties:
                            type: string
                            maxLength: 512
                        created_at:
                          type: integer
                          minimum: -9007199254740991
                          maximum: 9007199254740991
                        started_at:
                          anyOf:
                            - type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            - type: 'null'
                        completed_at:
                          anyOf:
                            - type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            - type: 'null'
                        cancelled_at:
                          anyOf:
                            - type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            - type: 'null'
                        failed_at:
                          anyOf:
                            - type: integer
                              minimum: -9007199254740991
                              maximum: 9007199254740991
                            - type: 'null'
                      required:
                        - id
                        - object
                        - suite_id
                        - suite_version
                        - suite_version_id
                        - status
                        - models
                        - task_ids
                        - judge_model
                        - embedding_model
                        - generation
                        - request_counts
                        - metrics
                        - error
                        - artifact_file_ids
                        - metadata
                        - created_at
                        - started_at
                        - completed_at
                        - cancelled_at
                        - failed_at
                  first_id:
                    type: string
                  last_id:
                    type: string
                  has_more:
                    type: boolean
                required:
                  - object
                  - data
                  - has_more
              example:
                object: list
                data:
                  - id: eval_run_aa87e2b1112a455b8deabed784372198
                    object: eval.run
                    suite_id: eval_suite_aa87e2b1112a455b8deabed784372198
                    suite_version: 1
                    suite_version_id: eval_sver_aa87e2b1112a455b8deabed784372198
                    status: in_progress
                    models:
                      - auto
                    task_ids: null
                    judge_model: auto
                    embedding_model: auto
                    generation:
                      temperature: 0
                      max_output_tokens: 512
                    request_counts:
                      total: 100
                      completed: 10
                      failed: 0
                    metrics: null
                    error: null
                    artifact_file_ids: []
                    metadata:
                      purpose: mvp
                    created_at: 1704067200
                    started_at: 1704067210
                    completed_at: null
                    cancelled_at: null
                    failed_at: null
                first_id: eval_run_aa87e2b1112a455b8deabed784372198
                last_id: eval_run_aa87e2b1112a455b8deabed784372198
                has_more: false
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: python
          label: Python (SDK)
          source: |-
            from meetkai_mka1 import SDK


            with SDK(
                bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
            ) as sdk:

                res = sdk.llm.evals.list_schedule_runs(schedule_id="eval_sched_aa87e2b1112a455b8deabed784372198", limit=20)

                # Handle response
                print(res)
        - lang: typescript
          label: Typescript (SDK)
          source: |-
            import { SDK } from "@meetkai/mka1";

            const sdk = new SDK({
              bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
            });

            async function run() {
              const result = await sdk.llm.evals.listScheduleRuns({
                scheduleId: "eval_sched_aa87e2b1112a455b8deabed784372198",
              });

              console.log(result);
            }

            run();
        - lang: csharp
          label: CSharp (SDK)
          source: >-
            using MeetKai.MKA1;

            using MeetKai.MKA1.Types.Components;

            using MeetKai.MKA1.Types.Requests;


            var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");


            ListEvalScheduleRunsRequest req = new ListEvalScheduleRunsRequest()
            {
                ScheduleId = "eval_sched_aa87e2b1112a455b8deabed784372198",
            };


            var res = await sdk.Llm.Evals.ListScheduleRunsAsync(req);


            // handle response
components:
  schemas:
    EvalRunStatus:
      enum:
        - queued
        - in_progress
        - finalizing
        - completed
        - failed
        - cancelling
        - cancelled
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Gateway auth: send `Authorization: Bearer <mka1-api-key>`. For
        multi-user server-side integrations, you can also send `X-On-Behalf-Of:
        <external-user-id>`.

````