Guías

Llamadas a herramientas

Ambos modelos llaman herramientas en formato OpenAI: describes funciones, el modelo pide una, tú la ejecutas y devuelves el resultado.

Revisado el 26 de octubre de 2026

El bucle

Envía tools: cada una es una función con nombre, descripción y parámetros en JSON Schema.
Cuando el modelo quiere una, el finish_reason de la respuesta es tool_calls y message.tool_calls las lista, con los argumentos como cadena JSON.
Ejecuta cada una y añade un mensaje tool con su tool_call_id y el resultado.
Envía la conversación de nuevo. Repite hasta que finish_reason sea stop.

Python

import json
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://nokeep.ai/v1",
    api_key=os.environ["NOKEEP_API_KEY"],
)

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Today's weather in a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

def get_weather(city):
    return {"city": city, "high_c": 21, "sky": "clear"}

messages = [{"role": "user", "content": "Should I bring a jacket in Lisbon today?"}]
while True:
    reply = client.chat.completions.create(model="deepseek-v4.1-flash-uncensored", messages=messages, tools=tools)
    message = reply.choices[0].message
    messages.append(message)
    if not message.tool_calls:
        print(message.content)
        break
    for call in message.tool_calls:
        result = get_weather(**json.loads(call.function.arguments))
        messages.append({"role": "tool", "tool_call_id": call.id, "content": json.dumps(result)})

tool_choice

Modelo	Acepta
`deepseek-v4.1-flash-uncensored`	`auto`, `none`, `required` o una función por nombre. También `parallel_tool_calls`.
`glm-5.3-flash-uncensored`	`auto` o `none`. Elige sus propias herramientas; cualquier otro valor da `400 unsupported_tool_choice`.

Conviene saber

Cada mensaje tool necesita el tool_call_id al que responde, o la llamada se rechaza con 400 invalid_messages.
Los esquemas de herramientas viajan con cada petición y cuentan como tokens de entrada.
Los modelos no ejecutan nada por sí mismos. Tu código ejecuta las herramientas, así que decide a qué pueden acceder.

Obtén una clave de API Prueba gratis la clave de prueba: sk-nokeep-test

El bucle

tool_choice

Conviene saber

¿Qué tienes en mente?