Contratos de herramientas

Qué aprenderás

• Una herramienta debe tener nombre, propósito, entradas válidas y una salida definida
• Construir y comprobar una solución usando datos ficticios.
• Resolver y aprobar la hoja de ejercicios antes de continuar.

Conceptos del tema

Una herramienta debe tener nombre, propósito, entradas válidas y una salida definida.

El modelo propone una llamada; la aplicación valida sus argumentos y ejecuta solo las operaciones autorizadas.

No conviertas una cadena recibida en código mediante eval.

Para buscar un registro, usa un identificador bien formado y devuelve un resultado explícito si no existe.

Este ejemplo usa datos locales ficticios.

Cómo interpretar este tema

Separa el objetivo de los datos de entrada y del criterio de éxito. Trabaja primero con ejemplos ficticios que puedas comprobar. En código, identifica entradas, operaciones y salidas; en un encargo a una IA, distingue el contenido generado de las acciones realmente ejecutadas.

Construye una solución pequeña y revisable. Comprueba casos normales, fronteras y errores; conserva las fuentes de las afirmaciones y los permisos de cada herramienta. Los ejemplos de Python de este curso se copian a tu propio entorno: la página no ejecuta código ni realiza llamadas a servicios de IA.

Detalles para comprender la regla

El formato no sustituye las comprobaciones de argumentos, permisos y efectos de la aplicación.

Un contrato acotado permite validar la entrada y limitar la operación a la consulta prevista.

La ausencia de datos debe conservarse para evitar tratar una suposición como una consulta real.

Ejemplo resuelto

Crear una consulta de pedidos que solo permite lectura.

1. Acepta un identificador, sin comandos libres.
2. Devuelve el estado del registro o un mensaje de no encontrado.
3. Prueba un identificador conocido y otro inexistente.

Cómo practicar

1. Define el resultado y los datos que necesita.
2. Revisa el ejemplo y anticipa su salida antes de probarlo.
3. Comprueba un caso normal, una frontera y un error.
4. Explica la solución y verifica los datos o fuentes que utiliza.

Tu cuenta gratuita guarda respuestas, notas y progreso en las dos plataformas.

Recursos para profundizar

• Agentes · OpenAI Docs ↗

  Documentación de referencia del tema. Puede estar en inglés.

• Herramientas y agentes · Claude ↗

  Documentación de referencia del tema. Puede estar en inglés.

• Tutorial oficial de Python ↗

  Documentación de referencia del tema. Puede estar en inglés.