Ferramentas e chamadas de funções

Descrever o contrato de uma função

Uma ferramenta contém um nome, uma descrição clara e um esquema JSON para os parâmetros. A descrição indica quando a ferramenta deve ser escolhida, enquanto o esquema restringe os argumentos.

O modelo propõe uma chamada; por si só, não obtém acesso à sua rede, base de dados ou ficheiros.

{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "What is the weather in Tashkent?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Read current weather for a city.",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"],
        "additionalProperties": false
      }
    }
  }],
  "tool_choice": "auto"
}

Executar do seu lado

• Confirme o nome da ferramenta numa lista de permissões.
• Valide os argumentos com o esquema antes de chamar um serviço interno.
• Aplique a sua própria autorização, tempos limite e idempotência à ação da ferramenta.

Devolver o resultado

Acrescente uma mensagem tool com tool_call_id e um resultado serializado compacto; depois continue a conversa com o mesmo contexto.

Mantenha uma falha de execução da ferramenta distinta de uma falha do modelo: devolva uma razão estruturada que o modelo possa explicar ao utilizador.