Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Palvelin- ja asiakastyökalujen yhdistäminen

Oppitunti 12 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Hybridityönkulut
  2. Palvelintyökalujen ja funktioiden yhdistäminen
  3. Hybridi-suoritusvirta
  4. Yleiset yhdistelmämallit
  5. max_turns ja hybridityökalut
  6. Monivaiheinen kontekti tallennuksen avulla
  7. Keskeiset asiat

Hybridityönkulut

Responses API:n todellinen voima paljastuu, kun yhdistät palvelintyökalut (joita xAI suorittaa automaattisesti) ja asiakastyökalut (omat funktiosi) samaan pyyntöön. Malli orkestroi nämä työkalut itsenäisesti ja luo monimutkaisia työnkulkuja vain muutamalla koodirivillä.

Palvelintyökalujen ja funktioiden yhdistäminen

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

Tässä skenaariossa malli:

  1. Käynnistää web_search-työkalun automaattisesti (palvelinpuolella) löytääkseen tulokset
  2. Sisällyttää tiedot yhteenvetoon
  3. Kutsuu funktiota send_team_message (asiakaspuolella), jotta koodisi lähettää Slack-viestin

Hybridi-suoritusvirta

Virta vaihtelee työkalutyypin mukaan:

Vain palvelintyökalut

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

Kaikki tapahtuu xAI:n puolella. Saat lopullisen vastauksen suoraan integroitujen tulosten kera.

Vain asiakastyökalut

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

Malli keskeyttää toimintansa, koodisi suorittaa funktion, ja lähetät tuloksen takaisin.

Hybridi-virta

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

Malli käyttää ensin palvelintyökaluja (automaattisesti) ja kutsuu funktiotasi vasta, kun se tarvitsee infrastruktuuriasi.

Yleiset yhdistelmämallit

Haku + toiminto

Yhdistä web_search tai x_search toimintofunktioon:

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

Laskenta + ilmoitus

Yhdistä code_interpreter ilmoitusfunktioon:

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 ja hybridityökalut

max_turns-parametrin käyttäytyminen on tärkeää hybridikontekstissa:

  • max_turns rajoittaa palvelinpuoleisia kierroksia yhden pyynnön sisällä
  • Kun malli kutsuu asiakasfunktiota ja koodisi palauttaa tuloksen, max_turns-kiintiö allokoidaan uudelleen

Käytännössä tämä tarkoittaa, että asiakaskutsut eivät kuluta palvelinkierrosten budjettiasi. Malli voi tehdä kolme verkkohakua, kutsua funktiotasi ja tehdä sen jälkeen tuloksen vastaanotettuaan vielä kolme lisähakua.

Monivaiheinen kontekti tallennuksen avulla

Monia vuorovaikutuksia kattavia monimutkaisia työnkulkuja varten yhdistä tallennus ja ketjutus:

# Kierros 1: alkuperäinen haku
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
)

# Kierros 2: syvennä omilla sisäisillä tiedoillasi
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
)

Keskeiset asiat

  • Yhdistä palvelintyökalut ja asiakasfunktiot samaan pyyntöön luodaksesi hybridityönkulkuja
  • Palvelintyökalut suoritetaan automaattisesti; asiakasfunktiot keskeyttävät generoinnin
  • max_turns nollautuu jokaisen asiakaspuolisen edestakaisen viestin jälkeen
  • Yleiset mallit: haku + toiminto, laskenta + ilmoitus, usean lähteen aggregointi
  • Käytä arvoa store: true ja parametria previous_response_id monivaiheisiin työnkulkuihin