Chamadas de ferramentas
Envie definições de funções apenas a um modelo cujos metadados do catálogo incluam explicitamente suporte a ferramentas.
Definir uma ferramenta
Solicitação de chat
{
"model": "YOUR_APPROVED_MODEL_ID",
"messages": [
{
"role": "user",
"content": "What is the weather in Paris?"
}
],
"max_tokens": 256,
"tools": [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Look up weather for a city",
"parameters": {
"type": "object",
"properties": {
"city": {
"type": "string"
}
},
"required": [
"city"
]
}
}
}
],
"tool_choice": "auto"
} Executar o ciclo de ferramentas
- Leia os tool_calls do assistente na resposta.
- Valide a função e os argumentos solicitados na sua própria aplicação.
- Obtenha a autorização necessária para a ação e depois execute a ferramenta.
- Envie o resultado da ferramenta de volta com o tool_call_id correspondente.
O gateway retransmite definições e resultados de ferramentas. Ele não executa ferramentas. Trate a saída do modelo e os argumentos das ferramentas como entradas não confiáveis.
Erros de capacidades
Um modelo sem suporte verificado a ferramentas retorna um erro unsupported_capability quando são fornecidas ferramentas ou mensagens de ferramentas. Consulte o catálogo antes de ativar o modo de ferramentas de um cliente.