Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Preskúmaj: Vyhľadávaj a kontroluj produkčné stopy

Lekcia 12 z 16 Aktualizované 2. novembra 2026 Pokročilý
Na tejto strane
  1. Explorer: Tvoje okno do produkcie
  2. Odosielanie stôp
  3. Čo obsahuje stopa
  4. Jazyk vyhľadávania
  5. Dotazovanie na stopy cez SDK
  6. Pridávanie rozsahov do datasetu
  7. Kľúčové poznatky

Lekcia prepísaná 2. novembra 2026 na základe stránok Mistral Send traces a Explore traces a SDK mistralai verzie 3.7.0: Explorer sa zameriava na stopy OpenTelemetry dotazované pomocou jazyka vyhľadávacieho výrazu; staršia metóda chat_completion_events.search už neexistuje. Zdroje: Send traces · Explore traces.

Explorer: Tvoje okno do produkcie

Trace Explorer je miesto, kde vyhľadávaš, filtruješ a kontroluješ každú stopu prechádzajúcu tvojimi aplikáciami umelej inteligencie. Nájdeš ho v Studiu pod Observability → Traces. Stopy sa tam však nezobrazia, pokiaľ ich najprv nepovolíš: sledovanie je predvolene vypnuté.

Odosielanie stôp

Pomocou Python SDK si nainštaluj rozšírenie telemetrie (mistralai[telemetry], verzia 2.4.13 alebo novšia) a potom ho povoľ 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 tohto momentu SDK automaticky sleduje volania modelov, vektory (embeddings), operácie agentov, dokončenia FIM a OCR. Volania tvojich vlastných nástrojov sa predvolene nesledujú: musíš pridať ich rozsahy (spans) pomocou trasovača 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

Iné zdroje sa správajú odlišne: Workflows sledujú každé vykonanie hneď, ako je na službe nastavené OTEL_ENABLED=true, zatiaľ čo Vibe Work sa aktivuje cez nastavenie administrátora v Studiu. TypeScript SDK ponúka configureTelemetry. Naopak, Vibe Code (CLI a Web) a Studio Playground stopy neodosielajú. Všetky zdroje pred exportom predvolene redigujú časť údajov; stránka Data redaction podrobne opisuje túto zásadu a spôsob jej úpravy.

Čo obsahuje stopa

Stopa je strom rozsahov (spans), kde každý rozsah predstavuje operáciu v reťazci:

PoleObsah
Trace IDIdentifikátor celého reťazca vykonávania
SpansOperácie: volania modelov, volania nástrojov, kroky workflow
DurationČas pre každý rozsah a celú stopu
TokensVstupné a výstupné tokeny pre každé volanie modelu
StatusÚspech alebo chyba, vrátane chybovej správy
SourcePôvodný produkt: SDK, Workflows, Vibe Work
TagsŠtítky aplikované SDK a automatické metadáta, ako je model

Kliknutím na stopu otvoríš jej strom rozsahov; každý rozsah sa rozbalí a zobrazí vstup, výstup, latenciu a tokeny.

Jazyk vyhľadávania

Explorer prijíma jazyk výrazov: podmienky pre polia stôp kombinované pomocou AND, OR a NOT.

KategóriaOperátoryPríklad
Porovnanie=, !=, <, <=, >, >=duration_ns > 5000000000
VzorecLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
PodreťazecCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Regulárny výrazREGEXP, NOT REGEXPservice_name REGEXP '^my-'
RozsahBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
ZoznamIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
PrítomnosťEXISTS, NOT EXISTSerror_message EXISTS

Dostupné polia zahŕňajú service_name, status_code (Ok alebo Error), duration_ns (v nanosekundách), error_message, start_time, models_used (zoznam) a akýkoľvek atribút rozsahu pomocou syntaxe zátvoriek: span_attributes['gen_ai.request.model']. Pre zoznamy funkcie has(models_used, 'mistral-medium-latest'), hasany(...) a hasall(...) dopĺňajú operátor CONTAINS.

# Všetky neúspešné stopy zo služby
service_name = 'agent-support' AND status_code = 'Error'

# Stopy dlhšie ako 5 sekúnd
duration_ns > 5000000000

# Stopy, ktoré volali konkrétny model
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'

Ak vyhľadávanie nevráti žiadne výsledky, odstráň všetky podmienky okrem časového rozsahu a potom ich pridávaj späť jednu po druhej. Častou chybou je filtrovanie podľa status_code = 'Error', keď väčšina stôp úspešne prebehne.

Dotazovanie na stopy cez SDK

Rovnaké vyhľadávania môžeš vykonávať programovo 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")

Odozva využíva stránkovanie založené na kurzore. Referencia API dokumentuje koncové body Traces a Spans (vyhľadávanie, jednotlivá stopa, možné polia a hodnoty, rozsahy stopy).

Pridávanie rozsahov do datasetu

Explorer slúži aj ako východiskový bod pre testovacie datasety. Zo stopy ponúka menu rozsahu možnosť Add span to dataset; v zobrazení Spans môžeš naraz vybrať až 500 položiek a namapovať každé pole rozsahu na pole záznamu. Táto funkcia súvisí s offline hodnoteniami, ktoré sú vyhradené pre organizácie Enterprise (Lekcia 15).

Kľúčové poznatky

  • Sledovanie je predvolene vypnuté: configure_telemetry(client) ho povoľuje pre Python SDK, OTEL_ENABLED=true pre Workflows
  • Volania modelov sa sledujú automaticky; volania nástrojov vyžadujú manuálne sledovanie pomocou get_telemetry_tracer
  • Explorer filtruje stopy pomocou jazyka výrazov (service_name, status_code, duration_ns, span_attributes['…'])
  • SDK poskytuje rovnakú vyhľadávaciu schopnosť: client.beta.observability.traces.search(search_expression=...)
  • Zaujímavé rozsahy sa stanú záznamami datasetu jediným kliknutím alebo v dávkach po 500