Crear la definición de herramienta de OpenAI
Has creado la función convert_timezone() que usa la API de OpenTimezone para convertir fechas y horas entre zonas horarias. Ahora necesitas crear una definición de herramienta en el formato de OpenAI para que el LLM entienda cómo usar esta función. La definición de la herramienta actúa como un manual para el modelo y describe el propósito de la función, sus parámetros y sus requisitos.
Este ejercicio forma parte del curso
Trabajar con la API Responses de OpenAI
Instrucciones del ejercicio
- Define una herramienta de tipo
"function"llamada"convert_timezone". - Crea las definiciones para cada uno de los tres parámetros de la función:
"date_time","from_timezone"y"to_timezone". - Asegúrate de que los tres parámetros estén marcados como obligatorios para la herramienta.
Ejercicio interactivo práctico
Prueba este ejercicio y completa el código de muestra.
tools = [
{
# Define a function tool called convert_timezone
"type": "____",
"name": "____",
"description": "Convert a datetime from one timezone to another using the OpenTimezone API.",
"parameters": {
"type": "object",
# Define the parameter names, types, and descriptions
"properties": {
"____": {
"type": "____",
"description": "The datetime string in ISO format (e.g., '2025-01-20T14:30:00')"
},
"____": {
"type": "____",
"description": "The source timezone (e.g., 'America/New_York', 'Asia/Tokyo')"
},
"____": {
"type": "____",
"description": "The target timezone (e.g., 'Europe/London', 'Australia/Sydney')"
}
},
# Ensure that all three parameters are required
"____": ["date_time", "from_timezone", "to_timezone"],
"additionalProperties": False
}
}
]