Mistral, Managed Agents ile bir grup Studio özelliğini 5 Kasım 2026’da duyurdu. Kontrol tarihimiz 7 Kasım itibarıyla Managed Agents ve Agents SDK hâlâ genel ön izlemede: API’ler, davranış ve sınırlar değişebilir. Bu bir çalışma ortamı ve işletim güncellemesidir; ön izleme belgesinin açık olması her kuruluşun tüm özelliklere eriştiğini göstermez.

Mistral: 5 Kasım 2026 sürüm notları · Managed Agents özeti ve ön izleme sınırları

Kurgu bir salt okunur belge inceleme görevinden başlayacağız: belirli sürümü oku, rapor oluştur, gerektiğinde insanı bekle ve doğrulanabilir dosyayı sakla. Gerçek araçları bağlamadan önce durumları, izinleri ve teslimat kanıtını tasarlayın. Örnekler üretim ölçümü değildir; okuyucu adına Mistral hizmeti açmaz.

1. Yenilik, model ağırlıklarına başka giriş değil, çalışma ortamı

5 Kasım sürüm notları Managed Agents’ı SDK genel ön izlemesi olarak, varsayılan izleme ile çevrimdışı ve çevrimiçi değerlendirmeler gibi Studio güncellemeleriyle birlikte listeliyor. Sürüm listesindeki erişilebilirlik etiketleri her parçanın aynı kuruluş izinlerine sahip olduğunu göstermez. Örneğin çevrimdışı değerlendirme belgesi erişimin Enterprise düzeyi kuruluşlarla sınırlı olduğunu açıkça belirtiyor; Observability için de bu koşul var. Ekip planından önce ilgili özellik sayfasını inceleyin.

Mistral: 5 Kasım 2026 sürüm notları · Çevrimdışı değerlendirme ve Enterprise koşulu

Tek model yanıtı sonraki çıktıyı üretir; ajan ayrıca araç seçmeli, adımları saklamalı, bekleme ve hataları yönetmelidir. Mühendislik değişimi bu eylemleri oturuma ve yürütme kaydına alarak uygulamanın işi yeniden bulabilmesidir. Bu, 2 Kasım yazımızdaki Large 4 ağırlıkları, lisans ve bellekten farklı bir sorudur. Açık ağırlık lisansı barındırılan hizmetin veri sınırlarını belirlemez.

Önce hassas bilgilerden arındırılmış bir kanıt paketi gibi sınırları açık, sonucu bağımsız incelenebilir görev seçin. “Saatler veya günler çalışabilir” açıklamasını kesintisizlik garantisi ya da sınırsız kullanım saymayın. Amaç, teslimatı yalnız tamamlanmış görünen sohbet metnine bırakmamak için hata, bekleme, tekrar ve kabulü tanımlamaktır.

2. Üç çalışma modu: kendi worker’ınız tüm veriyi yerelde tutmaz

Modelin, yürütme döngüsünün, araç kodunun, oturum kaydının ve sandbox’ın yerini ayrı belirleyin. Çalışma modu oturum döngüsü ve araçları hangi sürecin çalıştıracağını seçer; sandbox konumu ayrıca yapılandırılır. Belgelenen varsayılan yolda kendi worker’ınız olsa da oturum saklama ve yönlendirme Mistral kontrol düzlemindedir; model çağrıları da Mistral’a gider. Aracın ağınızda olması sistemi çevrimdışı veya dışarı veri çıkmaz yapmaz.

Çalışma modları ve kalıcılık

Resmî çalışma modlarında sorumluluk dağılımı; sandbox ortamı ayrıca seçilir.
ModSizin çalıştırdığınızOturum ve sınır
Yerel, süreç içindeProgramınız ve araçlarınızOturum ağırlıkla süreç belleğindedir ve süreçle biter; deneysel journal ayrı konudur
Kendi worker’ınızProgramınız ve agents serve süreciOturumu Mistral saklar ve worker’a yönlendirir; araçlar sizin süreçtedir
Mistral yönetimindeUygulamanız; worker’ı platform derler ve çalıştırırGit projesinden dağıtılır; oturum Mistral’da, araç kodu onun altyapısındadır

Ağ yakınlığı, araç kodunu denetleme ve veri yerleşimi taahhüdünü ayrı inceleyin. Denetim kaydında en az çalışma modu, araç sunucusu, model girişi ve oturumun saklandığı yer bulunmalı. Resmî sözleşme veya proje ayarıyla desteklenmeyen bölge ve saklama taahhüdüne bilinmiyor yazın. Worker dağıtımını değiştirmek mevcut oturumları otomatik taşımaz veya silmez.

3. Gerçek sistemlerden önce salt okunur bir ajan tanımlayın

Güncel resmî belgeler mistralai-agents paketi, from mistralai import agents, agents.Agent ve @agents.tool arayüzlerini kullanıyor. İşlev adı, docstring ve tür açıklamaları modelin gördüğü araç tanımını oluşturur; araçları modülün üst düzeyinde tanımlayın. Aşağıdaki yalnız bellekteki kurgu kaydı okuyan ajanı tanımlar. run çağrısı, sandbox veya gerçek iş bağlantısı başlatmaz. SDK kurulup çalıştırılmadan sözdizimi ve resmî örüntü kontrol edildi.

Managed Agents özeti ve ön izleme sınırları · Araç tanımı ve hata yönetimi

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.

Örneğin değeri sınırı araç uygulamasında daraltmasıdır: yalnız DEMO-1 döner, başka kimlikte beklenen araç hatası verir. Gerçek hizmette çağıran ve kaynak yetkisi sunucuda ayrıca kontrol edilmelidir; “salt okunur” istemi yazmayı tek başına önlemez. Bir aracı tek veri nesnesinden sorumlu tutmak; tüm depo, Shell ve bağlayıcıları birden açmaktan daha kolay denetlenir.

Beklenen iş hatasını program kusurundan ayırın. Güncel belge ToolError ile modele anlaşılır iş açıklaması verir; beklenmeyen istisnanın tüm yığın izi varsayılan olarak modele gösterilmez. Üretim logları yine iç bilgi tutabilir. Hata metnine kimlik bilgisi veya müşterinin asıl metnini eklemeyin; SDK hata politikasını uçtan uca anonimleştirme garantisi saymayın.

Araç tanımı ve hata yönetimi · Sırlar ve kimlik bilgisi sınırları

4. Oturumu, turu ve iş teslimatının durumunu ayırın

Oturum birden çok mesajı ve araç sonucunu saklar; tur onun içindeki tek işlem çevrimidir. Resmî start_session ve session.run örneklerindeki idempotans anahtarları aynı iş olayının tekrarında ilk oturum ve turun dönmesini sağlar. Uygulamada session_id, turn_id ve girdi sürümünü saklayın; tanıtıcı kayboldu diye yeni görev açmayın. Bunlar kendi iş görev numaranızın yerini tutmaz.

Oturumlar ve istek idempotans anahtarları

Dönen kayıt sonraki adımı belirler; doğrudan iş başarısı değildir.
Dönen durumAnlamıUygulamanın yapacağı
RunningBeklemeniz bittiğinde tur hâlâ çalışırYeniden bekleyin veya sorgulayın; tamamlandı demeyin
BlockedOnay veya başka callback yanıtını beklerBekleyen işi yetkili kişiye gösterin
BusyOturumda tur zaten çalışır; yenisi başlamadıMevcut tur tanıtıcısını kullanın; körlemesine iş yaratmayın
CompletedTur normal sona erdiÇıktıyı, durma nedenini ve dosyayı kontrol edin
Interrupted / FailedDurduruldu veya hatayla bittiNedeni kaydedip yeniden denemeyi ve yan etkiyi uzlaştırın
Bilinmeyen yeni türSDK daha yeni sonucu tanımıyorTemkinli bekletip uyumluluğu güncelleyin; başarılı varsaymayın

Timeout kolay karışır: bekleme metodundaki timeout, çağıranın ne kadar beklediğini sınırlar; turun ömrünü değil. Running dönünce iş sürebilir; sayfanın kapanması iptali kanıtlamaz. Bitirmek için açık kesme veya oturum iptali akışını kullanıp sonucu yeniden gözleyin. Oturum başına tek tur, kuruluşun tamamında tek eşzamanlı görev demek değildir.

Turlar ve dönen kayıtlar

5. Kurtarma bitmiş adımlardan sürer; yan etkiler tekrarlanabilir

Dağıtılmış oturum, biten model ve araç çağrılarını worker’dan ayrı kaydeder. Worker arızasından sonra tur genellikle son biten adımdan sürer; ama hata verebilir veya süre sınırına kadar Running kalabilir. Tehlikeli aralık, araç dış sistemi değiştirdiği hâlde sonucun oturuma yazılmadığı andır. Devam eden çağrının sonucu belirsizdir ve model aracı yeniden çağırabilir. Kalıcılık, işlemin tam bir kez olacağı garantisi değildir.

Çalışma modları ve kalıcılık

Atomiklik gerçek yan etkinin sahibi hizmette olmalı. İş olayı ve işlem sürümünden kararlı idempotans anahtarı üretin; sunucu benzersizlik kısıtı veya yerel idempotans arayüzü tekrarı tanısın. Aynı anahtarla farklı içerik çatışmadır. Önce yapıldı mı sorgulayıp sonra yazmak eşzamanlılık yarışı içerir. Tekrardan önce gerçekte olanı uzlaştırın; yanıt gelmemesi işlemin yapılmadığını kanıtlamaz.

Session/turn isteğinin idempotansı ile iş aracının idempotansı iki katmandır. İlki aynı işi tekrar oluşturmamayı, ikincisi o iş içindeki tekrarın etkiyi yinelememesini sağlar. Worker belleğindeki set süreçler, yeniden başlatma ve eşzamanlılık boyunca koruma vermez. Aşağıdaki yerel set yalnız kabul kararını gösterir; üretim işlemi, gerçek ödeme, iade veya e-posta gönderimi değildir.

6. Onay, belirli araç çağrısının eşiğidir; sınırsız yetki değildir

Araç izin politikası çağrıya izin verebilir, sorabilir veya reddedebilir. Uygulama callback’i ya da kişi açık onayı callback kimliğiyle yanıtlar. Güncel belgede onay varsayılan olarak bir saat bekler. Yanıt gelmezse araç çalışmaz; model onay verilmediğini okur ve tur devam edebilir. Yanıtsız onayı tüm görevin kesin iptali veya bir saati insan yanıt süresi taahhüdü saymayın.

Araç onayı ve bekleme süresi

Onay ekranı eylemi, nesneyi, parametre özetini ve incelenebilir iş kanıtını göstermeli; sırları gizlemeli ve onaylayanın nesne üzerindeki yetkisini kontrol etmelidir. Bir çağrıya izni uygulamada gelecekteki tüm parametrelere genişletmeyin. Belgelenen oturum kapsamlı izin de aynı araç ve aynı argümanlarla ilgilidir. Beklemenin bitmesini, kişinin reddini ve başarılı araç çalışmasını ayrı kaydedin.

Görev kapsam kartı
Nesne: DEMO-1’in belirtilen sürümü, salt okunur.
İzin verilen: verilen malzemeyi oku, kanıt eksiklerini bildir, inceleme taslağı çıkar.
Yasak: gönderme, yayımlama, dış kayıt değiştirme veya malzemedeki TODO’ları ayrıca düzeltme.
Kapsam dışı istek: işi ve nedenini kaydet, kendiliğinden çalıştırma.
Onay gerekirse: eylemi, nesneyi ve parametre özetini yaz; yetkili kişiyi bekle.
Çıkış koşulu: eksik kanıtı veya izni teyit bekliyor yaz; tamamlanmış gibi gösterme.

Google’ın 6 Kasım Agent Distraction analizi yararlı bir karşılaştırma sunuyor: koddaki eski TODO’lar istenmeyen arama veya değişikliğe yol açabilir. Bu gözlemsel bir çalışmadır; her ajan veya bu ürün için aynı oranı kanıtlamaz. Mühendislik dersi okunan malzemeyi yeni yetki değil kanıt saymaktır. Eski yorum temizliği de geçmişi kontrol ve insan incelemesi gerektirir; bütün TODO’ları topluca silmek değildir.

Google: Agent Distraction gözlemsel analizi

7. Sandbox’ta dosya üretmek teslimatı tamamlamaz

Ajanın varsayılan olarak kod çalıştırma sandbox’ı yoktur; Shell veya dosya gerektiğinde environment ayarlanır. MistralSandbox ve LocalDockerSandbox farklı ön koşullara sahiptir; yönetilen sandbox ilgili extra ile cloud_user rolü de ister. access=files yazma ve düzenlemeyi korur, salt okunur değildir. Araç, dosya ve ağı göreve göre sınırlandırın; sandbox adını izin incelemesi yerine koymayın.

Resmî SandboxHook, başlangıçta on_create ve kapanışta çıktı saklamak için on_destroy sunar. Yine de hook hatası, worker tekrar yürütmesi ve yinelenen yükleme ele alınmalıdır. Bağımsız dosya deposu, içerik özeti ve teyit edilmiş alındı hazırlayın; son sohbette “dosya üretildi” demek yetmez. Oturum kapanınca sandbox biter; korunacak çıktıyı uygun aşamada çıkarın ve kaydetmeyi de idempotent yapın.

  1. Görev numarası, girdi sürümü ve kapsamı sabitle
  2. Modu başlat, session/turn kimliklerini sakla
  3. Araçları politikayla çalıştır, beklemede onayı göster
  4. Son durumu ve yapılandırılmış çıktıyı incele
  5. Dosyayı, özeti ve iş alındısını sakla
  6. Bağımsız denetimden sonra teslimatı kabul et
Özgün teslimat zinciri: her geçiş gözlenebilir kanıt ister; son metin ara adımların yerine geçmez.

Sandbox ortamı ve erişim kapsamı · Sandbox hook’ları ve dosya saklama

8. Kendi “tamamlandı” tanımınızı çevrimdışı kayıtla sınayın

Aşağıdaki JSON’u fixture.json olarak kaydedin. Bu özgün uygulama test verisidir, Mistral API yanıt biçimi değildir. outcome doğrulanmış dönüş türü adlarını kullanır; approved, output_valid, artifact_verified ve effect_key bize ait kabul alanlarıdır. Altı kayıt başarı, bekleyen onay, sürmekte olan iş, geçersiz biçim, yinelenen olay ve hatayı kapsar. Gerçek hesap veya dış eylem yoktur.

[
  {
    "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"
  }
]

Sonraki kodu verify_fixture.py olarak kaydedip aynı dizinde python3 verify_fixture.py ile çalıştırın. Yalnız yerel JSON okur ve yazdırır; SDK, ağ, sipariş veya veritabanı değişikliği yoktur. Bir accept, üç hold, bir reject ve bir deduplicate beklenir; accepted_keys yalnız report:DEMO-1:rev-a içerir. Bu, assert ile belirlenen gösterim sonucudur; platform performans ölçümü değildir.

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))

Örnek bilerek gerçek kilit, tekrar zamanlaması ve kalıcı işlem uygulamaz. Kanıtladığı, Running, Blocked, Failed ya da geçerli dosyası olmayan Completed sonucunun doğrudan başarı kabul edilmemesidir. Gerçek kurtarma, ücret, izolasyon ve eşzamanlılık güvenliğini kanıtlamaz. Sonraki aşamada izinli test ortamında worker çökmesi, yinelenen callback, onay süresinin dolması ve yükleme hatasını sınayın; yerel pass sonucunu üretim garantisi saymayın.

9. Completed sonrasında biçimi, içeriği ve alındıyı doğrulayın

SDK, Agent üzerinde output_type tanımlayabilir. Oturum tanıtıcısında geçici output_type vermek esas olarak yanıtı ayrıştırır; başlamış model bağlamına yeni şemayı otomatik eklemez. InvalidOutput veya yineleme/çıktı sınırında son çıktı eksikliği olabilir. Completed sonrasında türü, durma nedenini, içerik koşullarını ve dosyayı inceleyin; state.text içinde açıklama bulmakla yetinmeyin.

Yapılandırılmış çıktı ve InvalidOutput

Yayına geçmeden önce asgari kabul matrisi; bunlar yazının mühendislik önerileridir.
Hata veya sınırUygulanan testSaklanacak kanıt
Yinelenen girdiAynı iş olayını iki kez göndermeTekrar etki olmadan aynı sonuç veya açık çatışma
Worker kesilmesiAraç bittiğinde ama sonuç kaydedilmeden çıkışİş idempotans alındısı ve kurtarma durumu
Yanıtsız onayBeklemenin dolması veya retAracın çalışmaması, callback sonucu ve sonraki durum
Geçersiz biçimCompleted fakat şema veya iş koşulu yanlışAyrıştırma hatası, ham çıktı ve kabul reddi
Eksik dosyaYükleme hatası veya özet uyuşmazlığıTeslimatın bekletilmesi, depo hatası ve tekrar kaydı
İzinsiz veya kapsam dışıMalzemede yeni TODO veya başka nesneGörev yetkisini genişletmeden ret/bekleme

Model yargısını, aracın gerçek yanıtını, iş sisteminin alındısını ve insan kararını ayrı alanlarda tutun. Dış eylemin gerçekleştiğini ancak sonraki tür kanıtlar gösterebilir. Kurtarmada aynı dosya adı veya benzer doğal dil özeti; kararlı görev numarası, girdi sürümü ve içerik denetiminin yerini tutmaz. Teslimatı kimin kabul edebileceğini uygulama belirlemelidir.

10. İzler yolu, değerlendirme kaliteyi açıklar; erişim ve veri sınırları vardır

Studio izleme; girdi, çıktı, gecikme, token ve durum içeren span ağacı gösterir. Belge izlerin 30 gün tutulduğunu söyler. Dağıtılmış ajanlarda varsayılan Studio izleri prompt ve completion içerebilir. Varsayılan maskeleme yaygın hassas öğeleri gizler ama tüm müşteri içeriğinin otomatik güvenli olduğunu kanıtlamaz. Gerçek redaction kurallarını, erişimi ve saklama ihtiyacını inceleyin.

Çalışma modları ve kalıcılık · Studio dağıtılmış izleme · İz verilerinin maskelenmesi

Değerlendirme ayrı katmandır. Resmî çevrimdışı Evaluation SDK, Dataset → Task → Evaluators → Results akışını kullanır; genel ön izlemededir ve yalnız Enterprise düzeyi kuruluşlara açıktır. Studio’ya veri yüklemeden önce uygunluğu doğrulayın. Erişiminiz yoksa bu yazıdaki yerel assert kontrollerini yapabilirsiniz; buna çalıştırılmış Studio değerlendirmesi diyemezsiniz. Belgeyi okuyabilmek kuruluşunuzda özelliğin açık olduğunu kanıtlamaz.

Çevrimdışı değerlendirme ve Enterprise koşulu

Sabit küçük veri kümesi oluşturun; kanıt sadakatini, durum yönetimini, yetkisiz eylemleri, biçimi ve dosyaları ayrı puanlayın. Modelin kendine verdiği toplam puana dayanmayın. Veri kümesi, istem, araç ve model yapılandırması sürümlerini kaydedin; gerçek trafiğe aşamalı geçmeden önce ayrılmış kümede gerilemeleri inceleyin. Verim, maliyet veya başarı ölçmedik; yönetilen çözüm için tasarruf oranı uydurmayacağız.

11. Yönetilen dağıtıma karar vermeden önce küçük bir pilot yapın

Tek salt okunur görev ve sınırlı araçlarla başlayın; başarı, bekletme, ret ve hatanın iş anlamlarını tanımlayın. Kuruluş erişimini, veri yönünü, sandbox koşullarını ve dosya deposunu teyit edin. İzinli ortamda yeniden başlatma, tekrar olay, onay ve geçersiz çıktıyı sınadıktan sonra yan etkili araçlara geçin. Her yeni dış eylemde yetki ve idempotansı tekrar inceleyin; pilot iznini tüm sisteme yaymayın.

Önceki yapılandırmayı ve yeni iş alımını kapatma yolunu saklayın. Gerektiğinde yeni görevleri durdurup çalışan ve onay bekleyen oturumları kayıtlarına göre yönetin; sonra oluşmuş etkileri ve dosyaları uzlaştırın. Dağıtımı geri almak gönderilmiş mesajı veya değiştirilmiş iş kaydını geri almaz. Kurtarmanın dayanağı özgün girdi, araç sürümü ve alındıdır; modele “az önce ne yaptın?” demek bunların yerini tutmaz.

Mistral güncellemesinin dikkate değer yanı yürütme döngüsü, kalıcı durum, insan onayı ve gözlemlenebilirliği aynı geliştirme yüzeyinde buluşturmasıdır. Platform durumlarını doğrulanabilir iş sonucuna çevirmek yine uygulamanızın görevidir. Teslim edilebilir ajan yalnız konuşmayı sürdüren değil; tekrar, bekleme ve hatadan sonra ne yaptığını, ne yapmadığını ve kanıtın nerede olduğunu gösterebilendir.

Bu yazı Mistral geliştirici platformunun sınırlarını ele alır. Claude ve ChatGPT abonelikleri, API kredileri ve sitemizdeki ürünler ayrı ürün ve hesaplardır. Durum kurtarma, ağırlık dağıtımı ve API uygulaması için aşağıdaki rehberlere bakın; burada Mistral yönetilen hizmeti sattığımızı varsaymayın.