Change8

v2.1.2

Breaking Changes
📦 mistral-clientView on GitHub →
6 breaking🔧 16 symbols

Summary

This release introduces numerous breaking changes across the SDK, primarily affecting the structure of the `tools[]` field in beta conversation and agent endpoints, as well as request/response payloads for chat, FIM, and agent completion endpoints.

⚠️ Breaking Changes

  • The structure of the `tools[]` field has changed in `mistral.beta.conversations.start()`, `mistral.beta.conversations.start_stream()`, `mistral.beta.agents.create()`, `mistral.beta.agents.update()`, and related list/get methods. Users must update how they define or expect tool structures in these endpoints.
  • The structure of the `tools[]` field has changed in various `mistral.beta.agents` endpoints (`create`, `get`, `list`, `update`, `update_version`, `list_versions`, `get_version`).
  • The structure of the `request` object has changed for `mistral.chat.complete()` and `mistral.chat.stream()`. Users must review and update their request payloads.
  • The structure of the `response.choices[]` field has changed for `mistral.chat.complete()` and `mistral.fim.complete()`.
  • The structure of the `request` object has changed for `mistral.agents.complete()` and `mistral.agents.stream()`. Users must review and update their request payloads.
  • The structure of the `response.choices[]` field has changed for `mistral.agents.complete()`.

Migration Steps

  1. Review and update the structure of the `tools[]` field when calling `mistral.beta.conversations.start()` and `mistral.beta.conversations.start_stream()`.
  2. Review and update the structure of the `tools[]` field when interacting with `mistral.beta.agents` endpoints (create, get, list, update, etc.).
  3. Review and update the request payload structure for `mistral.chat.complete()` and `mistral.chat.stream()`.
  4. Review and update the handling of the `response.choices[]` structure for `mistral.chat.complete()` and `mistral.fim.complete()`.
  5. Review and update the request payload structure for `mistral.agents.complete()` and `mistral.agents.stream()`.
  6. Review and update the handling of the `response.choices[]` structure for `mistral.agents.complete()`.

Affected Symbols