Mistral представила Managed Agents и набор возможностей Studio 5 ноября 2026 года. На дату проверки, 7 ноября, Managed Agents и Agents SDK остаются публичной предварительной версией: API, поведение и ограничения могут измениться. Это обновление исполнения и эксплуатации; открытая документация превью не доказывает доступность каждой функции любой организации.
Mistral: примечания к выпуску от 5 ноября 2026 · Managed Agents: обзор и условия превью
Возьмём вымышленную задачу чтения материалов: открыть указанную версию, составить отчёт, при необходимости дождаться человека и сохранить проверяемый файл. Сначала спроектируйте состояния, права и доказательства поставки, затем подключайте реальные инструменты. Примеры не являются производственными измерениями и не открывают сервис Mistral за читателя.
1. Новшество — среда исполнения, а не другой вход к весам модели
В примечаниях от 5 ноября Managed Agents обозначена как публичное превью SDK рядом с обновлениями Studio: трассировкой по умолчанию, офлайн- и онлайн-оценкой. Метки доступности в списке не означают одинаковые права организации для всех компонентов. Например, страница офлайн-оценки прямо ограничивает доступ организациями Enterprise; такое условие указано и для Observability. Планируя внедрение, проверяйте конкретную страницу функции.
Mistral: примечания к выпуску от 5 ноября 2026 · Офлайн-оценка и условия Enterprise
Один ответ модели создаёт следующий вывод; агенту также нужно выбирать инструменты, сохранять шаги и обрабатывать ожидание и ошибки. Изменение объединяет эти действия в сессиях и записях выполнения, чтобы приложение могло найти работу снова. Это другой вопрос, чем веса Large 4, лицензия и память в нашей статье от 2 ноября. Лицензия открытых весов не определяет границы данных размещённого сервиса.
Начните с ограниченной задачи с независимо проверяемым результатом, например сборки обезличенного пакета доказательств. Описание работы часами или днями не является гарантией бесперебойности либо безлимитной квоты. Здесь определяются сбой, ожидание, повтор и приёмка, чтобы единственным подтверждением не оставался правдоподобный текст чата.
2. Три режима: собственный worker не оставляет все данные локально
Отдельно определите расположение модели, цикла исполнения, кода инструментов, сессии и песочницы. Режим выбирает процесс для цикла сессии и инструментов; песочница настраивается отдельно. В документированном стандартном варианте собственный worker всё ещё использует контрольную плоскость Mistral для хранения сессий и маршрутизации, а запросы модели идут в Mistral. Инструменты внутри вашей сети не делают всю систему автономной и не доказывают отсутствие передачи данных.
| Режим | Что запускаете вы | Сессия и границы |
|---|---|---|
| Локально, внутри процесса | Свою программу и инструменты | Сессия главным образом в памяти процесса и заканчивается с ним; экспериментальный journal — отдельно |
| Собственный worker | Свою программу и процесс agents serve | Mistral хранит сессии и маршрутизирует; инструменты в вашем процессе |
| Под управлением Mistral | Своё приложение; платформе принадлежат сборка и запуск worker | Развёртывание из git-проекта; сессии и код инструментов на инфраструктуре Mistral |
Близость к внутренней сети, контроль кода и обязательства по размещению данных проверяйте отдельно. В аудит внесите как минимум режим, хост инструментов, адрес модели и место хранения сессии. Обещания региона и сроков хранения без официального договора или конфигурации отмечайте как неизвестные. Смена размещения worker не переносит и не удаляет существующие сессии автоматически.
3. Сначала определите агента только для чтения
Текущая документация использует пакет mistralai-agents, from mistralai import agents, agents.Agent и @agents.tool. Имя функции, docstring и аннотации типов формируют видимое модели описание; инструменты определяются на уровне модуля. Ниже лишь определён агент с чтением вымышленной записи в памяти. Нет run, песочницы и подключения к бизнес-системе. Проверены синтаксис и соответствие официальному образцу, без установки и запуска SDK.
Managed Agents: обзор и условия превью · Инструменты и обработка ошибок
from mistralai import agents
@agents.tool
def read_sample(case_id: str) -> dict[str, str]:
"""Read one fictional case. Never access an external system."""
if case_id != "DEMO-1":
raise agents.ToolError("Unknown fictional case; ask the user.")
return {"case_id": case_id, "revision": "rev-a", "text": "Fictional evidence only."}
reviewer = agents.Agent(
model="mistral-large-4",
instructions="Review only the supplied case. Report missing evidence; do not invent it.",
tools=[read_sample],
)
# Definition only: no run(), session, sandbox or network request is started here.
Смысл примера — узкая граница в реализации: инструмент возвращает только DEMO-1, а для другого идентификатора даёт ожидаемую ошибку. Реальный сервис дополнительно проверяет вызывающего и ресурс на сервере; одной инструкции «только чтение» недостаточно для запрета записи. Ответственность одного инструмента за один объект проще проверить, чем доступ сразу ко всему репозиторию, Shell и набору коннекторов.
Отделяйте ожидаемую бизнес-ошибку от программного сбоя. Документация использует ToolError для понятного модели объяснения, а неожиданные исключения по умолчанию не раскрывают ей полную трассировку стека. Производственные журналы всё равно могут содержать внутренние сведения. Не включайте ключи или исходный клиентский текст в ошибки и не считайте политику SDK гарантией полной очистки данных.
Инструменты и обработка ошибок · Секреты и границы учётных данных
4. Разделяйте session, turn и состояние бизнес-поставки
Session хранит несколько сообщений и результатов инструментов; turn — один цикл обработки. Официальные примеры start_session и session.run используют ключи идемпотентности: повтор одного бизнес-события может вернуть исходные сессию и turn. Приложению нужно сохранять session_id, turn_id и версию входа, а не создавать новую задачу после потери дескриптора. Эти идентификаторы не заменяют ваш собственный номер задачи.
| Ситуация | Значение | Действие приложения |
|---|---|---|
| Running | Ожидание закончилось, а turn ещё работает | Ждать или запросить снова, не отмечать готовность |
| Blocked | Нужен ответ на согласование или другой callback | Показать ожидающее действие уполномоченному человеку |
| Busy | В session уже работает turn; новый не начат | Использовать существующий дескриптор, не создавать работу вслепую |
| Completed | Turn завершился штатно | Проверить вывод, причину остановки и файл |
| Interrupted / Failed | Остановлен или завершён ошибкой | Сохранить причину, сверить повторы и внешние эффекты |
| Неизвестный новый тип | SDK ещё не знает новый исход | Консервативно приостановить приёмку, обновить обработку; не считать успехом |
Особенно легко перепутать timeout: он ограничивает ожидание вызывающей стороны, а не срок жизни turn. При Running работа может продолжаться; закрытие страницы тоже не подтверждает отмену. Завершайте работу явным прерыванием или отменой session и проверяйте результат. Один turn одновременно в session не означает одну параллельную задачу во всей организации.
5. Восстановление продолжает завершённые шаги, но эффекты могут повториться
Развёрнутая сессия хранит завершённые вызовы модели и инструментов отдельно от worker. После сбоя turn обычно продолжается с последнего завершённого шага, но может завершиться ошибкой или оставаться Running до лимита времени. Опасный промежуток — внешний эффект уже произошёл, а результат инструмента ещё не записан. Исход текущего вызова неизвестен, и модель впоследствии может вызвать инструмент снова. Устойчивость не гарантирует exactly-once транзакцию.
Атомарность должна обеспечиваться сервисом, владеющим эффектом. Формируйте стабильный ключ из бизнес-события и версии операции; серверное уникальное ограничение или штатный механизм идемпотентности должны распознать повтор. Иное содержание с тем же ключом — конфликт. Отдельная проверка «уже сделано?» перед записью содержит гонку. До повтора сверяйте реально произошедшее: отсутствие ответа не означает отсутствие исполнения.
Идемпотентность запросов session/turn и бизнес-инструмента — два слоя. Первый предотвращает дублирование работы, второй — повтор эффекта при повторных попытках внутри неё. Set в памяти worker не защищает разные процессы, перезапуски и конкурирующие вызовы. Локальный set ниже показывает лишь решение приёмки; это не производственная транзакция, реальный платёж, возврат или отправка письма.
6. Согласование относится к конкретному вызову, а не к неограниченным правам
Политика инструментов может разрешить, запросить согласование или запретить вызов. Открытый запрос отвечает callback приложения либо человек по его идентификатору. Текущая документация даёт ожиданию согласования один час по умолчанию. Без ответа инструмент не запускается; модель узнаёт об отсутствии одобрения, и turn может продолжиться. Это не гарантированная отмена всей задачи и не обещание ответа человека за час.
В интерфейсе согласования покажите действие, объект, сводку параметров и проверяемые основания, скрыв секреты. Проверьте полномочия согласующего для объекта. Не расширяйте одно разрешение до всех будущих аргументов. Даже документированное разрешение уровня session относится к тому же инструменту с теми же аргументами. Завершение ожидания, отказ человека и успешное исполнение — разные записи.
Карточка границ задачи
Объект: указанная версия DEMO-1, только чтение.
Разрешено: читать переданные материалы, сообщать о пробелах, составлять черновик обзора.
Запрещено: отправлять, публиковать, менять внешние записи или заодно исправлять TODO в материалах.
Вне рамок: записать действие и причину, не исполнять самостоятельно.
Нужно согласование: указать действие, объект и параметры, дождаться уполномоченного человека.
Условие выхода: при нехватке доказательств или прав отметить ожидание подтверждения, не имитировать готовность.Анализ Google Agent Distraction от 6 ноября полезен для сравнения границ: старые TODO могут вызвать незапрошенный поиск или изменения. Это наблюдательное исследование, а не доказательство одинаковой частоты у всех агентов или этого продукта. Материал следует считать доказательством, а не новой авторизацией. Очистка старых комментариев также требует истории и человеческого ревью, а не удаления всех TODO подряд.
7. Файл в песочнице ещё не является доставленным результатом
По умолчанию у агента нет песочницы исполнения кода; environment настраивается при необходимости Shell или файлов. У MistralSandbox и LocalDockerSandbox разные требования; размещённой песочнице дополнительно нужны соответствующий extra и роль cloud_user. access=files сохраняет запись и редактирование, поэтому это не режим чтения. Ограничивайте инструменты, файлы и сеть под задачу, а не заменяйте проверку прав названием песочницы.
Официальный SandboxHook даёт on_create для инициализации и on_destroy для сохранения при закрытии, но сбои hook, повтор worker и дубли загрузки требуют обработки. Предусмотрите независимое хранилище, контрольный дайджест и подтверждение. Фразы «файл создан» в чате мало. Закрытие session завершает песочницу; извлекайте сохраняемые результаты на подходящем этапе и обеспечивайте идемпотентность сохранения.
- Зафиксировать ID задачи, версию входа и границы
- Запустить выбранный режим и сохранить session/turn ID
- Выполнять инструменты по политике, показывать согласования
- Проверить финальный статус и структурированный вывод
- Сохранить файл, дайджест и бизнес-квитанцию
- Принять поставку только после независимой проверки
Песочницы и область доступа · Sandbox hooks и сохранение файлов
8. Проверьте собственное определение готовности локальным журналом
Сохраните JSON как fixture.json. Это авторские тестовые данные приложения, не схема ответа Mistral API. outcome заимствует проверенные имена типов, а approved, output_valid, artifact_verified и effect_key — собственные поля приёмки. Шесть записей охватывают успех, согласование, продолжающуюся работу, неверный формат, повтор и сбой. Реальных аккаунтов и внешних действий нет.
[
{
"case_id": "DEMO-1",
"outcome": "Completed",
"approved": true,
"output_valid": true,
"artifact_verified": true,
"effect_key": "report:DEMO-1:rev-a"
},
{
"case_id": "DEMO-2",
"outcome": "Blocked",
"approved": false,
"output_valid": false,
"artifact_verified": false,
"effect_key": "report:DEMO-2:rev-a"
},
{
"case_id": "DEMO-3",
"outcome": "Running",
"approved": false,
"output_valid": false,
"artifact_verified": false,
"effect_key": "report:DEMO-3:rev-a"
},
{
"case_id": "DEMO-4",
"outcome": "Completed",
"approved": true,
"output_valid": false,
"artifact_verified": false,
"effect_key": "report:DEMO-4:rev-a"
},
{
"case_id": "DEMO-1",
"outcome": "Completed",
"approved": true,
"output_valid": true,
"artifact_verified": true,
"effect_key": "report:DEMO-1:rev-a"
},
{
"case_id": "DEMO-5",
"outcome": "Failed",
"approved": false,
"output_valid": false,
"artifact_verified": false,
"effect_key": "report:DEMO-5:rev-a"
}
]Следующий блок сохраните как verify_fixture.py и выполните python3 verify_fixture.py в той же папке. Он только читает локальный JSON и печатает результат, без SDK, сети и изменения заказов или БД. Ожидаются один accept, три hold, один reject и один deduplicate; accepted_keys содержит только report:DEMO-1:rev-a. Это заданный assert результат демонстрации, а не оценка платформы.
import json
from pathlib import Path
def decide(row, seen):
if row["outcome"] != "Completed":
return "hold"
if not all(row.get(k) is True for k in ("approved", "output_valid", "artifact_verified")):
return "reject"
key = row["effect_key"]
if key in seen:
return "deduplicate"
seen.add(key)
return "accept"
rows = json.loads(Path("fixture.json").read_text(encoding="utf-8"))
seen = set()
decisions = [decide(row, seen) for row in rows]
assert decisions == ["accept", "hold", "hold", "reject", "deduplicate", "hold"]
print(json.dumps({"decisions": decisions, "accepted_keys": sorted(seen)}, ensure_ascii=False))
Пример намеренно не реализует реальные блокировки, планировщик повторов и устойчивые транзакции. Он проверяет, что приложение не принимает Running, Blocked, Failed или Completed без валидного файла как успех. Он не доказывает восстановление, оплату, изоляцию и безопасность параллельности. Далее в разрешённой тестовой среде проверьте сбой worker, повторы callback, истечение согласования и загрузки; локальный pass не является производственной гарантией.
9. После Completed проверяйте формат, содержание и подтверждения
SDK позволяет указать output_type на Agent. Временный output_type на дескрипторе session главным образом разбирает ответ, а не внедряет новую схему в уже начатый контекст модели. Возможны InvalidOutput или отсутствие финального вывода при лимите итераций или вывода. После Completed проверяйте тип, причину остановки, содержательные условия и файл, а не только пояснение в state.text.
| Сбой или граница | Тест | Сохраняемое подтверждение |
|---|---|---|
| Повтор входа | Дважды отправить одно бизнес-событие | Повторное использование результата или явный конфликт без дубля эффекта |
| Сбой worker | Выход после инструмента, но до записи результата | Квитанция бизнес-идемпотентности и состояние восстановления |
| Нет согласования | Истечение ожидания или отказ | Инструмент не выполнен, ответ callback и дальнейший статус |
| Неверный формат | Completed при неверной схеме или условиях | Ошибка разбора, исходный результат и отказ приёмки |
| Нет файла | Сбой загрузки или несовпадение дайджеста | Поставка приостановлена, ошибка хранения и запись повтора |
| Нет прав или выход за рамки | Новый TODO или другой объект в материалах | Запрет или ожидание без расширения полномочий |
Разделяйте суждение модели, реальный ответ инструмента, квитанцию бизнес-системы и решение человека. Лишь соответствующие подтверждения последних этапов устанавливают факт внешнего действия. При восстановлении одинаковое имя файла или похожий пересказ не заменяют стабильный ID, версию входа и проверку содержания. Право объявить поставку принятой определяет приложение.
10. Трассы объясняют путь, оценки — качество; у них есть границы доступа и данных
Трассировка Studio представляет цепочку деревом span с входом, выходом, задержкой, токенами и статусом. Документация указывает хранение 30 дней. У развёрнутых агентов она включена по умолчанию и может содержать prompt и completion. Стандартная очистка маскирует распространённые секреты, но не гарантирует безопасность всех клиентских данных. Проверьте реальные правила redaction, доступ и требования хранения.
Режимы и семантика устойчивости · Распределённая трассировка Studio · Очистка данных трассировки
Оценка — отдельный слой. Официальный офлайн Evaluation SDK следует Dataset → Task → Evaluators → Results, находится в превью и доступен только Enterprise-организациям. До загрузки в Studio подтвердите доступ. Без него можно выполнять локальные assert, как здесь, но нельзя называть их проведённой оценкой Studio. Возможность прочитать документацию не доказывает включение функции у организации.
Составьте фиксированный небольшой набор и отдельно оценивайте верность доказательствам, состояния, неразрешённые действия, формат и файлы. Не ограничивайтесь общей самооценкой модели. Записывайте версии набора, промпта, инструментов и конфигурации; сначала наблюдайте регрессии на отложенных примерах, затем постепенно подключайте трафик. Мы не измеряли пропускную способность, цену или успешность и не придумываем процент экономии.
11. Начните с небольшой пилотной задачи
Выберите одну задачу чтения и ограниченные инструменты, определите бизнес-смысл успеха, ожидания, отклонения и ошибки. Подтвердите доступ организации, направления данных, условия песочницы и хранилище файлов. В разрешённой среде проверьте рестарт, повтор события, согласование и неверный вывод; потом добавляйте инструменты с эффектами. Для каждого нового действия заново проверяйте идемпотентность и полномочия: пилотное разрешение не покрывает всю систему.
Сохраните предыдущую конфигурацию и способ остановить поступление задач. При необходимости закройте приём новых, обработайте работающие и ожидающие согласования сессии по записям, затем сверьте эффекты и файлы. Откат развёртывания не отзывает отправленные сообщения и не отменяет изменённые бизнес-записи. Основание восстановления — исходный ввод, версии инструментов и квитанции, а не вопрос модели «что ты сделала?».
Ценность обновления Mistral — объединение цикла исполнения, устойчивого состояния, согласований и наблюдаемости на одной поверхности разработки. Приложение по-прежнему переводит состояние платформы в проверяемый бизнес-результат. Готовый к поставке агент не просто продолжает говорить: после повторов, ожидания и ошибок он показывает, что сделал, чего не сделал и где лежат доказательства.
Здесь разобраны границы платформы Mistral. Подписки Claude и ChatGPT, API-кредиты и товары нашего сайта — другие продукты и счета. Существующие руководства ниже дополняют тему восстановления, весов и API. Из статьи нельзя заключать, что мы продаём управляемый сервис Mistral.