Mistral publicó la versión 2.10.0 de su SDK oficial para Python, y la actualización importa más para los equipos que mantienen integraciones administrativas que para quienes solo llaman modelos. El paquete reorganiza la superficie de conectores, añade capacidades para credenciales y cuentas de servicio, y elimina 19 métodos vinculados a campañas, eventos de chat, datasets y campos. El sello de esta noticia es CONFIRMADO: la versión fue publicada en el repositorio oficial y también está disponible en PyPI.
El cambio central está en los conectores. El método de creación ahora recibe un único objeto de solicitud, en lugar de aceptar parámetros con nombre separados como name, description, server y title. Connector también pasó a ser una unión entre HTTPConnector y MCPConnector, diferenciada por el campo protocol. En TypeScript, protocol debe informarse de manera explícita; en Python, la biblioteca todavía ofrece un valor predeterminado. El diseño es menos ambiguo, pero rompe el código que crea conectores con la firma anterior.
La versión también vuelve más explícita la gestión de acceso. Se incorporan operaciones para crear, actualizar, compartir y dejar de compartir credenciales de organizaciones, además de un conjunto de endpoints para cuentas de servicio y roles asignables. Para las empresas que usan Mistral en productos internos, automatizaciones o agentes, el beneficio práctico es separar mejor la identidad humana, la credencial técnica y el alcance organizacional. Para una pequeña empresa brasileña, eso puede reducir la dependencia de la clave personal del fundador cuando un sistema pasa a ser una herramienta del equipo.
El costo es el trabajo inmediato de migración. El release elimina endpoints de campañas, búsqueda y evaluación de eventos de chat, importación de datasets y consulta de opciones de campos. La documentación oficial de Mistral todavía considera sin cambios, dentro de la migración a la línea 2, las áreas de chat, streaming, embeddings, agentes, function calling y batch, pero la lista del release muestra que la administración, la evaluación y la observabilidad siguen evolucionando. Quien dependa de esas funciones debe revisar código y pruebas, no solo actualizar la dependencia.
También hay ajustes de compatibilidad que parecen pequeños, pero evitan fallos reales. Los campos start y end de los segmentos de transcripción ahora aceptan null, porque la API puede devolver valores ausentes en transcripciones diarizadas. También cambiaron los metadatos OAuth, la información de nivel de servicio y las respuestas de workers de deployment. Son señales de un SDK que acompaña a una plataforma más amplia, no de un parche cosmético.
Para las pymes brasileñas, la recomendación es directa: fijen la versión en el entorno, lean la lista de breaking changes, busquen llamadas a connectors.create y validen transcripciones con segmentos sin marcas temporales. Este release no aporta evidencia de un modelo nuevo ni de una reducción de precios. Su valor está en la gobernanza de la integración. Mi lectura es que Mistral está llevando el SDK hacia una arquitectura más preparada para entornos multiusuario y MCP, pero cobra esa evolución en retrabajo del lado del cliente. Actualizar sin una prueba de contrato es una invitación a descubrir la ruptura en producción.
Fuentes
- Release oficial del cliente Python de Mistral: https://github.com/mistralai/client-python/releases/tag/v2.10.0
- mistralai 2.10.0 en PyPI: https://pypi.org/project/mistralai/2.10.0/
- Documentación oficial de SDKs de Mistral: https://docs.mistral.ai/resources/sdks
- Guía oficial de migración al SDK Python v2: https://docs.mistral.ai/resources/migration-guides