Créer la définition d’outil OpenAI
Vous avez créé la fonction convert_timezone() qui utilise l’API OpenTimezone pour convertir des dates/heures entre des fuseaux horaires. Vous devez maintenant créer une définition d’outil au format OpenAI afin que le LLM comprenne comment utiliser cette fonction. La définition d’outil sert de guide pour le modèle : elle décrit l’objectif de la fonction, ses paramètres et ses exigences.
Cet exercice fait partie du cours
Travailler avec l’API OpenAI Responses
Instructions
- Définissez un outil de type
"function"appelé"convert_timezone". - Créez les définitions pour chacun des trois paramètres de la fonction :
"date_time","from_timezone"et"to_timezone". - Assurez-vous que les trois paramètres sont marqués comme requis par l’outil.
Exercice interactif pratique
Essayez cet exercice en complétant cet exemple de code.
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
}
}
]