Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Kombinera server- och klientverktyg

Lektion 12 av 16 Uppdaterad 30 juli 2026 Utvecklare
På denna sida
  1. Hybrida arbetsflöden
  2. Kombinera serververktyg och funktioner
  3. Det hybrida exekveringsflödet
  4. Vanliga kombinationsmönster
  5. max_turns och hybrida verktyg
  6. Flerstegskontext med lagring
  7. Viktiga punkter

Hybrida arbetsflöden

Den verkliga styrkan med Responses API kommer fram när du kombinerar serververktyg (som körs automatiskt av xAI) och klientverktyg (dina egna funktioner) i en enda begäran. Modellen orkestrerar dessa verktyg autonomt och skapar komplexa arbetsflöden på bara några rader kod.

Kombinera serververktyg och funktioner

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"]
            }
        }
    ]
)

I detta scenario gör modellen följande:

  1. Utlöser web_search automatiskt (serversida) för att hitta resultaten
  2. Integrerar datan i en sammanfattning
  3. Anropar send_team_message (klientsida) så att din kod skickar Slack-meddelandet

Det hybrida exekveringsflödet

Flödet skiljer sig beroende på vilken typ av verktyg som används:

Endast serververktyg

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

Allt sker på xAI:s sida. Du får det slutgiltiga svaret direkt med resultaten integrerade.

Endast klientverktyg

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

Modellen pausar, din kod exekveras och sedan skickar du tillbaka resultatet.

Hybrida flödet

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

Modellen använder först serververktyg (automatiskt) och anropar sedan din funktion när den behöver din infrastruktur.

Vanliga kombinationsmönster

Sökning + åtgärd

Kombinera web_search eller x_search med en åtgärdsfunktion:

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"]
        }
    }
]

Beräkning + avisering

Kombinera code_interpreter med en aviseringsfunktion:

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 och hybrida verktyg

Beteendet hos max_turns är viktigt i en hybridkontext:

  • max_turns begränsar antalet serversida-varv inom en enda begäran
  • När modellen anropar en klientfunktion och din kod returnerar resultatet, börjar en ny tilldelning av max_turns

I praktiken innebär detta att klientanrop inte förbrukar din budget för servervarv. Modellen kan utföra tre webbsökningar, anropa din funktion och sedan utföra tre ytterligare sökningar efter att ha fått resultatet.

Flerstegskontext med lagring

För komplexa arbetsflöden som sträcker sig över flera interaktioner kombinerar du lagring och kedjebildning:

# 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
)

Viktiga punkter

  • Kombinera serververktyg och klientfunktioner i en enda begäran för hybrida arbetsflöden
  • Serververktyg exekveras automatiskt; klientfunktioner pausar genereringen
  • max_turns återställs efter varje klienttur-och-retur
  • Vanliga mönster: sökning + åtgärd, beräkning + avisering, aggregering från flera källor
  • Använd store: true och previous_response_id för arbetsflöden över flera steg