Llama a herramientas
Describe tus funciones, ejecuta las llamadas que pide el modelo y devuélvele los resultados hasta que responda.
Describe tus funciones en tools y el modelo responderá con una llamada a una de ellas, como una consulta a la base de datos, en lugar de adivinar. El modelo nunca ejecuta nada por sí mismo: tu aplicación ejecuta la función y devuelve el resultado, y después el modelo escribe la respuesta final.
curl https://api.phaseo.app/v1/chat/completions \
-H "Authorization: Bearer $PHASEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-6-astra",
"messages": [
{ "role": "user", "content": "What is the weather in London?" }
],
"tools": [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather by city",
"parameters": {
"type": "object",
"properties": {
"city": { "type": "string" }
},
"required": ["city"]
}
}
}
]
}'
En Chat Completions, la respuesta tiene finish_reason: "tool_calls" y una lista tool_calls en el mensaje del asistente, cada una con un id, un name de función y arguments como cadena JSON. Ejecuta cada llamada y después envía una solicitud de seguimiento que repita la conversación, el mensaje del asistente sin cambios y un mensaje role: "tool" por llamada, asociado mediante tool_call_id. Vuelve a enviar tools. El modelo responde o llama a otra herramienta, y repites el proceso. En /v1/responses, la llamada es un elemento function_call y tu resultado un elemento function_call_output con el mismo call_id; en /v1/messages son bloques tool_use y tool_result.
tool_choice controla si el modelo puede llamar a herramientas: none para solo texto, auto (o no incluirlo) para que decida el modelo, required para obligarle a llamar a una, o un objeto que nombre una herramienta concreta. Pon parallel_tool_calls en false cuando tus herramientas deban ejecutarse de una en una.
Trata cada llamada como una entrada no fiable. Comprueba el nombre de la herramienta con una lista de permitidas, rechaza los nombres desconocidos y valida los argumentos analizados antes de ejecutar nada. Si la validación falla, no ejecutes la herramienta: envía un error breve como resultado de la herramienta y deja que el modelo lo intente de nuevo. Con stream: true, reúne todos los fragmentos de los argumentos antes de analizarlos. Las herramientas cuyo tipo empieza por phaseo:, como phaseo:web_search o phaseo:datetime, se ejecutan en Phaseo, así que obtienes la respuesta final sin escribir un ejecutor. Estas herramientas de servidor están en Beta.
Comprueba lo que has aprendido
El modelo devuelve una llamada a delete_user con {"id": "42"}. Tu aplicación solo define get_weather. ¿Qué debe hacer tu código?
Ponlo en práctica
Tu bot de soporte llama a get_order y después responde. El bucle de un compañero envía solo el mensaje role: "tool" en la solicitud de seguimiento, y el proveedor lo rechaza. ¿Qué falta?
Mostrar la respuestaOcultar la respuesta
La solicitud de seguimiento debe repetir la conversación, después el mensaje del asistente con sus tool_calls sin cambios y después un mensaje role: "tool" por llamada con el tool_call_id correspondiente. Vuelve a enviar también tools. Un resultado de herramienta sin una llamada previa no tiene nada con qué asociarse.
Idea clave
Enlaces relacionados
Revisado por última vez el 17 de noviembre de 2026