Criando a definição de ferramenta da OpenAI
Você criou a função convert_timezone() que usa a OpenTimezone API para converter datas e horas entre fusos horários. Agora você precisa criar uma definição de ferramenta no formato da OpenAI para que o LLM entenda como usar essa função. A definição da ferramenta funciona como um manual para o modelo, descrevendo o propósito da função, seus parâmetros e requisitos.
Este exercício faz parte do curso
Trabalhando com a OpenAI Responses API
Instruções do exercício
- Defina uma ferramenta do tipo
"function"chamada"convert_timezone". - Crie definições para cada um dos três parâmetros da função:
"date_time","from_timezone"e"to_timezone". - Garanta que todos os três parâmetros estejam marcados como obrigatórios pela ferramenta.
Exercício interativo prático
Experimente este exercício completando este código de exemplo.
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
}
}
]