Seguire una chiamata a uno strumento dall'inizio alla fine
Segua una richiesta lungo l'intero stack.
Seguire una chiamata a uno strumento dall'inizio alla fine è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.
Seguire una singola chiamata
Una singola chiamata a uno strumento può coinvolgere il server, un database e un'API. Il tracing unisce questi passaggi in un'unica sequenza temporale, così può vedere l'intero percorso. 🧵
Trace e span
Un trace rappresenta l'intera richiesta; uno span è un singolo passaggio al suo interno. Ogni span registra un nome, un inizio e una durata, e gli span si annidano come un albero.
Il trace ID
Ogni span di una richiesta condivide un unico trace ID. È questo ID condiviso che consente a uno strumento di ricostruire esattamente quali passaggi appartenevano alla stessa richiesta.
Span padre e figlio
Gli span sono collegati tramite un parent ID. La chiamata allo strumento è il padre; la query al database e la chiamata all'API ne diventano i figli, formando l'albero della sequenza temporale.
OpenTelemetry
In Python, lo standard per questo scopo è OpenTelemetry. Definisce trace, span e contesto, così i dati funzionano con molti backend, non con uno soltanto.
Avviare uno span
Racchiuda il lavoro in uno span utilizzando un context manager. Tutto ciò che si trova al suo interno viene misurato e annidato automaticamente nel trace corrente.
from opentelemetry import trace
tracer = trace.get_tracer("mcp")
with tracer.start_as_current_span("search_tool"):
run_search()Aggiungere attributi
Arricchisca uno span con attributi: piccoli dati chiave-valore, come il nome dello strumento o il numero di risultati. In seguito renderanno il trace molto più facile da leggere.
span = trace.get_current_span()
span.set_attribute("tool.name", "search")
span.set_attribute("result.count", 3)Gli span rilevano gli errori
Quando un passaggio non riesce, contrassegni il relativo span con lo stato di errore. Il trace mostrerà esattamente quale passaggio ha interrotto la richiesta, non soltanto che si è verificato un problema.
Propagazione del contesto
Per eseguire il tracing attraverso una chiamata di rete, trasmetta il contesto del trace negli header. Questa propagazione mantiene il passaggio remoto all'interno dello stesso trace.
Collegare i log ai trace
Inserisca il trace ID anche nei log strutturati. Ora una riga di log e il relativo trace completo rimandano l'uno all'altro, rendendo il debugging molto più rapido.
Esportazione dei trace
Gli span vengono inviati a un backend tramite un exporter, spesso usando il protocollo OTLP. Il backend disegna quindi la sequenza temporale che può esplorare.
Controllo rapido
Verifichiamo la struttura del trace.
Riepilogo
Ora può eseguire il tracing di una chiamata dall'inizio alla fine, con span sotto un unico trace ID, arricchiti da attributi e stato di errore, oltre a log direttamente collegati. 🗺️
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Seguire una chiamata a uno strumento dall'inizio alla fine» è gratuita?
Sì — il testo completo di «Seguire una chiamata a uno strumento dall'inizio alla fine» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.
Cosa imparerò in «Seguire una chiamata a uno strumento dall'inizio alla fine»?
Segua una richiesta lungo l'intero stack. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare MCP Academy?
Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Seguire una chiamata a uno strumento dall'inizio alla fine»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione MCP Academy?
Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Che cosa misurare in un server
- Log strutturati ricercabili
- Seguire una chiamata a uno strumento dall'inizio alla fine
- Generare avvisi per errori e abusi