Creare la definizione dello strumento OpenAI
Hai creato la funzione convert_timezone() che usa l'API OpenTimezone per convertire date e orari tra fusi orari. Ora devi creare una definizione dello strumento nel formato di OpenAI, così l'LLM può capire come usare questa funzione. La definizione dello strumento funge da manuale per il modello e descrive lo scopo della funzione, i parametri e i requisiti.
Questo esercizio fa parte del corso
Lavorare con la Responses API di OpenAI
Istruzioni dell'esercizio
- Definisci uno strumento di tipo
"function"chiamato"convert_timezone". - Crea le definizioni per ciascuno dei tre parametri della funzione:
"date_time","from_timezone"e"to_timezone". - Assicurati che tutti e tre i parametri siano contrassegnati come obbligatori dallo strumento.
Esercizio pratico interattivo
Prova a risolvere questo esercizio completando il codice di esempio.
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
}
}
]