Salida estructurada y llamada de herramientas
Los datos estructurados ayudan al software a leer una respuesta, pero tanto la estructura como el significado requieren validación.
lo que aprenderás
- Explique: el modelo propone, la herramienta ejecuta
- Aplique la idea en un ejemplo: salida estructurada y llamada de herramientas
- Reconocer las limitaciones y verificar el resultado del ejercicio.
Los datos estructurados ayudan al software a leer una respuesta, pero tanto la estructura como el significado requieren validación.
Puedes seguir este curso sin cuenta ni programación. Los ejemplos utilizan datos sintéticos y es necesario comprobar los resultados de la IA.
Cómo funciona, paso a paso
El modelo propone, la herramienta ejecuta
La llamada a herramientas produce una solicitud de llamada con un nombre y argumentos. La aplicación valida el esquema, permisos y límites antes de la ejecución. El resultado vuelve al contexto para el siguiente paso. Por ejemplo, get_product_stock toma un SKU y devuelve una cantidad; su descripción debe explicar que no reserva productos. Distinga resultados vacíos, errores de validación, accesos faltantes y tiempos de espera. Un JSON válido no prueba que los argumentos sean correctos ni que la acción esté autorizada. Para efectos externos, considere también la ejecución duplicada.
Una instrucción es un contrato.
Un buen mensaje especifica la tarea, los datos disponibles, el formato de salida y los criterios de éxito. Separe el rol de los datos e incluya un ejemplo para casos ambiguos. "Sea preciso" es más débil que "indique sólo la fecha límite en la póliza proporcionada; si falta, solicite una aclaración". Pocos intentos significa unos pocos ejemplos resueltos, no una lista interminable. El contenido del documento sigue siendo datos incluso cuando contiene comandos. Los delimitadores ayudan, pero el software debe imponer permisos y validación en lugar de depender del aviso.
Comprobar el acceso antes de su uso.
Los servidores y la capa de datos deben hacer cumplir los permisos. No permita que el modelo decida si un usuario puede ver un documento. Filtre las fuentes antes de que entren en contexto, no después de generar la respuesta. Utilice credenciales de acceso mínimo, manténgalas alejadas de mensajes, capturas de pantalla y códigos del navegador, y rote las claves expuestas. Una lista de dominios permitidos de widget no reemplaza la autenticación API. La autenticación le identifica; La autorización determina las operaciones y los datos que puede utilizar. Pruebe también el acceso denegado.
El esquema explicativo
Siga las flechas sólidas para el flujo principal. Las flechas azules discontinuas proporcionan datos o contexto; Las flechas discontinuas de color rosa muestran comentarios o resultados devueltos. Colores y formas distinguen modelos, tiendas, decisiones y resultados. En pantallas pequeñas, desplázate horizontalmente para seguir todo el esquema.
Un ejemplo completo
Un clasificador devuelve categoría y needs_review. JSON con categoría="refund_now" es sintácticamente válido pero viola las categorías permitidas y no autoriza un reembolso.
{"category":"returns","needs_review":false}
Pruébalo tú mismo
- Defina un esquema y pruebe una categoría desconocida y un campo faltante.
- Registre la entrada, la fuente y el resultado esperado antes de ejecutar el experimento. Utilice únicamente los datos ficticios del ejemplo.
- Siga las etapas del diagrama. En cada paso registre qué información se recibe y se produce; No confunda el resultado intermedio con el resultado final.
- Repita después de eliminar la información necesaria o hacer que la entrada sea ambigua. Compruebe si el sistema aclara, detiene o inventa una respuesta.
- Comparar con la solución explicada. Conserve la configuración, fecha, resultado y una explicación de las diferencias. Cambie una cosa y vuelva a probar.
Una solución explicada
El validador sólo acepta entregas, devoluciones o producto y un booleano; las acciones permanecen separadas. Un ejercicio exitoso le permite mostrar la conexión entre los aportes, las etapas y el resultado. Cuando falta información, una respuesta cautelosa es más útil que detalles inventados. Compare más que estilo: compruebe también las condiciones, las fuentes y las operaciones.
Cuándo resulta útil y cuáles son sus límites
JSON sintácticamente correcto no es semánticamente correcto. Elija este enfoque cuando mejore una necesidad medida. Mantenga una línea de base simple y compare los resultados utilizando insumos idénticos. Un ejemplo exitoso no establece confiabilidad en todas las situaciones.
Comprueba lo que has aprendido
¿Quién ejecuta una llamada propuesta por el modelo?
La aplicación o servicio de alojamiento después de la validación. El modelo no obtiene automáticamente acceso ilimitado.
¿Puede un aviso reemplazar el control de acceso?
No. Una instrucción no es un límite de autorización.
¿Qué resultado debería producir este ejercicio?
El validador sólo acepta entregas, devoluciones o producto y un booleano; las acciones permanecen separadas.
Términos que conviene recordar
- Llamada de herramientas: una solicitud estructurada para utilizar una capacidad externa.
- pocos tiros: Ejemplos resueltos proporcionados en contexto.
- Autorizar / Autorización: Comprobar el derecho de acceso a una operación o recurso.
Fuentes y su próximo paso
Para preparar: P04: Cómo elegir un modelo de IA adecuado