Seguir una llamada a herramienta de principio a fin
Siga una solicitud por toda la pila.
Seguir una llamada a herramienta de principio a fin es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de MCP Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de MCP Academy incluye 4 lecciones en total.
Seguir una llamada
Una sola llamada a una herramienta puede tocar su servidor, una base de datos y una API. El Tracing une esos saltos en una sola línea temporal para que pueda ver todo el recorrido. 🧵
Trazas y spans
Una trace es la solicitud completa; un span es un paso dentro de ella. Cada span registra un nombre, un inicio y una duración, y los spans se anidan como un árbol.
El ID de traza
Cada span de una solicitud comparte un único trace ID. Ese ID compartido permite a una herramienta reconstruir exactamente qué pasos pertenecían al mismo proceso.
Spans principales y secundarios
Los spans se vinculan mediante un parent ID. La llamada a la herramienta es el padre; la consulta a la base de datos y la llamada a la API son sus hijos, formando el árbol de la línea temporal.
OpenTelemetry
El estándar para esto en Python es OpenTelemetry. Define trazas, spans y contexto para que sus datos funcionen con muchos backends, no solo con uno.
Iniciar un span
Puede envolver el trabajo en un span mediante un gestor de contexto. Todo lo que haya dentro se cronometra y se anida automáticamente bajo la traza actual.
from opentelemetry import trace
tracer = trace.get_tracer("mcp")
with tracer.start_as_current_span("search_tool"):
run_search()Añadir atributos
Decore un span con attributes: pequeños datos clave-valor, como el nombre de la herramienta o el número de resultados. Esto facilita mucho la lectura posterior de una traza.
span = trace.get_current_span()
span.set_attribute("tool.name", "search")
span.set_attribute("result.count", 3)Los spans detectan errores
Cuando falla un paso, marque su span con el error status. Así, la traza muestra exactamente qué salto interrumpió la solicitud, no solo que se interrumpió.
Propagación del contexto
Para realizar el tracing a través de una llamada de red, transfiera el contexto de la traza en los encabezados. Esta propagation mantiene el paso remoto dentro de la misma traza.
Vincular registros y trazas
Incluya también el trace ID en sus registros estructurados. Así, una línea de registro y su traza completa se apuntan mutuamente, y la depuración es mucho más rápida.
Exportar trazas
Los spans se envían a un backend mediante un exporter, a menudo a través del protocolo OTLP. Después, el backend dibuja la línea temporal que puede explorar.
Comprobación rápida
Confirmemos la estructura de la traza.
Repaso
Ahora puede seguir una llamada de principio a fin mediante spans bajo un único ID de traza, enriquecidos con atributos, estado de error y registros que enlazan directamente con ella. 🗺️
Aprende Python con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 30
- Lecciones
- 120
Preguntas frecuentes
¿La lección «Seguir una llamada a herramienta de principio a fin» es gratis?
Sí — el texto completo de «Seguir una llamada a herramienta de principio a fin» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de MCP Academy, actualiza a CoddyKit PRO. El curso de MCP Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Seguir una llamada a herramienta de principio a fin»?
Siga una solicitud por toda la pila. Practicas MCP Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar MCP Academy?
No se requiere experiencia previa. MCP Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.
¿Cuánto tiempo toma la lección «Seguir una llamada a herramienta de principio a fin»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de MCP Academy?
Sí. Cada lección de MCP Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Qué medir en un servidor
- Registros estructurados que puede buscar
- Seguir una llamada a herramienta de principio a fin
- Alertas por fallos y abuso