Devstral e os Agentes de Código da Mistral
Nesta página
Lição reescrita em 2 de novembro de 2026. Toda a gama Devstral foi removida da API: o Devstral Small 2 a 31 de março de 2026 e o Devstral 2 a 31 de julho de 2026. O Mistral Medium 3.5 serve como substituto designado (embora esteja também ele preterido em favor do Mistral Large 4). Os pesos abertos permanecem publicados e a Mistral continua a recomendar o Devstral Small 2 para executar o Vibe localmente. Esta secção do curso (Lições 5–8) ensina agora a programação agentiva utilizando os modelos atuais. Fontes: Modelos · Devstral 2 · Utilizar modelos offline (Vibe).
Conclusão vs. Agente: Duas Funções Diferentes
Se o Codestral é o especialista em conclusão, o agente de código é o seu contraponto: um modelo que não se limita a completar uma linha, mas gere uma tarefa inteira. Confundir os dois sai caro na prática. Atribuir a conclusão automática a um agente significa pagar por uma latência desnecessária; atribuir uma refatorização multificheiros a um modelo de conclusão significa ficar preso a recompor as peças manualmente.
Uma correção de erro torna esta distinção concreta. Com o Codestral, você identifica o ficheiro defeituoso, você posiciona o cursor no local certo e o modelo sugere a correção. Com um agente, descreve o sintoma: ele explora o repositório, rastreia o problema até à causa raiz, propõe um plano, modifica os ficheiros relevantes e escreve os testes acompanhantes. No primeiro caso, o diagnóstico é seu; no segundo, é delegado.
Devstral: A Gama que Abriu o Caminho
A Mistral desenvolveu inicialmente modelos especializados para esta função sob o nome Devstral: o Devstral Small 1.0 em maio de 2025, seguido pelo Devstral Medium 1.0 e Devstral Small 1.1 em julho de 2025. Depois, a 9 de dezembro de 2025, foram lançados o Devstral 2 e o Devstral Small 2, juntamente com a ferramenta de linha de comandos Mistral Vibe.
| Devstral 2 | Devstral Small 2 | |
|---|---|---|
| Parâmetros | 123 mil milhões (denso) | 24 mil milhões |
| Contexto | 256.000 tokens | 256.000 tokens |
| Licença de Pesos | MIT Modificada | Apache 2.0 |
| SWE-bench Verified (anúncio da Mistral) | 72,2% | 68,0% |
| Data de Remoção da API | 31 de julho de 2026 | 31 de março de 2026 |
Estes modelos destacavam-se na utilização de ferramentas para explorar repositórios, modificar múltiplos ficheiros e conduzir agentes de engenharia de software. A sua remoção da API não apagou os seus pesos: continuam disponíveis para descarga no Hugging Face e a documentação do Vibe recomenda ainda o Devstral Small 2 para uso local (Lição 13).
Modelos Atuais da API para Programação
A programação agentiva não desapareceu com o Devstral; mudou-se para modelos de uso geral concebidos tanto para código como para outras tarefas.
| Modelo | Identificador | Descrição na Documentação | Estado |
|---|---|---|---|
| Mistral Medium 3.5 | mistral-medium-3-5 | ”Otimizado para casos de uso agentivos e código”; integrado no Vibe Code, recomendado na sua configuração | Obsoleto, remoção a 30 de abril de 2027 |
| Mistral Small 4 | mistral-small-2603 | Combina instruções, raciocínio e código num único modelo | Disponível (GA) |
| Mistral Large 4 | mistral-large-4-0 | Modelo mais capaz da gama, contexto de um milhão de tokens | Pré-visualização Pública |
| Codestral | codestral-2508 | Conclusão de código de baixa latência, incluindo FIM | Disponível (GA) |
Daqui decorrem duas implicações. Para um agente construído sobre a API, comece com o Small 4 (GA e económico) e avalie o Large 4 nas suas tarefas mais difíceis. O Medium 3.5 permanece utilizável até abril de 2027, mas não inicie um novo projeto com ele. Para um agente pronto a usar, o Vibe Code (a CLI, a extensão VS Code ou a versão web) já inclui o Medium 3.5 e gere todo o ciclo agentivo (Lição 8).
O Que um Agente de Código Pode Fazer
As tarefas encadeiam-se numa única missão. Primeiro, o agente explora o repositório: percorre a árvore de diretórios, abre ficheiros e reconstrói a arquitetura. Segue-se o diagnóstico: analisa registos e rastreia chamadas até à causa raiz, e não apenas ao sintoma. Depois, o planeamento: propõe uma sequência de passos antes de escrever uma única linha de código. Esta é a sua oportunidade de o corrigir antes que cometa erros em dez ficheiros. Segue-se a implementação, com alterações coerentes distribuídas por vários ficheiros. Finalmente, a verificação: executa testes, revê as suas diferenças (diff) e corrige tudo o que falhar.
Ferramentas: O Diferencial Chave do Agente
O que separa um agente de um modelo generativo é a chamada de ferramentas (function calling). As ferramentas de um agente de código são poucas e padronizadas:
# Typical code agent tools:
# - read_file(path): Read a project file
# - write_file(path, content): Modify a file
# - run_command(cmd): Execute a shell command
# - search_code(query): Search within the repository
Com estas quatro primitivas, o agente interage com o seu ambiente de forma iterativa: lê, decide, age, observa o resultado e repete. Um modelo generativo padrão produz texto e para, sem nunca saber se esse texto compila. A próxima lição constrói este ciclo em Python.
O Impacto dos Pesos Abertos
Os pesos abertos — sejam do Devstral, do Small 4 (Apache 2.0) ou do Medium 3.5 (MIT Modificada) — têm consequências concretas: a hospedagem local mantém o seu código nos seus servidores; a personalização permite adaptar um modelo às suas convenções (nada o proíbe); a auditabilidade satisfaz os requisitos de empresas regulamentadas; e os custos de infraestrutura fixos substituem a faturação da API baseada no uso, que escala com a sua atividade. Verifique sempre a licença exata de cada modelo antes da utilização comercial: elas diferem de modelo para modelo.
Pontos-chave
- O Codestral completa código; um agente gere uma tarefa inteira utilizando ferramentas
- Toda a gama Devstral foi removida da API (Devstral 2 a 31 de julho de 2026), mas os seus pesos permanecem publicados
- Para a API: utilize o Small 4 por defeito, avalie o Large 4 e use o Medium 3.5 apenas até à sua remoção em abril de 2027
- O Vibe Code inclui o Medium 3.5 e fornece um ciclo agentivo chave na mão
- O Devstral Small 2 permanece o modelo local recomendado pela documentação do Vibe