A Mistral publicou a versão 2.10.0 do seu SDK oficial para Python em 9 de setembro, e a atualização é mais importante para quem mantém integrações administrativas do que para quem apenas chama modelos. O pacote reorganiza a superfície de conectores, acrescenta recursos de credenciais e contas de serviço e remove 19 métodos ligados a campanhas, eventos de chat, datasets e campos. O selo desta matéria é CONFIRMADO: a versão foi lançada no repositório oficial e também está disponível no PyPI.
A mudança central está nos conectores. O método de criação agora recebe um único objeto de requisição, em vez de aceitar parâmetros nomeados soltos como name, description, server e title. Além disso, Connector passou a ser uma união entre HTTPConnector e MCPConnector, diferenciada pelo campo protocol. No TypeScript, protocol precisa ser informado explicitamente; no Python, a biblioteca ainda mantém um valor padrão. Isso reduz a ambiguidade do modelo, mas quebra código que monta conectores com a assinatura antiga.
A versão também troca uma parte da gestão de acesso por operações mais explícitas. Entraram criação, atualização, compartilhamento e remoção de compartilhamento de credenciais em organizações, além de uma família de endpoints para contas de serviço e papéis atribuíveis. Para empresas que usam a Mistral em produtos internos, automações ou agentes, o ganho prático é separar melhor identidade humana, credencial técnica e escopo organizacional. Para uma pequena empresa brasileira, isso pode significar menos dependência de uma chave pessoal do fundador quando o sistema começa a ser usado por uma equipe.
O outro lado é o custo imediato da migração. Foram removidos endpoints de campanhas, busca e avaliação de eventos de chat, importação de datasets e consulta de opções de campos. A documentação oficial continua tratando chat, streaming, embeddings, agentes, function calling e batch como áreas preservadas na migração para a linha 2, mas a lista do release mostra que recursos de observabilidade, avaliação e administração não ficaram congelados. Quem depende deles precisa revisar o código e os testes, não apenas atualizar o pacote.
Há ainda ajustes de compatibilidade que parecem pequenos, mas evitam falhas reais. Os campos start e end de segmentos de transcrição agora aceitam null, porque a API pode devolver valores ausentes em transcrições diarizadas. Também houve mudanças em metadados OAuth, níveis de serviço e respostas de workers de deployment. São sinais de um SDK acompanhando uma plataforma mais ampla, não de uma simples correção cosmética.
Para PMEs brasileiras, a recomendação é objetiva: fixe a versão no ambiente, leia a lista de breaking changes, procure chamadas de connectors.create e valide transcrições com segmentos sem marcação temporal. Não há evidência, neste release, de um novo modelo ou de uma redução de preço. O valor está na governança da integração. Minha leitura é que a Mistral está empurrando o SDK para uma arquitetura mais preparada para ambientes multiusuário e MCP, mas está cobrando essa evolução em retrabalho de clientes que tratavam o pacote como uma camada estável de CRUD. Atualizar sem um teste de contrato é pedir para descobrir a quebra em produção.
Fontes
- Release oficial do cliente Python da Mistral: https://github.com/mistralai/client-python/releases/tag/v2.10.0
- Registro do pacote mistralai 2.10.0 no PyPI: https://pypi.org/project/mistralai/2.10.0/
- Documentação oficial de SDKs da Mistral: https://docs.mistral.ai/resources/sdks
- Guia oficial de migração para o SDK Python v2: https://docs.mistral.ai/resources/migration-guides