A chamada de funções permite que você descreva ao assistente quaisquer funções personalizadas ou APIs externas, o que possibilita que o assistente chame essas funções de forma inteligente ao gerar um objeto JSON com os argumentos relevantes.
Como usar a chamada de funções no Chat Playground
Para adicionar uma nova função, clique em "+Tools > Functions" no painel de configuração à esquerda da tela para a Responses API ou, simplesmente, em "+Function" para a Chat Completions API.
Em seguida, insira o schema JSON com os parâmetros da função. Você pode usar a funcionalidade Beta "Generate" para descrever, em texto simples, o que você gostaria que a função fizesse e receber uma sugestão de schema JSON.
Agora você verá a função listada no lado esquerdo da tela em “Tools”.
Para testar a função no playground, digite uma mensagem que faria o modelo chamar a função.
Por exemplo, para a função get_weather, digite: "qual é o clima em Berkeley?"
Quando a função for chamada, insira a saída da sua função, por exemplo "{temp: 80}", e pressione “Run”. O Assistente então usará a saída da função que você forneceu para elaborar a resposta.
Isso oferece suporte a chamada de funções em paralelo?
Sim, a chamada de funções em paralelo é suportada no Chat Playground.
A chamada de funções em paralelo é a capacidade do modelo de realizar várias chamadas de função em conjunto, permitindo que os efeitos e resultados dessas chamadas sejam resolvidos em paralelo. Isso é especialmente útil quando as funções demoram muito e reduz as idas e vindas com a API.
Ative Structured Outputs definindo strict: "true" no schema
Quando o Structured Outputs está ativado, os argumentos gerados pelo modelo para chamadas de função têm garantia de corresponder ao JSON Schema que você fornecer.
Se você não estiver usando Structured Outputs, a estrutura dos argumentos não tem garantia de estar correta; por isso, recomendamos usar uma biblioteca de validação como o Pydantic para primeiro verificar os argumentos antes de utilizá-los.
Saiba mais sobre chamadas de funções com structured outputs.
Como forçar a escolha de função no Playground
Clique no ícone de "Settings" ao lado do nome do modelo
Clique em Tool Choice
Altere de "Auto" para "Required" ou para a função desejada (criada anteriormente).
