Curso Aula

Del viaje familiar a Melbourne a un plan que otro agente pueda ejecutar

Resumen de la lección

Una familia con dos hijos quiere viajar de Singapur a Melbourne. Un buen itinerario ayuda al lector, pero un servicio de reservas necesita una tarea que reconozca, un destino identificable y permiso para actuar. Sigue la solicitud desde el texto libre hasta el plan y descubre qué queda por comprobar.

Lección 7 / 7 · 4 min · Inicial · EspañolIdioma del vídeo · English

Introducción

Recorrido

  1. Divide la solicitud en entregas concretas
  2. Define cómo se entrega una tarea
  3. Lee el modelo que las agrupa
  4. Asigna cada encargo a un especialista disponible
  5. Inspecciona el plan devuelto

Los diagramas reconstruyen las ideas del curso. Los enlaces con tiempo abren la grabación.

Divide la solicitud en entregas concretas

El instructor descompone primero unas vacaciones de tres días en un lugar cálido en vuelos, alojamiento, transporte y actividades. Es el ejemplo introductorio. La familia aparece en otra solicitud; atribuirle esos tres días introduciría una condición inventada.

Divide la solicitud en entregas concretas · trip → tasks → agents

Diagrama original de GuideWit 1 · Divide la solicitud en entregas concretas. 00:58 · Vídeo de Microsoft

Define cómo se entrega una tarea

La demostración introduce Pydantic para validar la estructura de la respuesta. Cada subtarea tiene un agente responsable y una descripción. Lee esta última como una orden de trabajo. ¿Podría el destinatario dar el siguiente paso con esa información?

Define cómo se entrega una tarea · input → Pydantic → TravelPlan

Diagrama original de GuideWit 2 · Define cómo se entrega una tarea. 02:25 · Vídeo de Microsoft

Lee el modelo que las agrupa

El plan contiene una tarea principal y una lista de subtareas. Así se conserva el objetivo mientras cada agente recibe su encargo. Compara una tarea sin responsable con otra cuyo responsable es desconocido. Un campo que solo exige texto puede aceptar el segundo caso.

Lee el modelo que las agrupa · main_task → sub_tasks → assigned_agent

Diagrama original de GuideWit 3 · Lee el modelo que las agrupa. 03:03 · Vídeo de Microsoft

Asigna cada encargo a un especialista disponible

Las instrucciones enumeran especialistas en vuelos, hoteles, alquiler de coches y actividades. Sigue el trayecto Singapur–Melbourne. Aunque dos agentes elijan el hotel y las actividades, ambos necesitan saber que viajan dos niños.

Asigna cada encargo a un especialista disponible · Singapore → 2 children → Melbourne

Diagrama original de GuideWit 4 · Asigna cada encargo a un especialista disponible. 03:58 · Vídeo de Microsoft

Inspecciona el plan devuelto

El resultado asigna los vuelos de ida y vuelta y un alojamiento adecuado para la familia. El requisito se puede transferir a la descripción. Para demostrar que existe una habitación disponible hace falta una consulta independiente al inventario.

Inspecciona el plan devuelto · FlightBooking → HotelBooking → Activities

Diagrama original de GuideWit 5 · Inspecciona el plan devuelto. 04:20 · Vídeo de Microsoft

Ejemplo resuelto · Ejercicio editorial

Entrada

Acción

Evidencia esperada

La familia pide un viaje

Crear la tarea principal

Conservar ambas ciudades y el grupo.

El especialista recibe el encargo del hotel

Extraer la condición familiar

Consultar habitaciones adecuadas.

Llega un nombre de agente desconocido

Comprobar el registro de funciones

Detener el envío para corregirlo.

Diagnóstico

Observación

Qué comprobar

El plan es válido pero falla la búsqueda

Comprobar ocupación, fechas e inventario por separado.

Se pierde una necesidad de los hijos

Comparar cada encargo con la petición inicial.

Práctica

  1. Dibuja dos tareas para la familia.
  2. Cambia el responsable del hotel por uno inexistente.
  3. Prueba por separado la estructura y el enrutamiento.

Resultado esperado. Se detecta el destino desconocido antes del envío y sigue siendo posible identificar la tarea de vuelos válida.

Comprueba lo aprendido

  1. ¿Un JSON válido demuestra que hay una reserva?
  2. ¿Dónde debe aparecer la condición familiar?

Respuestas

  1. No. Hace falta una respuesta satisfactoria del servicio y un localizador.
  2. En cada tarea cuyo resultado dependa de ella, sobre todo habitaciones y actividades.

Glosario

  • Esquema. Campos y tipos requeridos en una salida.
  • Envío. Entrega de una tarea aceptada a un destinatario reconocido.

Fuentes

El cuaderno enlazado es la versión del repositorio y puede utilizar otra implementación.

Microsoft Learn · Vídeo de Microsoft · Microsoft · Lección · Microsoft · Cuaderno