Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Průzkumník: Vyhledávání a inspekce produkčních stop

Lekce 12 z 16 Aktualizováno 2. listopadu 2026 Pokročilý
Na této stránce
  1. Průzkumník: Tvé okno do produkce
  2. Odesílání stop
  3. Co stopa obsahuje
  4. Vyhledávací jazyk
  5. Dotazování na stopy prostřednictvím SDK
  6. Přidávání rozsahů do datové sady
  7. Klíčové poznatky

Lekce přepsána 2. listopadu 2026 na základě stránek Mistral Send traces a Explore traces a SDK mistralai verze 3.7.0: Průzkumník se zaměřuje na stopy OpenTelemetry dotazované pomocí vyhledávacího jazyka výrazů; zastaralá metoda chat_completion_events.search již neexistuje. Zdroje: Send traces · Explore traces.

Průzkumník: Tvé okno do produkce

Průzkumník stop (Trace Explorer) je místo, kde vyhledáváš, filtruješ a kontroluješ každou stopu procházející tvými aplikacemi s umělou inteligencí. Najdeš jej ve Studiu v sekci Observability → Traces. Stopy se zde však nezobrazí, pokud je nejprve nepovolíš: trasování je ve výchozím nastavení vypnuté.

Odesílání stop

Při použití Python SDK nainstaluj rozšíření pro telemetrii (mistralai[telemetry], verze 2.4.13 nebo novější) a poté jej povol na klientovi:

from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry

client = Mistral(api_key="your-api-key")
configure_telemetry(client)

Od tohoto okamžiku SDK automaticky trasuje volání modelů, vnoření (embeddings), operace agentů, dokončování FIM a OCR. Volání tvých vlastních nástrojů nejsou ve výchozím nastavení trasována: musíš přidat jejich rozsahy (spans) pomocí trasovače SDK.

from mistralai.extra.observability import get_telemetry_tracer

tracer = get_telemetry_tracer(client, "agent-support")

with tracer.start_as_current_span("invoke_agent"):
    response = client.chat.complete(
        model="mistral-small-latest",
        messages=[{"role": "user", "content": "What is the status of order 4521?"}],
    )
    with tracer.start_as_current_span("execute_tool order_tracking") as span_tool:
        span_tool.set_attribute("gen_ai.tool.name", "order_tracking")
        span_tool.set_attribute("gen_ai.tool.call.arguments", "4521")
        # call your tool here

Jiné zdroje se chovají odlišně: Workflows trasují každé spuštění, jakmile je na službě nastaveno OTEL_ENABLED=true, zatímco Vibe Work se aktivuje prostřednictvím nastavení správce ve Studiu. TypeScript SDK nabízí configureTelemetry. Naproti tomu Vibe Code (CLI a Web) a Studio Playground stopy neodesílají. Všechny zdroje ve výchozím nastavení před exportem část dat redigují; stránka Data redaction podrobně popisuje tuto zásadu a způsob její úpravy.

Co stopa obsahuje

Stopa je strom rozsahů (spans), kde každý rozsah představuje operaci v řetězci:

PoleObsah
Trace IDIdentifikátor celého řetězce provádění
SpansOperace: volání modelů, volání nástrojů, kroky workflow
DurationDoba trvání každého rozsahu a celé stopy
TokensVstupní a výstupní tokeny pro každé volání modelu
StatusÚspěch nebo chyba, včetně chybové zprávy
SourcePůvodní produkt: SDK, Workflows, Vibe Work
TagsŠtítky aplikované SDK a automatická metadata, jako je model

Kliknutím na stopu otevřeš její strom rozsahů; každý rozsah se rozbalí a zobrazí vstup, výstup, latenci a tokeny.

Vyhledávací jazyk

Průzkumník přijímá jazyk výrazů: podmínky pro pole stop kombinované pomocí AND, OR a NOT.

KategorieOperátoryPříklad
Porovnání=, !=, <, <=, >, >=duration_ns > 5000000000
VzorLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
PodřetězecCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Regulární výrazREGEXP, NOT REGEXPservice_name REGEXP '^my-'
RozsahBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
SeznamIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
ExistenceEXISTS, NOT EXISTSerror_message EXISTS

Mezi dostupná pole patří service_name, status_code (Ok nebo Error), duration_ns (v nanosekundách), error_message, start_time, models_used (seznam) a jakýkoli atribut rozsahu pomocí syntaxe závorek: span_attributes['gen_ai.request.model']. Pro seznamy funkce has(models_used, 'mistral-medium-latest'), hasany(...) a hasall(...) doplňují operátor CONTAINS.

# Všechny neúspěšné stopy ze služby
service_name = 'agent-support' AND status_code = 'Error'

# Stopy delší než 5 sekund
duration_ns > 5000000000

# Stopy, které volaly konkrétní model
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'

Pokud vyhledávání nevrátí žádné výsledky, odstraň všechny podmínky kromě časového rozsahu a poté je znovu přidávej po jedné. Častou chybou je filtrování podle status_code = 'Error', když většina stop uspěje.

Dotazování na stopy prostřednictvím SDK

Stejné vyhledávání můžeš provádět programově v rámci časového rozsahu:

from datetime import datetime, timedelta, timezone

from mistralai.client import Mistral

client = Mistral(api_key="your-api-key")
now = datetime.now(timezone.utc)

response = client.beta.observability.traces.search(
    from_=now - timedelta(days=1),
    to=now,
    search_expression="service_name = 'agent-support' AND status_code = 'Error'",
    page_size=50,
)

for trace in response.traces.results or []:
    print(f"{trace.trace_id} {trace.root_span_name} : {trace.duration_ns / 1e9:.1f} s")

Odpověď využívá stránkování založené na kurzoru. Reference API dokumentuje koncové body Traces a Spans (vyhledávání, jednotlivá stopa, možná pole a hodnoty, rozsahy stopy).

Přidávání rozsahů do datové sady

Průzkumník slouží také jako výchozí bod pro testovací datové sady. Ze stopy nabízí nabídka rozsahu možnost Add span to dataset; v zobrazení Spans můžeš najednou vybrat až 500 položek a namapovat každé pole rozsahu na pole záznamu. Tato funkce souvisí s offline evaluacemi, které jsou vyhrazeny pro organizace Enterprise (lekce 15).

Klíčové poznatky

  • Trasování je ve výchozím nastavení vypnuto: configure_telemetry(client) jej povolí pro Python SDK, OTEL_ENABLED=true pro Workflows
  • Volání modelů jsou trasována automaticky; volání nástrojů vyžadují ruční trasování pomocí get_telemetry_tracer
  • Průzkumník filtruje stopy pomocí jazyka výrazů (service_name, status_code, duration_ns, span_attributes['…'])
  • SDK poskytuje stejnou funkci vyhledávání: client.beta.observability.traces.search(search_expression=...)
  • Zajímavé rozsahy se stanou záznamy datové sady jedním kliknutím nebo v dávkách po 500