Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Tagħqid ta' Għodod tas-Server u tal-Klijent

Lezzjoni 12 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Flussi ta’ Ħidma Ibridi
  2. Tagħqid ta’ Għodod tas-Server u Funzjonijiet
  3. Il-Fluss ta’ Eżekuzzjoni Ibridu
  4. Mudelli Komuni ta’ Tagħqid
  5. max_turns u Għodod Ibridi
  6. Kuntest Multi-dawra bil-Ħażna
  7. Punti Ewlenin

Flussi ta’ Ħidma Ibridi

Il-qawwa vera tal-API tar-Risponsi (Responses API) toħroġ meta tgħaqqad għodod tas-server (eżegwiti awtomatikament minn xAI) u għodod tal-klijent (il-funzjonijiet personalizzati tiegħek) f’talba waħda. Il-mudell jikkoordina dawn l-għodod b’mod awtonomu, u joħloq flussi ta’ ħidma kumplessi f’ftit linji ta’ kodiċi biss.

Tagħqid ta’ Għodod tas-Server u Funzjonijiet

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

F’dan ix-xenarju, il-mudell:

  1. Jattiva web_search awtomatikament (naħa tas-server) biex isib ir-riżultati
  2. Jinkorpora d-dejta f’sommarju
  3. Isejjaħ send_team_message (naħa tal-klijent) biex il-kodiċi tiegħek jibgħat il-messaġġ fuq Slack

Il-Fluss ta’ Eżekuzzjoni Ibridu

Il-fluss ivarja skont it-tip ta’ għodda:

Għodod tas-Server Biss

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

Kollox iseħħ fuq in-naħa ta’ xAI. Int tirċievi r-rispons finali direttament bir-riżultati integrati.

Għodod tal-Klijent Biss

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

Il-mudell jieqaf, il-kodiċi tiegħek jeseġwixxi, imbagħad tibgħat ir-riżultat lura.

Fluss Ibridu

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

Il-mudell juża l-għodod tas-server l-ewwel (awtomatikament), imbagħad isejjaħ il-funzjoni tiegħek meta jkollu bżonn l-infrastruttura tiegħek.

Mudelli Komuni ta’ Tagħqid

Tiftix + Azzjoni

Għaqqad web_search jew x_search ma’ funzjoni ta’ azzjoni:

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

Kalkolu + Notifika

Għaqqad code_interpreter ma’ funzjoni ta’ notifika:

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 u Għodod Ibridi

L-imġiba ta’ max_turns hija importanti f’kuntest ibridu:

  • max_turns tillimita d-dawriet fuq in-naħa tas-server fi ħdan talba waħda
  • Meta l-mudell isejjaħ funzjoni tal-klijent u l-kodiċi tiegħek jirritorna r-riżultat, tibda allokazzjoni ġdida ta’ max_turns

Fil-prattika, dan ifisser li s-sejħiet tal-klijent ma jeżawrixxux il-baġit tad-dawriet tas-server tiegħek. Il-mudell jista’ jwettaq 3 tiftixiet fuq il-web, isejjaħ il-funzjoni tiegħek, imbagħad iwettaq 3 tiftixiet addizzjonali wara li jirċievi r-riżultat.

Kuntest Multi-dawra bil-Ħażna

Għal flussi ta’ ħidma kumplessi li jestendu fuq interazzjonijiet multipli, għaqqad il-ħażna u l-katina (chaining):

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

Punti Ewlenin

  • Għaqqad għodod tas-server u funzjonijiet tal-klijent f’talba waħda għal flussi ta’ ħidma ibridi
  • L-għodod tas-server jeseġwixxu awtomatikament; il-funzjonijiet tal-klijent iwaqqfu l-ġenerazzjoni
  • max_turns jiġi rrisettjat wara kull vjaġġ ‘l hemm u lura tal-klijent
  • Mudelli komuni: tiftix + azzjoni, kalkolu + notifika, aggregazzjoni minn sorsi multipli
  • Uża store: true u previous_response_id għal flussi ta’ ħidma multi-dawra