# MKA1: Spanish ## Spanish - [Spanish / Referencia API (464 pages)](https://docs.mka1.com/_llms/es/referencia-api.txt): Documentation for Spanish / Referencia API. ### Desarrolladores #### Comenzar - [Primeros pasos](https://docs.mka1.com/es/docs/platform-getting-started.md): Desde un enlace de invitación al clúster hasta crear aplicaciones con el SDK de MKA1. Acepte su invitación, configure su organización, genere una clave API y realice su primera solicitud. - [Autenticación](https://docs.mka1.com/es/docs/authentication.md): Autentícate en la API de MKA1 con tu clave API, decide cuándo enviar X-On-Behalf-Of e intercambia una clave API por un JWT de corta duración. #### SDKs y CLI ##### CLI - [Descripción general de la CLI](https://docs.mka1.com/es/docs/cli/introduction.md): Instala la CLI de mka1, habilita la autocompletación de comandos y ejecuta tu primer comando de la API de MKA1 desde la terminal. - [Autenticar el CLI](https://docs.mka1.com/es/docs/cli/authentication.md): Configura el CLI de mka1 con tu clave API usando flags, variables de entorno, el llavero del sistema operativo o un archivo de configuración — y adjunta X-On-Behalf-Of para integraciones multiusuario. - [Comandos](https://docs.mka1.com/es/docs/cli/commands.md): Recorre el árbol de comandos de la CLI mka1 con ejemplos prácticos para Respuestas, Conversaciones, Archivos, Almacenes Vectoriales, Extracción, Voz, Agentes y más. - [Pasar cuerpos de solicitud](https://docs.mka1.com/es/docs/cli/request-body.md): Construye solicitudes CLI de mka1 con flags individuales, el atajo JSON --body, o canalización por stdin — y entiende cómo se combinan las tres entradas. - [Formatear y filtrar la salida](https://docs.mka1.com/es/docs/cli/output-formats.md): Cambia el CLI de mka1 entre salida pretty, JSON, YAML, table y TOON. Transforma resultados con jq, transmite eventos SSE y controla el color. - [Depurar e inspeccionar](https://docs.mka1.com/es/docs/cli/diagnostics.md): Previsualiza las solicitudes del CLI mka1 con --dry-run, rastrea en vivo con --debug, explora el árbol de comandos de forma interactiva y habilita el modo agente para herramientas de codificación con IA. #### Respuestas - [Generar una respuesta](https://docs.mka1.com/es/docs/generate-a-response.md): Utiliza el recurso de Respuestas de la API MKA1 para generar texto, enviar mensajes estructurados y continuar intercambios de varios turnos. - [Gestionar conversaciones](https://docs.mka1.com/es/docs/conversations.md): Almacena el estado de la conversación en la API de MKA1, agrega elementos de mensajes y continúa un flujo de respuesta sin reenviar todo el historial. - [Respuestas en segundo plano](https://docs.mka1.com/es/docs/background-responses.md): Ejecuta respuestas de larga duración en segundo plano y recupera los resultados mediante sondeo o streaming. - [Memoria a largo plazo](https://docs.mka1.com/es/docs/long-term-memory.md): Utiliza la herramienta de historial para dar a los modelos memoria persistente entre sesiones, permitiendo recordar conversaciones pasadas por usuario final. - [Repositorio de prompts](https://docs.mka1.com/es/docs/prompt-repository.md): Gestiona plantillas de prompts versionadas con historial de cambios, reversión y renderizado de variables a través de la API de Prompts. ##### Ejemplos - [Conversaciones avanzadas con herramientas](https://docs.mka1.com/es/docs/advanced-conversations.md): Un diálogo completo de 12 turnos con búsqueda web, correcciones, contradicciones y verificación de coherencia — mostrando cada solicitud y la respuesta completa. ##### Entradas - [Entrada multimodal](https://docs.mka1.com/es/docs/multimodal-input.md): Envía imágenes, audio, documentos y contenido mixto a la API MKA1 para visión, transcripción, OCR y razonamiento multimodal. ##### Salidas - [Salida multimodal](https://docs.mka1.com/es/docs/multimodal-output.md): Genera audio hablado e imágenes desde la API de MKA1 usando el recurso Responses. ##### Recuperación - [Usar archivos y almacenes vectoriales](https://docs.mka1.com/es/docs/files-and-vector-stores.md): Sube archivos a la API de MKA1, indexa esos archivos en un almacén vectorial y realiza búsquedas semánticas sobre los fragmentos de documentos resultantes. ##### Herramientas - [Usar herramientas MCP](https://docs.mka1.com/es/docs/mcp-tools.md): Conecta un servidor MCP al recurso de Respuestas de la API MKA1, limita las herramientas permitidas y, opcionalmente, requiere la aprobación del usuario final. #### APIs independientes - [Voz](https://docs.mka1.com/es/docs/speech.md): Transcribe audio y genera voz con la API de MKA1. Usa segmentos etiquetados por hablante cuando necesites separación de múltiples interlocutores. - [Modo de Voz Avanzado](https://docs.mka1.com/es/docs/advanced-voice-mode.md): Cree sesiones de voz en tiempo real con la API MKA1 usando LiveKit. Configure opciones de LLM, herramientas, ajuste de STT y continuidad de conversación. - [Extraer datos estructurados](https://docs.mka1.com/es/docs/extract-structured-data.md): Define un esquema de extracción reutilizable en la API de MKA1 y extrae campos estructurados de archivos. #### Agentes - [Gestionar agentes](https://docs.mka1.com/es/docs/managing-agents.md): Cree definiciones de agentes reutilizables, ejecútelas más tarde e inspeccione el historial de ejecuciones persistidas. - [Crear un agente con memory stores](https://docs.mka1.com/es/docs/build-an-agent-with-memory-stores.md): Monta memoria durable en el entorno shell gestionado de un agente guardado y mantenla actualizada entre ejecuciones. - [Generar subagentes usando la API de Respuestas](https://docs.mka1.com/es/docs/spawn-subagents-using-the-responses-api.md): Utiliza una herramienta de función en el recurso Responses de la API MKA1 para permitir que una respuesta genere respuestas hijas y continúe después de que todas hayan respondido. ##### Ejemplos - [Crear un agente con herramientas MCP](https://docs.mka1.com/es/docs/build-an-agent-with-mcp-tools.md): Crea un agente guardado que llama a un servidor MCP gestionado por el vault con credenciales cifradas por end user. - [Realización de investigación profunda con subagentes](https://docs.mka1.com/es/docs/making-deep-research-with-subagents.md): Construye un flujo de trabajo de investigación profunda en la API de MKA1 utilizando una respuesta principal para delegar investigaciones web paralelas a respuestas hijas y sintetizar memorandos de investigación compactos. - [Conversacional multicanal](https://docs.mka1.com/es/docs/multichannel-conversational.md): Demuestra que los canales de WhatsApp y web comparten una conversación almacenada de la API MKA1 con registros de auditoría JSONL unificados. #### Compute - [Gestionar repositorios](https://docs.mka1.com/es/docs/repositories.md): Crea y gestiona repositorios de mka1-repos — repositorios git con alcance de organización para los pesos de modelo y los conjuntos de datos que las cargas de trabajo de Compute consumen y publican. - [Ejecutar un trabajo de ajuste fino](https://docs.mka1.com/es/docs/compute-fine-tune-job.md): Ajusta finamente un modelo en GPUs alquiladas con un trabajo de Compute, monitorea el entrenamiento desde los registros y por SSH, y publica los pesos fusionados en mka1-repos. - [Desplegar un servidor de modelos](https://docs.mka1.com/es/docs/compute-deployment.md): Sirve un modelo detrás de un endpoint HTTP autenticado con un servicio de Compute, obtén los pesos desde mka1-repos y registra el endpoint en el gateway LLM. #### Producción - [Limitación de tasa](https://docs.mka1.com/es/docs/rate-limiting.md): Límites de tasa por clave con cuotas configurables por minuto, hora o día. Incluye demostración real de HTTP 429 y patrones de reintento. - [Procesamiento por lotes](https://docs.mka1.com/es/docs/batch-processing.md): Envía grandes volúmenes de solicitudes de forma asíncrona usando la API Batch. Procesa solicitudes de Responses, completaciones de chat, embeddings y generación de imágenes en masa dentro de una ventana de finalización de 24 horas. ### Aplicaciones #### MKA1 Code ##### Primeros pasos - [MKA1 Code](https://docs.mka1.com/es/docs/mka1-code.md): Planifique, desarrolle y revise software con un agente de IA en un entorno de escritorio basado en la MKA1 API. - [Instalación](https://docs.mka1.com/es/docs/mka1-code/install.md): Instale la aplicación de escritorio, conecte la cuenta y compruebe el gateway y los modelos disponibles. - [Modelos y proveedores](https://docs.mka1.com/es/docs/mka1-code/models.md): Elija un modelo del gateway, configure el predeterminado y añada un proveedor compatible para Code local. - [Inicio rápido](https://docs.mka1.com/es/docs/mka1-code/first-task.md): Lea un proyecto, reproduzca un error de checkout, verifique la corrección y prepare la revisión. ##### Funciones - [Sesiones y contexto del proyecto](https://docs.mka1.com/es/docs/mka1-code/sessions.md): Añada archivos, oriente tareas activas, encuentre trabajos anteriores y consulte el contexto. - [Planificación y permisos](https://docs.mka1.com/es/docs/mka1-code/permissions.md): Planifique antes de editar y elija cómo solicita el agente aprobación para sus herramientas. - [Agentes especializados](https://docs.mka1.com/es/docs/mka1-code/agents.md): Use agentes para investigar o revisar y defina roles reutilizables con herramientas e instrucciones propias. - [Automatización del navegador](https://docs.mka1.com/es/docs/mka1-code/previews.md): Pruebe una aplicación web, siga las acciones del navegador y tome el control cuando sea necesario. - [Revisión y commits](https://docs.mka1.com/es/docs/mka1-code/review-changes.md): Revise diffs y pruebas, elija qué incluir en un commit y envíelo o abra un pull request. - [Trabajo paralelo y worktrees](https://docs.mka1.com/es/docs/mka1-code/workspaces.md): Separe tareas simultáneas con ramas, worktrees y paneles de escritorio. - [Desarrollo remoto](https://docs.mka1.com/es/docs/mka1-code/remote-development.md): Ejecute sesiones en hosts SSH, distribuciones WSL o contenedores Docker. - [Tareas programadas](https://docs.mka1.com/es/docs/mka1-code/schedules.md): Ejecute comprobaciones recurrentes y retome una conversación local más adelante. ##### Herramientas y personalización - [Memoria del proyecto](https://docs.mka1.com/es/docs/mka1-code/memory.md): Guarde y apruebe preferencias del proyecto para futuras sesiones locales. - [Conectores, skills y plugins](https://docs.mka1.com/es/docs/mka1-code/extensions.md): Conecte herramientas externas y gestione instrucciones reutilizables para programar. - [Documentos y archivos](https://docs.mka1.com/es/docs/mka1-code/documents.md): Adjunte material de referencia y revise archivos PDF, hojas de cálculo, presentaciones y documentos en sesiones locales. ##### Otras interfaces - [Extensión de VS Code](https://docs.mka1.com/es/docs/mka1-code/vscode.md): Instale MKA1 Code en VS Code y trabaje con el agente junto a sus archivos. - [CLI](https://docs.mka1.com/es/docs/mka1-code/cli.md): Instale la CLI de MKA1 Code, abra sesiones interactivas y ejecute tareas desde scripts. ##### Soporte - [Atajos de teclado](https://docs.mka1.com/es/docs/mka1-code/keyboard-shortcuts.md): Navegue por la aplicación de escritorio, trabaje con sesiones y paneles y personalice los atajos de teclado. - [Consumo y solución de problemas](https://docs.mka1.com/es/docs/mka1-code/troubleshooting.md): Consulte el consumo y resuelva problemas de acceso, proyectos, conectores, entornos remotos, tareas y Git. ### Plataforma #### Gestión de modelos - [Enrutamiento automático](https://docs.mka1.com/es/docs/validate-auto-routing.md): Comprende y valida cómo MKA1 selecciona un modelo cuando una solicitud usa el modelo auto. #### Operaciones - [Auditoría de uso](https://docs.mka1.com/es/docs/usage-auditing.md): Rastrea el uso por usuario, correlaciona solicitudes en el borde de la API y estructura eventos de auditoría por unidad para la detección de uso indebido. #### Control de acceso - [Autorización](https://docs.mka1.com/es/docs/authorization.md): Controla el acceso a los recursos LLM con autorización basada en roles. Asigna roles de propietario, escritor o lector a los usuarios y verifica los permisos antes de cada acción. - [Autenticación y aislamiento de inquilinos](https://docs.mka1.com/es/docs/authentication-deep-dive.md): Demuestra inquilinos segregados en la API de MKA1 con claves API separadas, cuotas separadas, políticas separadas y acceso a recursos delimitado por inquilino. #### Seguridad y cumplimiento - [Cifrado de datos](https://docs.mka1.com/es/docs/data-encryption.md): Consulta qué controles de cifrado están activos en el entorno MKA1 desplegado, cómo los validamos y la evidencia capturada desde producción. - [Claves respaldadas por HSM y TLS 1.3](https://docs.mka1.com/es/docs/hsm-tls-validation.md): Cómo MKA1 utiliza módulos de seguridad de hardware (HSM) validados por AWS KMS y aplica TLS 1.3 para la gestión criptográfica de claves tanto en datos en reposo como en tránsito. - [Artefactos firmados y cadena de suministro](https://docs.mka1.com/es/docs/signed-artifacts.md): Cómo MKA1 garantiza la integridad de las imágenes de contenedores mediante el etiquetado inmutable de artefactos, pipelines CI/CD controlados y la aplicación de registros privados. - [GitOps con reversión atómica](https://docs.mka1.com/es/docs/gitops-atomic-rollback.md): Cómo MKA1 utiliza Git como fuente única de la verdad y despliegues Helm atómicos para garantizar la reversión automática en caso de fallo. - [Procedimiento de autoría](https://docs.mka1.com/es/docs/authorship-procedure.md): El procedimiento para actualizar la autoría con cada nueva versión. #### Comparativas - [Latencia de salida en streaming](https://docs.mka1.com/es/docs/streaming-output-latency.md): Referencia de latencia observada por el cliente para el primer token de texto transmitido en la API de Respuestas MKA1. - [Evaluación de la calidad de recuperación](https://docs.mka1.com/es/docs/evaluating-text-stores.md): Resultados de referencia del motor de recuperación de MKA1 en el conjunto de datos BEIR SciFact: precisión, latencia y rendimiento de indexado. - [Evaluación de GraphRAG](https://docs.mka1.com/es/docs/graphrag.md): Una comparación de referencia entre GraphRAG y RAG tradicional en preguntas de recuperación multi-hop. - [Evaluar localización regional y manejo de ambigüedad](https://docs.mka1.com/es/docs/evaluating-local-language-and-ambiguity.md): Ejecuta evaluaciones neutrales que demuestran localización regional espontánea y comportamiento de aclaración con el SDK MKA1. - [Embeddings especializados pt-BR](https://docs.mka1.com/es/docs/pt-br-embeddings.md): Informe técnico sobre mk-embeddings-pt — un modelo de embeddings para portugués brasileño con resultados en el benchmark MTEB, métricas de calidad semántica y comparación con modelos multilingües de referencia. ## OpenAPI Specs - [speakeasy](https://apigw.mka1.com/speakeasy.json?language=es) - [speakeasy](https://apigw.mka1.com/speakeasy.json?language=pt-BR)