Herramientas de un agente: Barcelona figura en la lista, ¿pero está disponible?
Introducción
En esta lección
- Separa la pertenencia a la lista del estado actual
- Compara las dos primeras peticiones
- Divide la petición fuera de Europa en dos condiciones
- ¿Qué cambian Auto y Required?
Separa la pertenencia a la lista del estado actual
Un modelo genera texto. Los puntos de fidelidad, el estado de un vuelo y una reserva exigen consultar datos de la aplicación. La lección menciona desde calculadoras hasta consultas al CRM. En el cuaderno una función enumera destinos y otra comprueba si un lugar concreto está disponible.
Lee lo que realmente devuelve el ejemplo
La función superior enumera cinco ciudades. La inferior acepta un destino, pero el código visible devuelve un conjunto fijo de estados. No esperes una única fila para Barcelona por ser el argumento. Localiza la fila correspondiente dentro del resultado.
Catálogo y estados de ejemplo 03:05 · Microsoft Learn
Tres pasos ante la pantalla
- Cuenta los cinco destinos: Barcelona, París, Berlín, Tokio y Nueva York.
- Anota los disponibles: París, Berlín y Nueva York.
- Añade la condición fuera de Europa. Solo Nueva York cumple las dos.
Compara las dos primeras peticiones
La primera pregunta por los destinos: get_destinations devuelve el catálogo. La segunda menciona Barcelona. get_availability recibe esa ciudad e indica que no está disponible. Un catálogo correcto no sustituye el segundo resultado. Localiza el valor devuelto antes de leer cómo lo comunica el agente.
Respuesta de disponibilidad de Barcelona tras el catálogo. 04:30 · Microsoft Learn
Divide la petición fuera de Europa en dos condiciones
El viajero busca un lugar fuera de Europa que además esté disponible. El modelo identifica Tokio y Nueva York y consulta ambas ciudades. Nueva York está disponible en el ejemplo y Tokio no. Comprueba las dos condiciones por separado: estar fuera de Europa no acredita que se pueda reservar. Los valores pertenecen al cuaderno.
Consultas de estado para dos ciudades. 05:41 · Microsoft Learn
Selección automática de funciones 03:24 · Microsoft Learn
Auto permite seleccionar una función. Exigir la llamada no añade datos ausentes ni corrige un argumento erróneo. Separa «herramienta invocada» de «estado verificado».
¿Qué cambian Auto y Required?
Auto permite decidir si se necesita una función. Required puede obligar a seleccionarla. Ninguno garantiza que la ciudad enviada sea correcta o que responda el servicio. Limita el acceso a los datos necesarios. Prevé mensajes distintos para «no se pudo consultar» y «la ciudad no está disponible».
El nombre de la función no verifica la respuesta
En 04:09 la llamada desplegada muestra primero los lugares devueltos y luego el texto del asistente. Lee la siguiente petición en el mismo orden: pregunta, función, fila y frase final. En producción también importa la vigencia. El cuaderno no consulta reservas en vivo.
Llamada desplegada para la consulta al catálogo 04:09 · Microsoft Learn
Ejemplo resuelto · Tres pausas en el vídeo
Pausa | Dónde mirar | Cómo interpretarlo |
|---|---|---|
Catálogo | get_destinations devuelve una lista. Sirve para describir la oferta, pero se necesita otra fuente para prometer disponibilidad actual. | |
Barcelona | get_availability recibe una ciudad y devuelve no disponible. Decir «no ofrecemos Barcelona» confundiría el estado con la ficha del catálogo. | |
Fuera de Europa | Tokio y Nueva York cumplen la condición geográfica y se comprueban ambas. Nueva York está disponible. Aunque solo se muestre una ciudad, debería poder explicarse el descarte. |
Pruébalo · Construye un registro de tres consultas
En la primera fila pon la pregunta por el catálogo y marca que devuelve una lista. En la segunda anota Barcelona y su estado. Divide la última entre Tokio y Nueva York. Busca un estado para cada candidato. Resumirlos en una frase no convierte dos comprobaciones en una.
Comprueba tu razonamiento
Enseña la tabla a alguien que no conozca el código. Si distingue aparecer en el catálogo, estar disponible y tener una reserva confirmada, la tabla cumple su cometido.
Diagnóstico
Observación | Comprobación | Resultado esperado |
|---|---|---|
Barcelona aparece pero no admite reserva | Separa pertenencia al catálogo y estado. | Se ofrece, pero está indisponible en el ejemplo. |
Se recomienda Tokio | Compara su fila con Nueva York. | La condición geográfica no basta. |
Dos preguntas
- ¿Qué prueba hay de una reserva en Nueva York?
- ¿Qué estado corresponde a un tiempo de espera agotado?
Comprueba tu razonamiento
- Solo hay una consulta de disponibilidad. No se muestra ninguna reserva confirmada.
- Desconocido o sin verificar. No es un resultado negativo de disponibilidad.
Glosario breve
Argumento: entrada de la función. Valor devuelto: resultado. Disponibilidad: estado en los datos de ejemplo.
Fuentes y versión
Microsoft distingue la selección de las funciones ofrecidas. Exigir una llamada no incorpora una fuente de datos ausente. Microsoft