Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Server- en clienttools combineren

Les 12 van 16 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Hybride workflows
  2. Servertools en functies combineren
  3. De hybride uitvoeringsstroom
  4. Veelvoorkomende combinatiepatronen
  5. max_turns en hybride tools
  6. Context met meerdere beurten en opslag
  7. Belangrijkste punten

Hybride workflows

De ware kracht van de Responses API komt naar voren wanneer u servertools (automatisch uitgevoerd door xAI) en clienttools (uw eigen functies) combineert in één verzoek. Het model orkestreert deze tools autonoom, waardoor complexe workflows met slechts een paar regels code mogelijk zijn.

Servertools en functies combineren

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Search for the latest Ligue 1 soccer results and send a summary to my team.",
    tools=[
        {"type": "web_search"},
        {
            "type": "function",
            "name": "send_team_message",
            "description": "Sends a message to the team via Slack",
            "parameters": {
                "type": "object",
                "properties": {
                    "channel": {"type": "string"},
                    "message": {"type": "string"}
                },
                "required": ["channel", "message"]
            }
        }
    ]
)

In dit scenario:

  1. Activeert het model automatisch web_search (serverzijde) om de resultaten te vinden.
  2. Verwerkt het de gegevens in een samenvatting.
  3. Roept het send_team_message aan (clientzijde), zodat uw code het Slack-bericht verzendt.

De hybride uitvoeringsstroom

De stroom verschilt afhankelijk van het type tool:

Alleen servertools

Request → [model → web_search → result → model] → Final response

Alles gebeurt aan de kant van xAI. U ontvangt direct het eindantwoord met de geïntegreerde resultaten.

Alleen clienttools

Request → [model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response

Het model pauzeert, uw code wordt uitgevoerd en vervolgens stuurt u het resultaat terug.

Hybride stroom

Request → [model → web_search → result → model → function_call] → PAUSE
Your code executes the function
Result → [model] → Final response

Het model gebruikt eerst servertools (automatisch) en roept vervolgens uw functie aan wanneer het uw infrastructuur nodig heeft.

Veelvoorkomende combinatiepatronen

Zoeken + Actie

Combineer web_search of x_search met een actiefunctie:

tools = [
    {"type": "web_search"},
    {"type": "x_search"},
    {
        "type": "function",
        "name": "create_report",
        "description": "Creates a report in the CRM",
        "parameters": {
            "type": "object",
            "properties": {
                "title": {"type": "string"},
                "content": {"type": "string"},
                "tags": {"type": "array", "items": {"type": "string"}}
            },
            "required": ["title", "content"]
        }
    }
]

Berekening + Melding

Combineer code_interpreter met een meldingsfunctie:

tools = [
    {"type": "code_interpreter"},
    {
        "type": "function",
        "name": "send_alert",
        "description": "Sends an alert if a threshold is exceeded",
        "parameters": {
            "type": "object",
            "properties": {
                "metric": {"type": "string"},
                "value": {"type": "number"},
                "threshold": {"type": "number"}
            },
            "required": ["metric", "value"]
        }
    }
]

max_turns en hybride tools

Het gedrag van max_turns is belangrijk in een hybride context:

  • max_turns beperkt het aantal serverzijde-beurten binnen één verzoek.
  • Wanneer het model een clientfunctie aanroept en uw code het resultaat retourneert, start een nieuwe toewijzing van max_turns.

In de praktijk betekent dit dat clientaanroepen uw budget voor serverbeurten niet uitputten. Het model kan 3 webzoekopdrachten uitvoeren, uw functie aanroepen en na ontvangst van het resultaat nog eens 3 zoekopdrachten uitvoeren.

Context met meerdere beurten en opslag

Voor complexe workflows die zich over meerdere interacties uitstrekken, combineert u opslag en ketening:

# Turn 1: initial search
r1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Analyze AI market trends.",
    tools=[{"type": "web_search"}, {"type": "code_interpreter"}],
    store=True,
    max_turns=5
)

# Turn 2: deepen with your internal data
r2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Compare with our internal data.",
    tools=[{
        "type": "function",
        "name": "query_internal_db",
        "description": "Queries the internal database",
        "parameters": {"type": "object", "properties": {"query": {"type": "string"}}}
    }],
    previous_response_id=r1.id,
    store=True
)

Belangrijkste punten

  • Combineer servertools en clientfuncties in één verzoek voor hybride workflows.
  • Servertools worden automatisch uitgevoerd; clientfuncties pauzeren de generatie.
  • max_turns wordt gereset na elke client round-trip.
  • Veelvoorkomende patronen: zoeken + actie, berekening + melding, aggregatie van meerdere bronnen.
  • Gebruik store: true en previous_response_id voor workflows met meerdere beurten.